放弃 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
SDKHarmonyOS 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 第四步:一键运行示例求解

左侧最显眼的按钮是 运行示例求解。它背后做的事是:

  1. 把 cantilever.inp 送进求解器
  2. 等求解完成
  3. 解析生成的结果文件
  4. 用结果更新 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 行数478234175862347622975576833
HAP752 KB19 MB892 KB444 KB2.1 MB5.1 MB16 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 被判定“抄袭/雷同”时,交什么证据

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

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

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

10.3 这个项目的高频驳回点

  • 名称含 CalculiX:容易被判“冒用”。保留 OHCalculiX 时必须在关于页写“非官方”,或直接换独立品牌;图标必须自绘。
  • 包名冲突:文章 6.4 提到的包名冲突要在上架前改掉,包名不要含上游商标。
  • 审核不会跑算例:提供一键示例 .inp,备注写清预期结果;关于页给出 GPL 源码地址。

10.4 驳回后的处理顺序

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

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

回复可以按这个模板:

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

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

十一、结语

这次终于可以写「它真的算出来了」。

四点体会:

  1. 放弃 OpenGL 是对的。cgx 那套桌面图形栈在鸿蒙上注定走不通,硬上 glshim 只会得到一个又慢又容易崩的东西。用 ArkUI 自己画一个最小 3D 视图,反而把主线(几何 + 变形)稳稳做通了。

  2. 预编译求解器是把双刃剑。好处是用户不用装 Fortran 工具链,克隆即可构建;代价是 8.1 MB 二进制入库、ABI 必须匹配、出问题只能看 stdout。对有限元这种"编译一次、用一辈子"的内核来说,这个交易是划算的。

  3. 引擎状态必须显性化。有限元应用最怕用户不知道"现在到底能不能算"。把「引擎状态:已就绪」放在任务栏第二行,比任何加载动画都有用。

  4. 保留命令行入口是个好判断。老 cgx 用户有肌肉记忆,"切换命令行"这一项让他们不必重新学习一整套 GUI。

7 毫秒算出悬臂梁、生成 5 个结果文件、画出变形——这一屏才是真正的"移植成功"。其他移植项目有的是链路通了、有的还缺引擎,这次是完整的闭环。


一句话:放弃 OpenGL 的那一天,这个应用才真正开始"能算"。

相关链接

Logo

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

更多推荐