Repository navigation
Locus Earth Beta 发布 (v1.0.0)
Locus Earth Beta 发布 (v1.0.0)
欢迎来到 Locus Earth —— 一个轻量、快速的开源 Web 3D 地球应用!
本项目灵感来自 Google Earth,但完全基于 Web 技术构建,支持在浏览器、PWA 及 Android 客户端中运行。
🛰️ 前端为主,外壳为辅:Android 版并非重新开发的 App,而是网页的 WebView 壳。网页代码独立更新,无需每次重新打包 APK。
✨ 核心功能
- 🌐 3D 地形与影像:内置 CesiumJS 引擎,支持全球 3D 建筑、地形及多底图切换(Sentinel-2、Blue Marble、夜晚灯光、腾讯地图等)。
- 🛠️ 丰富的工具:支持测距、测面积、标记、收藏、地址搜索(包含中国大陆街景、丹佛/华盛顿/悉尼等情景联动)。
- 🎨 现代交互:支持真实光照、建筑白模开关、指南针、暗色模式及移动端优化的触控体验。
- 📱 PWA 支持:支持在手机浏览器中“添加到主屏幕”,获得接近原生的体验。
📱 Android 版特别说明
- 无地址栏全屏体验:去除冗余界面,直接加载网页。
- 回退 Debug 签名:本次 Beta 包未配置正式签名,使用 debug 签名以保证可以直接安装。
- 网络要求:首次启动和加载地图瓦片需要网络连接。UI 层有缓存,断网时仍可加载基础界面。
- 已知问题(Beta 阶段):
- 当前使用的基础 WebView 壳在部分机型上适配较差,存在文件选择器无法调用等问题。可通过应用关于页面内的问题反馈或提issue反馈问题。
- 部分交互可能触发闪退(当前已回退至稳定版本,暂未包含最新 WebView 优化)。
- 将尽快在后续版本中排查并修复原生兼容性问题。
🚀 下载与安装
- 点击下方
Assets区域,下载locus-earth-version1.apk。 - 在手机上点击安装。如果遇到系统提示“应用未经检测”或“未知来源”,请勾选“已了解此应用未经检测”,点击继续安装。
- 安装完成后,直接打开即可体验 3D 地球!
💡 网页版与 PWA 体验:当前阶段渐进式web应用体验更好:
- Cloudflare Pages: https://locus-earth.pages.dev
- GitHub Pages: https://zhunemo.github.io/locus-earth/
🛠️ 构建与签名注意事项
- 如果你自己通过 GitHub Actions 或命令行构建,请确保使用你自己的签名文件(
keystore)。 - 重要:覆盖安装时,必须使用与之前版本相同的签名密钥,否则需要先卸载旧版。
- 相关构建脚本及说明请查阅仓库中的
androidapk/README.md。
🙏 技术栈与致谢
- 引擎:CesiumJS 1.118
- 地图数据:Cesium ion / OpenStreetMap / Natural Earth / 腾讯地图
- 前端架构:原生 ES Modules / PWA (Service Worker + Manifest)
- AI 辅助:DeepSeek / GitHub Copilot / Hunyuan
- 特别感谢:腾讯街景借助社区维护的第三方查看器QQ-map。
Made with ❤️ by ZhuNemo | 项目采用 MIT 许可证开源
版本:v1.0.0-Beta | 更新时间:2026-10-15