Repository navigation
Releases
Releases · ZhuNemo/locus-earth
Locus Earth Android客户端发布 (v1.2.0,正式签名版)
Locus Earth Beta 发布 (v1.1.0)
这一版本修复了打开APP闪退的问题并添加提示弹窗
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