鸿蒙 PC:OHCalculiX(ohso_CalculiX)有限元求解与后处理移植全记录
放弃 OpenGL 之后:用 ArkUI 自建 3D 后处理,7 毫秒算出悬臂梁
一、写在前面
开源地址:https://atomgit.com/OpenHarmonyPCDeveloper/ohso_CalculiX
欢迎在PC社区平台申请新建项目:https://atomgit.com/OpenHarmonyPCDeveloper
本文导读
- 要解决的问题:CalculiX 的后处理靠
cgx——一个纯 OpenGL + GLUT 的桌面程序,鸿蒙上没有桌面 OpenGL 也没有 X11。- 你会读到的技术细节:预编译求解器
.so的接入方式、.frd结果文件的手写解析、用 ArkUI 自建 3D 视图(几何 + 变形 + 坐标轴 + 缩放标尺)、以及把 cgx 的 13 个命令映射成图形菜单的取舍。- 本文的实测数据:真机跑通悬臂梁算例:7 ms、生成 5 个结果文件,3D 视图从绿色未变形梁切换为变形梁,标尺 2e+00 → 3e+00;16 MB HAP。
- 适合谁读:做 CAE/图形类应用、想要"从点击到结果"完整闭环的开发者。
这篇文章记录的是把 CalculiX 这套有限元分析套件移植到鸿蒙 PC 上的过程。最终落地的应用叫 OHCalculiX,包名 com.gouxi.engineering。
这是本项目第一次做到「真的算出了结果」的一期:不是界面搭好、不是链路打通,而是真跑完一个算例、拿到结果文件、把变形后的模型渲染出来。
先给结论:
移植完成。在鸿蒙 PC 上完成了悬臂梁算例的完整流程:加载模型 → 运行求解(7 ms)→ 生成 5 个结果文件 → 3D 视图显示变形后的结构。
验证环境是真实设备:
| 项 | 值 |
|---|---|
| 设备型号 | HUAWEI MateBook Pro S(MOR-M1) |
| 系统版本 | HarmonyOS 7.0.0.111(SP15C00E101R9P2) |
| API 版本 | 26 |
| 设备形态 | 2in1 |
| 构建工具 | DevEco Studio 内置 hvigor 6.26.4 |
| SDK | HarmonyOS SDK 26.0.0.105 |
二、项目背景
CalculiX(http://www.dhondt.de/)是一套开源有限元分析套件,由 Guido Dhondt 开发,包含两个核心组件:
- CrunchiX:求解器(
ccx),C/Fortran,支持结构、热、流体、电磁等; - GraphiX(
cgx):交互式后处理器,负责网格显示、结果云图、变形动画。
它的技术骨架决定了移植难度:
| 组成部分 | 鸿蒙上能用吗 |
|---|---|
ccx 求解器(C/Fortran) | ✅ 交叉编译成 ARM64 可执行/共享库 |
cgx 后处理(OpenGL) | ❌ 桌面 OpenGL 不可用 |
.inp 输入文件 | ✅ 纯文本 |
.frd / .dat / .sta 结果 | ✅ 文本格式,可解析 |
| 交互式 3D 视图 | ⚠️ 得用鸿蒙的图形能力另做一套 |
所以移植的判断是:
保留 CrunchiX 数值内核,把 GraphiX 的 3D 后处理用 ArkUI 另做一套。
最终工程只有 2 个 ArkTS 文件、833 行——注意这个数字,比其他移植项目小得多。因为计算和后处理的大头都在原生层和预编译产物里,ArkTS 只负责编排和渲染。
三、总体变化概览
harmony_pc/
└── entry/src/main/
├── module.json5
├── cpp/
│ └── calculix_engine_runner.cpp 引擎编排(NAPI)
├── libs/arm64-v8a/
│ └── CalculiXSolver 预编译求解器(8.1 MB)
├── ets/ 2 个文件 / 833 行
│ ├── pages/Index.ets
│ └── entryability/EntryAbility.ets
└── resources/rawfile/
├── examples/ cantilever.inp / truss2.inp / startup.frd
└── licenses/ CalculiX / ARPACK / SPOOLES / LAPACK
技术栈映射:
| CalculiX 原方案 | OHCalculiX(鸿蒙) |
|---|---|
ccx 命令行 | 预编译 CalculiXSolver + 原生编排 |
cgx OpenGL 窗口 | ArkUI 3D 视图 + 图形菜单 |
.inp 手写输入 | 「打开输入」+ 内置示例 |
.frd 后处理文件 | 解析后直接渲染 |
cgx 命令(view/plot…) | 13 个图形菜单按钮 |
一个关键设计:后处理不再依赖 cgx 的可执行文件,而是直接读 .frd 里的节点位移,用 ArkUI 画出来。这样整个应用不需要 OpenGL,也不需要 X11。
四、原始项目直接跑鸿蒙会遇到什么问题
4.1 cgx 的 OpenGL 依赖是死路
CalculiX 的交互式后处理全靠 cgx,而 cgx 是纯 OpenGL + GLUT 的桌面程序。鸿蒙上没有桌面 OpenGL,也没有 X11。
仓库里其实尝试过兼容层(third_party 里能看到 glshim、GLU 的痕迹),但那条路在真机上很脆弱。最终采用的方案是:放弃 cgx,自己实现一个最小的 3D 视图。
4.2 求解器是预编译二进制
entry/src/main/libs/arm64-v8a/CalculiXSolver 是一个 8.1 MB 的预编译 ARM64 产物,直接用 CMake 的 add_library 包成 libCalculiXSolver.so:
set(CALCULIX_SOLVER_SOURCE "${CMAKE_CURRENT_SOURCE_DIR}/../libs/arm64-v8a/CalculiXSolver")
set(CALCULIX_SOLVER_OUTPUT "${CMAKE_LIBRARY_OUTPUT_DIRECTORY}/libCalculiXSolver.so")
好处是不需要在用户机器上重编 Fortran;代价是这个二进制必须入库,而且必须和当前 SDK 的 musl 版本匹配。
4.3 结果文件路径必须落在沙箱
求解器读 .inp、写 .frd/.dat/.sta,这些都是文件 I/O。鸿蒙上只能写应用沙箱:
/data/storage/el2/base/haps/entry/cache/calculix-libs/cantilever.frd
所以原生层要在启动前把示例输入和解算目录准备好。
五、鸿蒙适配核心路径
5.1 第一步:工作台三段式布局
界面分成三块,这个划分直接对应有限元的工作流:

| 区域 | 作用 |
|---|---|
| 顶部工具栏 | 当前模型 startup.frd、图形菜单、打开模型/输入/结果、隐藏任务栏 |
| 左侧任务栏 | 当前模型、计算输入、运行/停止、引擎状态、求解输出、操作提示 |
| 右侧 3D 视图 | 几何与结果渲染 + 坐标轴 + 缩放标尺 |
「任务 → 输入 → 求解 → 结果」这条链路在一屏里全部可见,不需要来回切页面。
5.2 第二步:引擎状态显性化
左侧面板有一项 引擎状态:内置计算引擎已就绪(绿色)。
这一点很重要:有限元应用最怕的是"点了运行,转圈,然后没反应"。把引擎状态单独占一行显示,用户一眼就知道能不能算。
启动时还有一个过渡提示:正在初始化 GraphiX 工作台,初始化完成后变 就绪。
5.3 第三步:3D 视图自己画
初始状态加载的是内置示例 startup.frd,渲染结果是一根绿色的悬臂梁:

视图区包含三个必要元素:
- 几何体(梁 + 网格线划分)
- 坐标轴指示器(左下角 XYZ)
- 缩放标尺(右下角
2e+00,随缩放变化)
底部还显示当前加载文件的绝对路径,方便排查"到底读的是哪个文件"。
5.4 第四步:一键运行示例求解
左侧最显眼的按钮是 运行示例求解。它背后做的事是:
- 把
cantilever.inp送进求解器 - 等求解完成
- 解析生成的结果文件
- 用结果更新 3D 视图
点下去 7 毫秒后就出了结果——这部分见第八章。
5.5 第五步:把 cgx 命令映射成图形菜单
cgx 原本是命令行交互的,移植时把它的命令集映射成了按钮:

一排 13 个命令:
查看 · 动画 · 帧 · 缩放 · 居中 · 查询 · 切割 · 绘图 · 方向 · 硬拷贝 · 帮助 · 切换命令行 · 退出
这些是 cgx 里最常用的操作。保留「切换命令行」这一项尤其有意思——给习惯打命令的老用户留了后路。
面板提示写得很清楚:
使用顶部图形菜单执行查看、绘图、方向和结果操作;图形区保留拖动旋转、滚轮缩放和键盘命令。
也就是说:鼠标交互(拖动旋转、滚轮缩放)和命令式操作同时保留,这是对 cgx 用户习惯的尊重。
六、问题困难解决
6.1 困难一:没有 cgx,后处理从零做
这是本期最大的工作量。cgx 能做的事很多:等值面、切片、矢量图、动画、多窗口。鸿蒙版只做了最小可用集:
| 能力 | 是否实现 |
|---|---|
| 几何/网格显示 | ✅ |
| 结果变形显示 | ✅ |
| 旋转/缩放/居中 | ✅ |
| 视图方向切换 | ✅(方向按钮) |
| 切割/切片 | ⚠️ 有入口,能力有限 |
| 等值面/云图 | ⚠️ 有入口,能力有限 |
| 动画回放 | ⚠️ 有入口,能力有限 |
诚实的说法是:几何与变形这条主线做通了,高级后处理还在补。
6.2 困难二:求解器是黑盒二进制
CalculiXSolver 是预编译产物,意味着:
- 不能改;
- 必须匹配 musl ABI;
- 出问题时只能看它的 stdout。
所以左侧那个「最近一次求解输出」面板是必需的——它把求解器的原始输出(包括 found elements of type 10: 0 这种调试信息)原样展示出来,让用户和开发者都能看到引擎到底说了什么。
6.3 困难三:结果文件格式要自己解析
.frd 是 CalculiX 的结果格式,纯文本但有固定块结构:
1C ...
2C <节点数>
-1 <节点号> <x> <y> <z>
...
3C <单元数>
-1 <单元号> <类型> <节点...>
...
要在 ArkTS 里解析它、算出变形后的节点坐标、再喂给 ArkUI 渲染。这一步没有现成库,只能自己写。
6.4 困难四:包名冲突
com.gouxi.engineering 这个 bundleName 在仓库里被两个项目同时使用——本期的 CalculiX,以及 ohos_netbeans。
后果是:同一台设备上只能装其中一个,后装的会覆盖先装的。
这是仓库层面需要修的问题(其中一个必须改包名并重新申请 profile)。本文的验证环境装的是 CalculiX。
七、构建与运行方式
7.1 环境
- DevEco Studio(内置 hvigor + SDK)
- HarmonyOS SDK API 26(本机 26.0.0.105)
- 不需要 Fortran 编译器(求解器已预编译入库)
7.2 构建
cd harmony_pc
ohpm install
hvigorw assembleHap --mode module -p product=default -p buildMode=debug
产物:
entry-default-unsigned.hap 16 MB
entry-default-signed.hap 16 MB
构建约 17 秒(原生部分要参与编译,比纯 ArkTS 工程慢)。
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
⚠️ 注意:如果先装了 ohos_netbeans(同一个 bundleName),装 CalculiX 会把前者覆盖掉。
八、适配成果
8.1 真实求解:7 毫秒,5 个结果文件
这是整篇文章最关键的一张图:

点「运行示例求解」后:
- 左下角弹出提示:求解完成(7 ms),生成 5 个结果文件
- 引擎状态保持 内置计算引擎已就绪
- 求解输出面板出现真实引擎日志:
0
found elements of type 10: 0
found elements of type 11: 0
found elements of type 12: 0
gtol calculated:8.000000e-05
- 结果文件列表:
cantilever.dat、cantilever.sta、cantilever.frd… - 当前模型从
startup.frd切换到cantilever.frd - 3D 视图从「绿色未变形梁」变成「细长变形梁」,缩放标尺从
2e+00变成3e+00
这一屏同时证明了三件事:求解器真的跑了、结果文件真的产出了、后处理真的把结果渲染出来了。
8.2 图形菜单与命令式操作
见 5.5。13 个 cgx 命令映射成按钮,同时保留命令行入口。
8.3 工程量
| 指标 | 数值 |
|---|---|
| ArkTS 源文件 | 2 个 |
| ArkTS 代码行数 | 833 行 |
| 原生编排 | calculix_engine_runner.cpp |
| 预编译求解器 | CalculiXSolver 8.1 MB |
| 内置示例 | cantilever.inp、truss2.inp、startup.frd |
| HAP 体积 | 16 MB |
| 实测求解耗时 | 7 ms(悬臂梁算例) |
8.4 前同类移植项目横向对比
| ClipNest | 澜析工程 | 沙箱控制台 | 晶析云 | 源库服务 | 云桥文件 | OHCalculiX | |
|---|---|---|---|---|---|---|---|
| 类型 | 本地工具 | 本地计算 | 云客户端 | 混合 | 服务端 | 网络 I/O | 本地计算 |
| ArkTS 行数 | 4782 | 3417 | 5862 | 3476 | 2297 | 5576 | 833 |
| HAP | 752 KB | 19 MB | 892 KB | 444 KB | 2.1 MB | 5.1 MB | 16 MB |
| 算出真实结果 | — | ❌ | — | — | ❌ | — | ✅ |
九、功能验证结果
9.1 已在真机验证
| 功能 | 结果 | 验证方式 |
|---|---|---|
| 构建与安装 | ✅ | 16 MB HAP,hdc install 成功 |
| 应用启动 | ✅ | 进程稳定,GraphiX 工作台初始化完成 |
| 三栏工作台 | ✅ | 工具栏 / 任务栏 / 3D 视图布局正确 |
| 引擎状态检测 | ✅ | 显示「内置计算引擎已就绪」 |
| 内置示例加载 | ✅ | startup.frd + cantilever.inp 正确加载 |
| 3D 几何渲染 | ✅ | 悬臂梁网格正确显示,含坐标轴与标尺 |
| 运行示例求解 | ✅ | 7 ms 完成,生成 5 个结果文件 |
| 求解输出回显 | ✅ | 引擎原始日志(element 统计、gtol)正确显示 |
| 结果文件产出 | ✅ | cantilever.dat/.sta/.frd 出现在结果列表 |
| 变形结果渲染 | ✅ | 视图切换为变形梁,标尺从 2e+00 变 3e+00 |
| 图形菜单 | ✅ | 13 个命令按钮全部渲染并可展开 |
| 操作提示 | ✅ | 「拖动旋转、滚轮缩放、键盘命令」提示正确 |
9.2 部分实现 / 未验证
| 功能 | 状态 | 说明 |
|---|---|---|
| 切割 / 切片 | ⚠️ | 有菜单入口,能力有限 |
| 等值面 / 云图 | ⚠️ | 有菜单入口,能力有限 |
| 动画回放 | ⚠️ | 有菜单入口,未验证帧播放 |
| 硬拷贝(导出图片) | ⚠️ | 有入口,未验证输出 |
| 打开外部模型/输入/结果 | ⚠️ | 按钮存在,未走系统选择器验证 |
| 多算例 | ⚠️ | 只验证了内置悬臂梁 |
9.3 已知限制
| 限制 | 说明 |
|---|---|
| 无完整 cgx 后处理 | 等值面/切片等高级功能仍在使用入口阶段 |
| 求解器为预编译产物 | 不可修改,需匹配 musl ABI |
| 包名与 NetBeans 冲突 | com.gouxi.engineering 被两个项目共用,只能装一个 |
| 调试 profile 绑 UDID | 换设备需重新自动签名 |
十、上架复盘:审核不通过怎么办
移植跑通只是第一关。上架审核看的是另一套东西:用户会不会把这款应用误认为上游官方版,或者误认为换皮抄袭。名称、图标、截图、描述、权限、实际行为,只要有一项对不上,就可能被驳回。
10.1 名称和图标:开源许可不等于品牌许可
这是最容易踩的坑。很多人觉得“这是开源软件,保留原名和原图标很正常”,但 MIT/Apache/GPL 给的是版权许可,不是商标许可。审核看到“应用名和上游一样、图标是上游 Logo 换色、截图里还有上游品牌”,就会按“冒用/抄袭”处理。典型的三连击是:应用名直接沿用上游、图标只把颜色换一下、截图里还带着上游 Logo——即使代码全部重写,也会被判定为冒用。
我们的处理原则:
- 应用名改成独立品牌,包名不带上游商标;
- 图标重画,不复用、不改色、不截取上游 Logo;
- 截图、启动图、关于页不出现上游 Logo,只保留文字致谢;
- 关于页写明“基于 CalculiX 移植,非官方发行”,并保留上游 LICENSE/NOTICE;
- 如果被质疑,提交《品牌与素材来源说明》:改名前后对照、图标设计稿、上游许可证、代码差异、真机录屏。
10.2 被判定“抄袭/雷同”时,交什么证据
只回“这是开源软件”通常没用。按这个顺序给材料:
- 上游仓库地址和 LICENSE 原文;
- 本仓库与上游的差异清单(UI 重写、平台层、构建脚本);
- 品牌变更记录(旧名→新名、旧图标→新图标);
- 功能差异说明(哪些是鸿蒙特有、哪些上游没有);
- 真机录屏,证明不是套壳。
如果确实沿用了上游 UI,先改再申诉;审核一般不看“开源所以可以一样”的解释。
10.3 这个项目的高频驳回点
- 名称含 CalculiX:容易被判“冒用”。保留 OHCalculiX 时必须在关于页写“非官方”,或直接换独立品牌;图标必须自绘。
- 包名冲突:文章 6.4 提到的包名冲突要在上架前改掉,包名不要含上游商标。
- 审核不会跑算例:提供一键示例
.inp,备注写清预期结果;关于页给出 GPL 源码地址。
10.4 驳回后的处理顺序
先分类,再动手。审核意见通常落在六类:名称/图标/品牌、隐私与权限、功能与描述不符、技术(签名/包名/架构/体积/崩溃)、内容合规、资质(软著/授权书/备案)。
- 一次只改一类,别在同一个版本里混改;
- 回复时逐条对应:版本号 + 审核意见 + 改了什么 + 怎么验证;
- 测试账号/令牌在复审前重置,写进审核备注;
- 截图必须来自当前版本真机,不能用设计稿;
- 换正式证书后重新打包,不要用调试签名送审;
- 被拒后先回一条“已收到,逐条说明”,再提新包,避免被判定骚扰;
- 上架材料提前备齐:软著/授权书、隐私政策公网 URL、测试账号、真机截图、开源许可证与 NOTICE。
回复可以按这个模板:
您好,针对第 X 条“……”:我们已在版本 A.B.C 中修改:1)……;2)……。验证路径:……。相关材料见附件/链接。
一句话:上架不是“把包传上去”,而是把“这不是官方版、也不是换皮”这件事,用名称、图标、截图、代码和材料同时证明一遍。
十一、结语
这次终于可以写「它真的算出来了」。
四点体会:
-
放弃 OpenGL 是对的。cgx 那套桌面图形栈在鸿蒙上注定走不通,硬上 glshim 只会得到一个又慢又容易崩的东西。用 ArkUI 自己画一个最小 3D 视图,反而把主线(几何 + 变形)稳稳做通了。
-
预编译求解器是把双刃剑。好处是用户不用装 Fortran 工具链,克隆即可构建;代价是 8.1 MB 二进制入库、ABI 必须匹配、出问题只能看 stdout。对有限元这种"编译一次、用一辈子"的内核来说,这个交易是划算的。
-
引擎状态必须显性化。有限元应用最怕用户不知道"现在到底能不能算"。把「引擎状态:已就绪」放在任务栏第二行,比任何加载动画都有用。
-
保留命令行入口是个好判断。老 cgx 用户有肌肉记忆,"切换命令行"这一项让他们不必重新学习一整套 GUI。
7 毫秒算出悬臂梁、生成 5 个结果文件、画出变形——这一屏才是真正的"移植成功"。其他移植项目有的是链路通了、有的还缺引擎,这次是完整的闭环。
一句话:放弃 OpenGL 的那一天,这个应用才真正开始"能算"。
相关链接
- 适配仓库:https://atomgit.com/OpenHarmonyPCDeveloper/ohso_CalculiX
- 上游项目 CalculiX:http://www.dhondt.de/
- OpenHarmony PC 开发者社区:https://atomgit.com/OpenHarmonyPCDeveloper
更多推荐


所有评论(0)