当 HotSpot 的 JIT 在鸿蒙上彻底失效:一个 656 MB 的 JDK HNP 和一次 Zero VM 的替换

一、写在前面

开源地址:https://atomgit.com/OpenHarmonyPCDeveloper/ohos_netbeans

欢迎在PC社区平台申请新建项目:https://atomgit.com/OpenHarmonyPCDeveloper

本文导读

  • 要解决的问题:NetBeans 是一个纯 Java 的桌面 IDE,要让它跑起来,得先把一整套 JDK 搬进鸿蒙。而真正致命的不是"能不能打包",是 HotSpot 的 JIT 在鸿蒙上根本申请不到可执行内存——mmap 和 mprotect 直接返回 EINVAL,java -version 都跑不完。
  • 你会读到的技术细节:656 MB JDK HNP 的打包与加载、HotSpot 失败到 OpenJDK Zero VM(纯解释器,零代码生成) 的替换决策、fontmanager → XAWT 的符号依赖修复、以及 NetBeans 平台模块化启动链。
  • 本文的实测数据:HAP 628 MB、模块清单加载 323 项、OpenJDK 64-Bit Zero VM 21.0.12.1 在设备上跑通、完整 IDE 欢迎页与中文菜单栏可用。
  • 适合谁读:想把 JVM 系应用(IDE、Java 桌面工具)搬上鸿蒙、或者正在被"可执行内存"卡住的开发者。

这篇文章记录的是把 Apache NetBeans 移植到鸿蒙 PC 上的完整过程。最终落地的应用叫 工程工作台,包名 com.gouxi.engineering,产品版本 1.0.1225。

先给结论:

移植完成。在鸿蒙 PC 上跑起了完整的 NetBeans IDE:中文菜单栏、欢迎页、模块化启动链全部可用。而它跑起来的方式很特殊——不是 HotSpot,是 Zero VM。

验证环境是真实设备:

项值
设备型号HUAWEI MateBook Pro S(MOR-M1)
系统版本HarmonyOS 7.0.0.111(SP15C00E101R9P2)
API 版本26
设备形态2in1
内核HongMeng Kernel 1.13.0 · aarch64
构建工具DevEco Studio 内置 hvigor 6.26.4
SDKHarmonyOS SDK 26.0.0.105

二、项目背景

Apache NetBeans(https://github.com/apache/netbeans)是最主流的开源 Java IDE 之一,它的技术形态决定了移植难度:

  • 纯 Java:IDE 本体是 Java 写的大规模模块化应用,运行在 JVM 上;
  • NetBeans Platform:几百个模块(module)通过模块系统装配成 IDE;
  • Swing 界面:AWT/Swing + 少量 X11 依赖;
  • 构建工具链:Ant / Maven / Gradle;
  • 体积巨大:完整发行版 + 自带 JDK 是 GB 级。

对鸿蒙来说,这里有个很有迷惑性的判断:

表面上,Java 应用"跨平台",换个 JDK 就能跑。
实际上,JDK 本身就是最大的移植对象。

组成部分鸿蒙上能用吗
Java 字节码 / NetBeans 模块✅ 平台无关
JVM(HotSpot)❌ 可执行内存被限制,JIT 起不来
Swing / AWT⚠️ 需要 X11 兼容层
文件系统、输入法⚠️ 需要适配
JDK 本体(656 MB)✅ 打成 HNP 随包分发

真正卡住整个项目的是第二行——这不是"适配一下"能解决的,它意味着必须换一个 JVM 实现。


三、总体变化概览

harmonyos/
├── AppScope/app.json5                bundleName / 版本
├── entry/
│   ├── libs/arm64-v8a/
│   │   ├── netbeans-java.bin          Java 启动入口
│   │   ├── netbeans-bootstrap.jar     引导
│   │   ├── netbeans-input.jar         输入法桥接
│   │   ├── netbeans-ui-defaults.jar   UI 默认值
│   │   ├── netbeans-profiler-probe.jar
│   │   └── libprofilerinterface.so
│   └── src/main/ets/                  7 个文件
│       ├── pages/Index.ets
│       ├── RuntimeSession.ets         JVM 会话管理
│       ├── BrowserBridge.ets
│       ├── input/HarmonyInputMethod.ets  鸿蒙输入法桥
│       ├── input/SecurePaste.ets
│       ├── components/WorkbenchInformation.ets
│       └── entryability/EntryAbility.ets
├── hnp/arm64-v8a/netbeans-jdk.hnp     ~656 MB(NetBeans 29 + 完整 Java 模块)
└── java-zero/                         Zero VM 的构建配方、补丁与许可

技术栈映射:

NetBeans 原方案工程工作台(鸿蒙)
系统 JDK / 内置 JREnetbeans-jdk.hnp(656 MB)
HotSpot JVM(C1/C2 JIT)OpenJDK Zero VM(纯解释器)
桌面 SwingSwing + X11 兼容层
系统输入法HarmonyInputMethod 桥接
netbeans 启动脚本netbeans-java.bin + RuntimeSession

一个关键结构:仓库里有一个 java-zero/ 目录,专门放 Zero VM 的源码配方、哈希、补丁和许可证。这说明"换 JVM"不是临时 hack,而是一条被正式纳管的构建路径。


四、原始项目直接跑鸿蒙会遇到什么问题

4.1 第一个拦路虎:可执行内存

Java 的 JIT 编译器要把热点字节码编译成机器码,然后执行这段新生成的代码。这需要内存页具备"可执行"属性:

mmap(NULL, len, PROT_READ | PROT_WRITE | PROT_EXEC, ...)   // RWX
mprotect(addr, len, PROT_READ | PROT_EXEC)                 // RW → RX

在鸿蒙的应用沙箱里,这两类操作全部失败:

mmap / mprotect → EINVAL

而且这不是权限没申请。仓库文档里写得很清楚:

Device service logs confirm that the executable-memory permission is applied.
The bundled HotSpot nevertheless fails RX and RWX anonymous mappings and
RW-to-executable protection changes with EINVAL; its -version fails before
AWT initialization. A permission declaration alone has not solved this issue.

翻译过来就是:权限声明加上去了、系统日志也确认生效了,但 HotSpot 的 -version 依然在 AWT 初始化之前就挂掉。

4.2 第二个拦路虎:JVM 初始化根本走不完

这一步的后果比想象中严重:不是"界面卡住",而是 JVM 连 java -version 都跑不完。也就是说,任何"先让它跑起来再优化"的思路都不成立——第一公里就断了。

4.3 第三个拦路虎:AWT 的符号依赖

换掉 JVM 之后,Swing 又带来新问题:

libfontmanager.so: AWTFontMinByte1: symbol not found

libfontmanager.so 需要从 libawt_xawt.so 里拿 AWTLoadFont、AWTFont* 和 AccelGlyphCache_RemoveAllCellInfos 等符号,但在 OHOS 的加载路径下,这些符号不在 fontmanager 的有效作用域里。

更麻烦的是:预加载也不行。文档记录了这次失败的尝试:

Preloading libawt_xawt.so with RTLD_NOW | RTLD_GLOBAL succeeded on the device but did not resolve fontmanager’s missing-symbol error. An executable’s global loader scope is insufficient for this Java/native-library loading path on OHOS.

也就是:用 RTLD_GLOBAL 把 XAWT 提前加载进全局作用域,仍然解决不了。这说明鸿蒙的加载器作用域语义和 Linux 桌面有实质差异。

4.4 第四个问题:体积

656 MB 的 JDK,加上 IDE 本体,HAP 直接到了 628 MB。这个数字在应用市场里是非常显眼的——后面第九章会专门讲。


五、鸿蒙适配核心路径

5.1 第一步:把 JDK 打成 HNP

鸿蒙的 HNP(HarmonyOS Native Package)机制适合装这种"自带运行时"的大块头。仓库用 build-hnp.sh(13 KB 的脚本)把 JDK 打包成:

hnp/arm64-v8a/netbeans-jdk.hnp     ~656 MB

HAP 构建时把它作为资源带上,装机后由系统安装到 native 包目录:

harmonyos/build/hnp-runtime.jXrWXy/bin/jdk

注意那个带哈希的目录名 hnp-runtime.jXrWXy——每次重打包 HNP,这个前缀会变。文档里专门提醒了这一点:

The HNP must be repacked after updating this prefix.

5.2 第二步:换 JVM —— 从 HotSpot 到 Zero

这是整个移植最关键的一次决策。

Zero VM 是什么:OpenJDK 里的一个"零汇编"移植层——它用 C++ 实现字节码解释器,完全不做代码生成。原本的用途是在还没人写 JIT 移植的新架构上先让 JVM 跑起来。

对鸿蒙来说,这个"缺点"恰好变成了唯一的生路:

HotSpotZero
需要可执行内存✅ 必须❌ 不需要
代码生成JIT 编译热点方法纯解释执行
启动快慢
在鸿蒙上能否运行否(EINVAL)是

仓库的做法很克制:保留完整的 BellSoft Java 模块和 AWT 库,只把 libjvm.so 换成 Zero 版本。由打包脚本的 ZERO_JVM 开关控制:

ZERO_JVM="$PWD/harmonyos/java-zero/build/hotspot/support/modules_libs/java.base/zero/libjvm.so" \

不传这个变量就还是原生 HotSpot。可回退的设计,这点很重要。

5.3 第三步:修 fontmanager 的依赖

既然"预加载到全局作用域"这条路走不通,就只能直接修依赖关系:让 libfontmanager.so 直接链接(或直接依赖)libawt_xawt.so,而不是指望运行时的加载器作用域。

修完之后,设备上第一次出现:

SWING_READY:sun.awt.X11.XToolkit

这一行意味着 Swing 真的起来了。

5.4 第四步:把 X11 环境补齐

Swing on X11 还需要一批运行环境:

  • X11 客户端库(libX11、libXext、libXrender 等);
  • X11 的 locale 数据;
  • XLOCALEDIR 环境变量指向 locale 安装目录。

这些都在 RuntimeSession.ets 启动 JVM 之前设置好。

5.5 第五步:Java 入口与 JVM 会话

entry/libs/arm64-v8a/netbeans-java.bin 是 Java 启动入口,配合 netbeans-bootstrap.jar 完成 NetBeans 平台的自举。

ArkTS 侧的 RuntimeSession.ets 负责:

  • 定位 HNP 里的 JDK;
  • 组装 JAVA_HOME、XLOCALEDIR、classpath;
  • 启动 Java 进程;
  • 把 stdout/stderr 回传界面。

5.6 第六步:输入法与安全粘贴

这是容易被忽略但必须做的两块:

  • HarmonyInputMethod.ets —— 把鸿蒙输入法的候选/组合事件桥接给 Swing 的文本组件。没有它,中文输入在 IDE 里就是废的;
  • SecurePaste.ets —— 处理剪贴板的安全粘贴(鸿蒙对剪贴板读取有权限约束)。

六、问题困难解决

6.1 困难一:JIT 这条路彻底封死

这是本文最核心的一条经验,值得单独强调:

在鸿蒙上,"能不能申请可执行内存"决定了你能不能跑 JIT。

失败的不只是 mmap(PROT_EXEC),还有 mprotect(RW → RX)——这意味着即使你先写后执行(W^X 的安全做法)也不行。仓库的实测结论是:

The original HotSpot JVM cannot initialize executable memory: even with granted binary kernel permissions, mmap and mprotect return EINVAL.

加了权限也不行,这是平台层面的限制,不是配置问题。

6.2 困难二:Zero 的代价要讲清楚

换成 Zero 不是没有代价。文档里明确写了一条:

Zero does not support virtual threads.

Zero 不支持虚拟线程(JDK 21 的 Loom)。这意味着:

  • 任何依赖虚拟线程的 Java 代码在这里会退化或不可用;
  • 性能天生比 JIT 版差一个数量级(纯解释执行)。

对 IDE 这种交互式应用来说,这个代价是必须接受的——能跑 > 跑得快。但对计算密集型的 Java 程序,Zero 可能不是合适的选择。

6.3 困难三:加载器作用域与桌面 Linux 不同

RTLD_GLOBAL 预加载失败这件事,暴露的是鸿蒙动态加载器的行为差异:

手段Linux 桌面OHOS
LD_PRELOAD✅ 生效❌ 被忽略(在另一个项目里实测过)
dlopen(RTLD_GLOBAL) 提升符号可见性✅ 通常有效❌ 对 Java 的 native 加载路径无效
直接修依赖(DT_NEEDED)✅✅

结论很实用:在鸿蒙上,别指望"运行时把符号塞进去",要老老实实改链接依赖。

6.4 困难四:628 MB 的安装包

完整 JDK + NetBeans 打出来的 HAP 是 628 MB。这在应用市场上属于"巨无霸"级别。

从工程角度,后续有几个可优化方向:

  • HNP 按功能拆包(只带必要模块);
  • 首次启动时按需下载语言包/模块;
  • 用 CDS(Class Data Sharing)减少启动时的类加载开销——仓库里已经做了这件事(“Zero JVM with optimized libffi and CDS”)。

6.5 困难五:启动链路长,每一步都可能断

NetBeans 平台启动要处理几百个模块的依赖解析。设备上实测的启动进度是这样:

在这里插入图片描述

正在加载工作区...
正在读取模块清单                    40%
当前模块: org.netbeans.modules.parsing.indexing
已处理 323 个启动项
正在初始化工作区窗口                 84%
当前模块: bcprov
已处理 323 个启动项

323 个启动项——在纯解释执行下,这个过程的耗时是可观的。所以界面必须给出真实的进度与当前模块名,而不是一个转圈动画。


七、构建与运行方式

7.1 环境

  • DevEco Studio(内置 hvigor + SDK)
  • HarmonyOS SDK API 26(本机 26.0.0.105)
  • 如需自行构建 HNP:OHOS native SDK + Zero VM 源码(java-zero/ 内有配方)

7.2 构建

cd harmonyos
ohpm install
hvigorw assembleHap --mode module -p product=default -p buildMode=debug

产物:

entry-default-unsigned.hap   628 MB
entry-default-signed.hap     629 MB

体积的大头是 656 MB 的 JDK HNP(压缩后约 626 MB)。

7.3 签名与安装

sh scripts/sign_hap.sh
hdc install -r entry/build/default/outputs/default/entry-default-signed.hap
hdc shell aa start -b com.gouxi.engineering -a EntryAbility

⚠️ 包名冲突提示:com.gouxi.engineering 这个 bundleName 同时被本项目和 ohso_CalculiX(OHCalculiX)使用。同一台设备上只能装其中一个,后装的会覆盖先装的。这是仓库层面需要修的问题——其中一个项目必须改包名并重新申请 profile。


八、适配成果

8.1 完整 IDE 启动成功

在这里插入图片描述

窗口标题「工程工作台」,中文菜单栏一应俱全:

文件(F)  视图(V)  调试(D)  性能分析(P)  团队开发(M)  工具(T)  窗口(W)  帮助(H)

欢迎页给出了 NetBeans 的四个标准入口与快捷键:

操作快捷键
新建项目Ctrl+Shift+N
打开项目Ctrl+Shift+O
新建文件Ctrl+N
显示工作台Alt+Shift+W

这不是"能启动的壳子"——它是 NetBeans 平台完整装配后的工作台。

8.2 中文菜单系统可用

在这里插入图片描述

「文件」菜单完整展开,13 个菜单项全部中文化:新建项目、新建文件、打开项目、打开近期的项目、关闭项目、关闭其他项目、关闭所有项目、打开文件、打开最近文件、项目组、项目属性、导入项目/导出项目、退出。

菜单项的快捷键、子菜单箭头、分组分隔线都正常渲染——说明 Swing 的菜单系统在 X11 兼容层上是可用的。

8.3 JVM 身份确认:Zero VM

在这里插入图片描述

「关于」对话框给出了最关键的一组信息:

产品版本: 工程工作台 - 鸿蒙 PC 版 1.0.1225
Java:     21.0.12.1; OpenJDK 64-Bit Zero VM 21.0.12-internal-...
运行环境: OpenJDK Runtime Environment 21.0.12.1+1-LTS
系统:     HarmonyOS version HongMeng Kernel 1.13.0 running on aarch64; UTF-8; zh_CN

两处值得注意:

  1. 64-Bit Zero VM —— 明确标注了不是 HotSpot,这是 4.1 那个限制的直接产物;
  2. running on aarch64 —— JVM 自己报告的宿主架构,和鸿蒙 PC 一致。

这一屏基本可以作为"JDK 在鸿蒙上真的跑起来了"的最终证据。

8.4 工程量

指标数值
ArkTS 源文件7 个
Java 侧产物5 个 jar + 1 个入口二进制 + 1 个 .so
JDK HNP~656 MB
启动模块数323 个
HAP 体积628 MB
JVMOpenJDK 21.0.12.1 · Zero VM
产品版本1.0.1225

九、功能验证结果

9.1 已在真机验证

功能结果验证方式
构建与安装✅628 MB HAP,hdc install 成功
HNP 安装✅JDK 落到 hnp-runtime.*/bin/jdk
JVM 启动✅JAVA_VERSION_OK(Zero VM)
模块清单加载✅323 个启动项,进度可达 100%
IDE 工作区✅「工程工作台」主窗口正常显示
中文菜单栏✅8 个顶级菜单,13 个文件菜单项全部中文
欢迎页与快捷键✅4 个入口与 Ctrl+Shift+N 等快捷键正确
Swing 渲染✅窗口、菜单、图标均正常绘制
版本信息✅「关于」显示 Zero VM + aarch64 + 内核版本
输入法桥接✅输入法模块已集成(代码层)

9.2 仓库文档记录、本次未复验

仓库的 RELEASE_READINESS.md / UI_CHECKLIST.md 记录了一批已验证项,本次只复验了主链路:

项目仓库记录状态
Swing 探针✅ SWING_READY:sun.awt.X11.XToolkit
真实按钮点击✅ SWING_POINTER_OK
物理键盘输入✅ 探针编辑器出现 abc
Ant 工作流✅ 已通过
Maven 工作流✅ 已通过

9.3 已知限制

限制说明
无 JITZero VM 纯解释执行,性能低于桌面版
不支持虚拟线程Zero 不实现 Loom
包体 628 MB应用市场里属超大包,需拆分或按需下载
启动较慢323 个模块 + 解释执行
完整编辑/构建/运行链路仓库标注为"仍需单独验证"
包名与 CalculiX 冲突同一 com.gouxi.engineering,只能装一个
HNP 前缀随重打包变化更新 HNP 后需重新打包并同步前缀

十、上架复盘:审核不通过怎么办

移植跑通只是第一关。上架审核看的是另一套东西:用户会不会把这款应用误认为上游官方版,或者误认为换皮抄袭。名称、图标、截图、描述、权限、实际行为,只要有一项对不上,就可能被驳回。

10.1 名称和图标:开源许可不等于品牌许可

这是最容易踩的坑。很多人觉得“这是开源软件,保留原名和原图标很正常”,但 MIT/Apache/GPL 给的是版权许可,不是商标许可。审核看到“应用名和上游一样、图标是上游 Logo 换色、截图里还有上游品牌”,就会按“冒用/抄袭”处理。典型的三连击是:应用名直接沿用上游、图标只把颜色换一下、截图里还带着上游 Logo——即使代码全部重写,也会被判定为冒用。

我们的处理原则:

  • 应用名改成独立品牌,包名不带上游商标;
  • 图标重画,不复用、不改色、不截取上游 Logo;
  • 截图、启动图、关于页不出现上游 Logo,只保留文字致谢;
  • 关于页写明“基于 Apache NetBeans 移植,非官方发行”,并保留上游 LICENSE/NOTICE;
  • 如果被质疑,提交《品牌与素材来源说明》:改名前后对照、图标设计稿、上游许可证、代码差异、真机录屏。

10.2 被判定“抄袭/雷同”时,交什么证据

只回“这是开源软件”通常没用。按这个顺序给材料:

  1. 上游仓库地址和 LICENSE 原文;
  2. 本仓库与上游的差异清单(UI 重写、平台层、构建脚本);
  3. 品牌变更记录(旧名→新名、旧图标→新图标);
  4. 功能差异说明(哪些是鸿蒙特有、哪些上游没有);
  5. 真机录屏,证明不是套壳。

如果确实沿用了上游 UI,先改再申诉;审核一般不看“开源所以可以一样”的解释。

10.3 这个项目的高频驳回点

  • 638 MB 与启动慢:审核机可能等不到 IDE 起来。首次启动给明确进度/等待提示,备注写清“首次解压,约 X 秒”。
  • Apache 商标:不能叫 NetBeans,也不能用 Apache 羽毛 Logo;“工程工作台”+ 自绘图标,关于页注明非官方。
  • 被判“套壳”:准备真机录屏,展示 X11 桥、输入法和文件对话框是自研适配层,不是简单换皮。

10.4 驳回后的处理顺序

先分类,再动手。审核意见通常落在六类:名称/图标/品牌、隐私与权限、功能与描述不符、技术(签名/包名/架构/体积/崩溃)、内容合规、资质(软著/授权书/备案)。

  • 一次只改一类,别在同一个版本里混改;
  • 回复时逐条对应:版本号 + 审核意见 + 改了什么 + 怎么验证;
  • 测试账号/令牌在复审前重置,写进审核备注;
  • 截图必须来自当前版本真机,不能用设计稿;
  • 换正式证书后重新打包,不要用调试签名送审;
  • 被拒后先回一条“已收到,逐条说明”,再提新包,避免被判定骚扰;
  • 上架材料提前备齐:软著/授权书、隐私政策公网 URL、测试账号、真机截图、开源许可证与 NOTICE。

回复可以按这个模板:

您好,针对第 X 条“……”:我们已在版本 A.B.C 中修改:1)……;2)……。验证路径:……。相关材料见附件/链接。

一句话:上架不是“把包传上去”,而是把“这不是官方版、也不是换皮”这件事,用名称、图标、截图、代码和材料同时证明一遍。

十一、结语

这个项目的技术含量最高,也最能说明鸿蒙与桌面 Linux 的差异。

四点体会:

  1. "Java 跨平台"这句话在鸿蒙上要打折扣。字节码确实跨平台,但 JVM 不是。HotSpot 依赖的可执行内存,在鸿蒙应用沙箱里被 EINVAL 挡死——加权限也没用。这是平台级的边界。

  2. Zero VM 是这次移植的"生路"。它本来是给"还没有 JIT 移植的新架构"用的过渡方案,在鸿蒙上反而成了唯一可行解。不需要代码生成这个特性,恰好绕开了可执行内存限制。代价是性能和不支持虚拟线程。

  3. 加载器作用域的差异比想象中大。LD_PRELOAD(另一个项目实测被忽略)、dlopen(RTLD_GLOBAL)(对 Java native 加载无效)都靠不住,唯一可靠的是改链接依赖。这条经验对所有需要加载原生库的鸿蒙应用都适用。

  4. 628 MB 不是终点,是起点。HNP 拆包、CDS、按需下载——这些优化都会落在后续版本里。

从"java -version 都跑不完"到"完整的 NetBeans 中文 IDE 工作台",这次移植跨过的不是工程量,而是一次平台能力的重新认识。


一句话:先让 JVM 活着,再谈 IDE 好不好用——鸿蒙上的 Java 移植,第一课是可执行内存。

相关链接

Logo

开源鸿蒙跨平台开发社区汇聚开发者与厂商,共建“一次开发,多端部署”的开源生态,致力于降低跨端开发门槛,推动万物智联创新。

更多推荐