鸿蒙 PC:工程工作台(ohos_netbeans)NetBeans IDE 移植全记录
当 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 |
| SDK | HarmonyOS 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 / 内置 JRE | netbeans-jdk.hnp(656 MB) |
| HotSpot JVM(C1/C2 JIT) | OpenJDK Zero VM(纯解释器) |
| 桌面 Swing | Swing + 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 withEINVAL; its-versionfails 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.sowithRTLD_NOW | RTLD_GLOBALsucceeded 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 跑起来。
对鸿蒙来说,这个"缺点"恰好变成了唯一的生路:
| HotSpot | Zero | |
|---|---|---|
| 需要可执行内存 | ✅ 必须 | ❌ 不需要 |
| 代码生成 | 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,
mmapandmprotectreturnEINVAL.
加了权限也不行,这是平台层面的限制,不是配置问题。
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
两处值得注意:
64-Bit Zero VM—— 明确标注了不是 HotSpot,这是 4.1 那个限制的直接产物;running on aarch64—— JVM 自己报告的宿主架构,和鸿蒙 PC 一致。
这一屏基本可以作为"JDK 在鸿蒙上真的跑起来了"的最终证据。
8.4 工程量
| 指标 | 数值 |
|---|---|
| ArkTS 源文件 | 7 个 |
| Java 侧产物 | 5 个 jar + 1 个入口二进制 + 1 个 .so |
| JDK HNP | ~656 MB |
| 启动模块数 | 323 个 |
| HAP 体积 | 628 MB |
| JVM | OpenJDK 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 已知限制
| 限制 | 说明 |
|---|---|
| 无 JIT | Zero 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 被判定“抄袭/雷同”时,交什么证据
只回“这是开源软件”通常没用。按这个顺序给材料:
- 上游仓库地址和 LICENSE 原文;
- 本仓库与上游的差异清单(UI 重写、平台层、构建脚本);
- 品牌变更记录(旧名→新名、旧图标→新图标);
- 功能差异说明(哪些是鸿蒙特有、哪些上游没有);
- 真机录屏,证明不是套壳。
如果确实沿用了上游 UI,先改再申诉;审核一般不看“开源所以可以一样”的解释。
10.3 这个项目的高频驳回点
- 638 MB 与启动慢:审核机可能等不到 IDE 起来。首次启动给明确进度/等待提示,备注写清“首次解压,约 X 秒”。
- Apache 商标:不能叫 NetBeans,也不能用 Apache 羽毛 Logo;“工程工作台”+ 自绘图标,关于页注明非官方。
- 被判“套壳”:准备真机录屏,展示 X11 桥、输入法和文件对话框是自研适配层,不是简单换皮。
10.4 驳回后的处理顺序
先分类,再动手。审核意见通常落在六类:名称/图标/品牌、隐私与权限、功能与描述不符、技术(签名/包名/架构/体积/崩溃)、内容合规、资质(软著/授权书/备案)。
- 一次只改一类,别在同一个版本里混改;
- 回复时逐条对应:版本号 + 审核意见 + 改了什么 + 怎么验证;
- 测试账号/令牌在复审前重置,写进审核备注;
- 截图必须来自当前版本真机,不能用设计稿;
- 换正式证书后重新打包,不要用调试签名送审;
- 被拒后先回一条“已收到,逐条说明”,再提新包,避免被判定骚扰;
- 上架材料提前备齐:软著/授权书、隐私政策公网 URL、测试账号、真机截图、开源许可证与 NOTICE。
回复可以按这个模板:
您好,针对第 X 条“……”:我们已在版本 A.B.C 中修改:1)……;2)……。验证路径:……。相关材料见附件/链接。
一句话:上架不是“把包传上去”,而是把“这不是官方版、也不是换皮”这件事,用名称、图标、截图、代码和材料同时证明一遍。
十一、结语
这个项目的技术含量最高,也最能说明鸿蒙与桌面 Linux 的差异。
四点体会:
-
"Java 跨平台"这句话在鸿蒙上要打折扣。字节码确实跨平台,但 JVM 不是。HotSpot 依赖的可执行内存,在鸿蒙应用沙箱里被
EINVAL挡死——加权限也没用。这是平台级的边界。 -
Zero VM 是这次移植的"生路"。它本来是给"还没有 JIT 移植的新架构"用的过渡方案,在鸿蒙上反而成了唯一可行解。不需要代码生成这个特性,恰好绕开了可执行内存限制。代价是性能和不支持虚拟线程。
-
加载器作用域的差异比想象中大。
LD_PRELOAD(另一个项目实测被忽略)、dlopen(RTLD_GLOBAL)(对 Java native 加载无效)都靠不住,唯一可靠的是改链接依赖。这条经验对所有需要加载原生库的鸿蒙应用都适用。 -
628 MB 不是终点,是起点。HNP 拆包、CDS、按需下载——这些优化都会落在后续版本里。
从"java -version 都跑不完"到"完整的 NetBeans 中文 IDE 工作台",这次移植跨过的不是工程量,而是一次平台能力的重新认识。
一句话:先让 JVM 活着,再谈 IDE 好不好用——鸿蒙上的 Java 移植,第一课是可执行内存。
相关链接
- 适配仓库:https://atomgit.com/OpenHarmonyPCDeveloper/ohos_netbeans
- 上游项目 Apache NetBeans:https://github.com/apache/netbeans
- OpenJDK Zero:https://openjdk.org/groups/hotspot/docs/Runtime_Overview.html
- OpenHarmony PC 开发者社区:https://atomgit.com/OpenHarmonyPCDeveloper
更多推荐


所有评论(0)