上帝视角看地球 -- gods-eye-view 移植到 OpenHarmony 实录
看惯了代码,今天做点有趣的东西:一台 1.8 公斤的开发板,一个跑在浏览器里的实时全球态势应用,
中间隔着 WebGL、一个 Node 后端,以及一整圈不通的数据源,这篇记录我们怎么把它变成桌面上一个点开即用的图标。
一、先看东西
完整地球——真实卫星影像、昼夜线、星空,满屏是带呼号的实时航班:

锁定目标——点一下某架飞机,它会把机型、航司、高度速度、起降机场全报给你,还拖出一条轨迹:

数据源配置——十个服务商密钥的位置,标「浏览器端」的三个由前端直接用,剩下由本机服务端用:

这不再是电脑浏览器里开着的一个网页标签,而是 OpenHarmony 桌面上一个应用:全屏、无边框、开机自启、点开就是地球。
二、它本来是什么
gods-eye-view 是 Bilawal Sidhu 开源的一套实时全球态势感知项目(MIT),在社区里颇受关注。技术上它其实很朴素:
- 前端:Vue 3 + CesiumJS 1.124,一个能拉到城市级的 3D 地球
- 后端:Node 24 + Vite 中间件,50 个 "/api/*" 端点把散落在各处的公开数据源聚起来(航班、船舶、卫星、地震、火点、摄像头…)
- 数据:全部是公开或免费额度的第三方源
也就是说,它天然是个「网页 + 本地数据网关」的两段式结构。这个判断在后面决定了整条移植路线的走向。
三、三个拦路虎
移植前我们列了三个必须先回答的问题。事后看,三个答案都不是最初的直觉。
拦路虎 1:ArkWeb 能不能跑 Cesium?
CesiumJS 从 1.104 起彻底放弃 WebGL1,1.124 必须是 WebGL2。ArkWeb 是 Chromium 内核,理论上没问题——但"理论"在这类事情上从来不值钱。
实测(RK3588 / OpenHarmony 6.1 / API 23,内核 Chrome/132.0.6834.89、ArkWeb/6.1.0.32):
· WebGL2 上下文:✅ WebGL 2.0 (OpenGL ES 3.0 Chromium)
· UNMASKED_RENDERER:Mali-G610(ARM 硬件栈,不是 SwiftShader 软件渲染)
· 原始 GL 压力(20.48 万三角面全屏着色):60 fps(vsync 满帧)
· Cesium 纯球体:51.5 – 53.7 fps
· Cesium + 3000 个点位实体 + 真实影像:43.5 fps,JS 堆 58 MB 稳定
· 首帧 / Viewer 构造:576 ms / 93 ms
一个反直觉的发现:扩展数量只有 12 个,按 WebGL1 时代的清单去对,会得出"能力严重缺失"的错误结论。实际上 OES_vertex_array_object、WEBGL_depth_texture、EXT_sRGB 这些在 WebGL2 里已经升为核心特性,查不到扩展对象是正常的。真正要看的只有几个:
EXT_color_buffer_float ✅ 浮点渲染目标(HDR/后处理)
EXT_texture_filter_anisotropic ✅ 斜视角地形纹理
WEBGL_compressed_texture_etc ✅ Mali 原生压缩
WEBGL_multi_draw ✅ 批量绘制(大量实体关键)
KHR_parallel_shader_compile ❌ 纯性能优化,Cesium 优雅降级
结论:能跑,而且跑得动。
拦路虎 2:后端怎么上去?
最直接的判断是"后端搬不上去,得外置一台服务器"。但一次意外的发现改变了结论:这块板子上本来就有一个可用的 Node(系统里另一个应用带的自包含运行时),v24.22.2,musl/arm64,恰好满足项目 engines: >=24.14 <25 的要求。
实测可用模块:http https net tls crypto zlib fs dns、worker_threads、node:sqlite,全局 WebSocket 和 WebAssembly 都在。
于是路线变成:把后端也搬到板内,整个应用变成完全自包含,不依赖任何外部服务器。后来我们把运行时也换成了自己带的一份(不再借用系统里那个应用的私有目录),才算真正干净。
拦路虎 3:数据源全在外面
第三个问题最朴素:这些数据源在国内网络里到底能不能通?
拿板子自己 fetch,14 个源逐个试,每个 9 秒超时:
· 卫星影像:Esri World Imagery(项目默认) — ❌ 9s 超时
· 栅格路网:OSM 官方瓦片(默认回退) — ❌ 超时
· 地名搜索:Nominatim — ❌ 超时
· 街景:Mapillary — ❌ 超时
· 卫星影像:NASA GIBS — ✅ 200 / 954 ms
· 高分辨率影像:EOX Sentinel-2 cloudless — ✅ 200 / 773 ms
· 矢量路网:OpenFreeMap — ✅ 200 / 1.4 s
· 栅格路网:OSM 德国镜像 — ✅ 200 / 806 ms
· 地形高程:AWS Terrarium — ✅ 200 / 3.7 s
· 地名搜索:Photon — ✅ 200 / 1.0 s
· 街景:Panoramax — ✅ 200 / 719 ms
结论:默认源不通,但开源替代基本都能通。
顺带记两个坑:NASA GIBS 的 GoogleMapsCompatible_* 瓦片集属于 EPSG:3857,URI 必须写 wmts/epsg3857/...,写成 epsg4326 会直接 400;OpenFreeMap 的矢量瓦片路径必须带数据集版本号,否则返回 0 字节。
四、架构:为什么 HAP 不负责拉起 node
确定"前后端都在板内"之后,下一个问题是要不要把它们塞进一个 HAP 里。直觉是"HAP 启动时 fork 一个 node 子进程",但这条路在 OpenHarmony 上既不必要也不划算。
最终结构是三段式:
┌──────────────────────┐ ┌───────────────────────────┐
│ 设备侧常驻进程 │ │ 应用壳(HAP) │
│ Node + 数据网关 │◀─HTTP─▶│ ArkWeb Web 组件 │
│ 127.0.0.1:5180 │ │ src = http://127.0.0.1:5180/ │
└──────────────────────┘ └───────────────────────────┘
▲ 前端静态产物 dist/ 由同一服务托管
▲ init 开机自启(/system/etc/init/*.cfg)
- node 是设备上的普通进程,由 init 的 .cfg 作业在开机时拉起(post-fs-data → start gev-web)
- HAP 只做三件事:开窗口、装 ArkWeb、指向 127.0.0.1:5180
- 后端只监听 loopback,不带鉴权也没有暴露面
这个设计的直接好处:应用壳只有 167 KB,跟上游版本完全解耦——上游怎么升级,壳都不用重编。开机自启验证也很干脆:重启后 uptime 0 min,node prod-api.mjs 的 ppid = 1(init 直接拉起),端口在监听,应用点开即用。
外壳本身只改了四处:包名与应用名、一个 104 行的 ArkWeb 页面(含加载态/未连接态/重试/console 转发)、全屏沉浸式(setWindowLayoutFullScreen + setWindowSystemBarEnable([]))、以及一个自绘图标。
五、五个坑,和一次自我纠错
移植过程里真正花时间的不是"能不能",而是这些细节。
1. npm install 和 npm ci 不是一个东西
第一次装了依赖,vite dev 直接起不来:
Missing "./lib/zip-no-worker.js" specifier in "@zip.js/zip.js" package
查下去发现版本全飘了——npm install 会按 semver 重新解析,而锁文件里钉的是另一套:
· cesium:1.138.0 — 1.129.0
· @cesium/engine:22.3.0 — 17.0.0
· @zip.js/zip.js:2.8.18 — 2.24.0
换成 npm ci 后一次通过。这条值得写进任何 CI 规范。
2. arm64 原生件:版本必须精确对齐
板端跑后端需要两个原生件,都不是"装上就行":
- esbuild:ESBUILD_BINARY_PATH 指过去的二进制,版本必须和 node_modules/esbuild 完全一致,差一个小版本就报 Host version "0.25.12" does not match binary version "0.25.10"。
- @rollup/rollup-linux-arm64-musl:npm 会以 Valid libc: musl / Actual libc: glibc 直接拒绝安装,得从 registry 手工拉 tarball 解包放进去。
3. 不能拿假 API 冒充后端
把前端 dist 单独托管时,应用卡在启动屏不动——它依赖 50 个 /api/* 端点。我第一反应是"先给个空响应糊过去",于是未知端点统一返回 204/[],结果是:
[Data:Flights] Fetch error: Malformed OpenSky response
[Data:Military] Fetch error: Malformed adsb.lol response
[Data:ais-live-vessels] Malformed vessel response
界面顶部持续弹「加载失败」。原因很直白:每个 provider 期望的字段结构都不同,空数组 ≠ 没有数据。
正确解法是 Vite 的 middlewareMode——前端托管静态产物,/api/* 仍然走上游自己的 provider:
const vite = await createViteServer({
root, server: { middlewareMode: true }, appType: 'custom',
});
// /api/* → vite.middlewares;其余 → 自己托管 dist/
4. 一次误判:SharedArrayBuffer 到底有没有
我第一次用自检页探测,typeof SharedArrayBuffer === 'undefined',于是写进了结论"本平台不支持 SAB"。后来发现是测试条件不成立:页面跑在 http://<局域网IP>,既不是安全上下文,也没有跨源隔离头,Chromium 按设计就不给这个对象。
改成回环地址 + 带 COOP/COEP 的响应头,再测:
{"crossOriginIsolated":true,"hasSAB":"function","atomics":12345,"workerSaw":1}
不仅对象有了,Atomics 正常,Worker 通过同一块共享内存自增后主线程读到了 1——真·多线程共享内存可用。
这个坑的教训不是"SAB 很重要",而是:判据本身要先被验证。类似的还有"扩展数只有 12 个"——按 WebGL1 清单去对,会误判成能力严重不足。
5. 反复弹「数据源过期」,是 bug 吗
运行一段时间后界面会反复提示数据源过期。查代码后确认这是上游的设计,不是移植缺陷:它诚实地标注数据新鲜度——航班数据的观测时间超过 120 秒就标 STALE,船舶在上游"刷新中"也会标。
真正的原因在服务端日志里:
· /api/terrain/heights:821 — 200×397、429×225、502×199 — 6.5 s
· /api/flights:46 — 200×46 — 24.7 s
· /api/vessels:42 — 503×42(100%) — 25 ms
地形源被限流、船舶没有密钥、航班偶发二十多秒的慢响应——数据不够新鲜,它就如实告诉你。想少看到提示,该做的是关掉必然失败的图层、给慢接口加超时与缓存,而不是把阈值调大。
六、把首屏请求砍掉一个数量级
最后一处优化在交付形态上。原来的形态是 vite dev,首屏要逐模块转译 1107 个模块;改成"预构建静态产物 + 同一服务提供真实 API"后:
· 首屏静态请求:1107 个模块 — 106 个文件
· 首屏 API 调用:— — 17 次
· 静态资源耗时:模块级 1.2 s 量级 — 多为 2–74 ms
· 实时航班:有 — 有(5408 架)
· 渲染:正常 — 正常,无「加载失败」
整机自包含布局是 /data/gev:自带 Node 运行时(127 MB)、项目与依赖(624 MB)、启动脚本与 init 自启配置。运行时的脱依赖验证很简单:
LD_LIBRARY_PATH=/data/gev/rt/lib /data/gev/rt/bin/node --version
# v24.22.2
七、上游仓库(GitCode 上有镜像,国内更快)
# 原仓库地址: https://gitcode.com/GitHub_Trending/go/gods-eye-view 这里用本地仓下载速度更快
git clone --depth 1 https://gitcode.com/fulszcd/gods-eye-view.git
cd gods-eye-view && PUPPETEER_SKIP_DOWNLOAD=1 npm ci --ignore-engines
# 换上可达的底图(否则默认源多半超时)
git apply ../gods-eye-view-ohos/app/patches/0001-imagery-reachable-sources.patch
npm run dev # 终端会打印本地地址
⚠️ 两点提醒:默认底图 EOX Sentinel-2 cloudless 是 CC BY-NC-SA(非商用);Google Maps、Cesium ion、Mapillary 等需要自备密钥,计费与配额由各服务商决定。
八、还没做到的
诚实清单:
· 语音控制:ArkWeb 无 getUserMedia,麦克风拿不到
· 地形起伏:keyless 地形源被限流(429/502),自动退化为平滑椭球
· 路网同步:依赖的 OSM 数据源不可达,界面停在「同步路网 0%」
· 实景 3D:需要 Google Maps / Cesium ion 密钥,且网络不通
· 船舶图层:AIS 需要密钥
下一步最想做的是瓦片本地化:把底图打成 PMTiles 跟应用一起分发,彻底摆脱外部依赖与速率限制——那样"数据源过期"这类提示也会少很多。
更多推荐


所有评论(0)