HarmonyOS ArkTS 应用从构建到逆向的完整实战:公交出行 App 功能增强与 REA 逆向分析
HarmonyOS ArkTS 应用从构建到逆向的完整实战:公交出行 App 功能增强与 REA 逆向分析
本文记录了一个 HarmonyOS 公交出行应用从源码构建、云手机部署、功能增强、到 REA 逆向分析的完整过程,涵盖 ArkTS 类型系统踩坑、HAP 安全审计、以及语义图谱逆向恢复。
一、背景:为什么要做这件事
有一个 HarmonyOS 公交出行应用 busprogram,需要验证其构建部署流程,并对其新闻模块做功能增强——添加一条示例新闻并修复列表到详情的路由映射缺陷。完成后,还想用逆向工具 REA(Reverse Engineer Anything)对这个应用做静态逆向分析,看看从构建产物中能恢复出多少架构信息。
整个工作链是:源码构建 → 云手机部署 → 数据流分析 → 功能增强 → 重新构建验证 → 提交推送 → 逆向分析。
二、技术方案概览
整体技术栈和工具链:
源码 (ArkTS/Stage 模型)
↓ hvigor 6.26.8 + ohpm 26.0.0.630
HAP 产物 (entry-default-unsigned.hap, 15MB)
↓ HDC (HarmonyOS Device Connector)
云手机安装部署
↓ uitest dumpLayout / snapshot
UI 验证
↓ REA v6.9.0 (analyze-javascript-application + audit-release-exposure)
逆向分析报告 (语义图谱 + 安全审计)
应用采用 HarmonyOS Stage 模型,包含 6 个 feature 模块(首页新闻、出行规划、线路详情/搜索、个人中心、扫码)+ 公共工具模块 + entry 入口模块。第三方依赖为 @ohos/axios 2.2.15(HTTP 请求)和 @ohos/hypium 1.0.19(测试框架)。
三、详细步骤
3.1 构建环境检查与 HAP 编译
构建前检查工具链完整性:
node --version # v22.23.3
ohpm --version # 26.0.0.630
hvigorw --version # 6.26.8
java -version # 需要确认在 PATH 中
安装依赖并编译:
cd busprogram
ohpm install
hvigorw assembleHap --mode module -p product=default --no-daemon
构建产物在 entry/build/default/outputs/default/entry-default-unsigned.hap,15MB,debug 模式,未签名。
3.2 云手机部署与 UI 验证
通过 HDC 连接云手机:
hdc install entry-default-unsigned.hap
hdc shell aa start -a EntryAbility -b gjyy.1.xxxxxx
UI 验证用 hdc shell uitest dumpLayout 获取布局树,用 hdc shell snapshot 截图(注意:只支持 JPEG 格式)。
3.3 新闻数据流分析与缺陷定位
追踪完整数据流:
MockData (newsData + newsDetailPiece)
→ HomePage / NewsHotspot (ForEach 渲染列表)
→ RouteEntryVM.pushByParams (路由跳转)
→ RouterModule (路由解析)
→ NewsDetail (详情页)
发现核心缺陷:NewsDetail 页面始终显示 newsDetailPiece[0](第一条新闻),无论点击哪条新闻都跳转到同一条详情。原因是列表页没有传递新闻 id,详情页也没有按 id 搜索。
另一个发现:hotNewsPiece(热点新闻)的标题与 newsDetailPiece(详情数据)的标题故意不同,这是原始设计。因此不能用标题匹配,必须用 id 映射。
3.4 功能增强:添加新闻 + 修复路由映射
修改涉及 6 个文件:
- Interface.ets:在
NewsDetailSegmentInterface中添加id: string字段,新增NewsDetailParaminterface - MockData.ets:在 newsData 添加第 4 条新闻(id ‘004’),在 newsDetailPiece 添加对应详情
- HomePage.ets:ForEach 的 onClick 传递
{ id: item.id }作为路由参数 - NewsHotspot.ets:同样的 onClick 参数传递模式
- NewsDetail.ets:接收路由参数,用
Array<NewsDetailParam>cast,按 id 搜索 newsDetailPiece,找不到则兜底到第一条 - string.json:添加第 4 条新闻的字符串资源
3.5 REA 逆向分析
REA v6.9.0 是一个通用逆向分析工具,支持 JavaScript/Electron/原生二进制/APK 等目标。
由于 REA 要求 Node.js 22.23.4 以上版本,而环境为 22.23.3,需要下载对应版本:
curl -fsSL "<Node 官方下载地址>/v22.23.4/node-v22.23.4-linux-arm64.tar.xz" -o /tmp/node22.tar.xz
tar xf /tmp/node22.tar.xz -C /tmp/
export PATH="/tmp/node-v22.23.4-linux-arm64/bin:$PATH"
构建 REA 后执行两类分析:
源码静态分析:用 analyze-javascript-application 分析项目源码,处理了 322 个文件、191 个模块、105,892 个 AST 节点,生成 54,381 节点的语义图谱。
HAP 安全审计:用 audit-release-exposure 对 HAP 产物执行 15 项发布暴露检查。
四、踩坑与解决
坑 1:Java 不在 PATH 中
现象:hvigor PackageHap 阶段报 spawn java ENOENT
原因:Java 安装在 /usr/local/java/ 但未加入 PATH
解决:export PATH="/usr/local/java/bin:$PATH"
教训:构建前先检查完整工具链,缺少任一环节都会在特定阶段才暴露
坑 2:string.json 中文引号被损坏为 ASCII 双引号
现象:添加新闻字符串后构建报 JSON parse error
原因:"5G+北斗" 中的中文引号被编辑过程损坏为 ASCII 双引号,破坏 JSON 字符串解析
解决:用 Python 精确替换 ASCII 双引号回中文引号(U+201C / U+201D)
教训:编辑含中文引号的 JSON 时注意字符编码,建议用脚本编辑而非手动
坑 3:ArkTS @Builder 函数返回 void,不能链式 .onClick()
现象:编译报 Property 'onClick' does not exist on type 'void'
原因:@Builder 函数返回 void,不能在调用后链式 .onClick()。这与 React 组件返回 JSX 可以链式调用不同
解决:将 onClick 移入 @Builder 内部,或用容器组件包裹后在外层绑定
教训:ArkTS 的 @Builder 是声明式 UI 构建宏,返回 void,不是返回组件实例的工厂函数
坑 4:getParamByName 返回 unknown[] 不能直接转 string
现象:编译报 unknown[] 到 string 类型转换错误
原因:RouterModule.getParamByName() 返回 unknown[],ArkTS 严格类型不允许直接转换
解决:定义 NewsDetailParam interface,传对象参数,用 Array<NewsDetailParam> cast
教训:ArkTS 类型系统比 TypeScript 更严格;处理路由参数时定义 interface + Array cast 是标准模式
坑 5:Git 推送认证失败
现象:fatal: could not read Username for <GitCode 地址>
原因:环境无存储的 Git 凭据
解决:通过 devspace-connector MCP 获取 Smart HTTP proxy 地址,用 127.0.0.1:9800 端口的 proxy 自动注入凭据
教训:DevSpace 环境中 Git 操作走 Smart HTTP proxy,不要硬编码 token
坑 6:REA 要求 Node.js 22.23.4,环境为 22.23.3
现象:REA 报 EBADENGINE,差一个小版本号就拒绝运行
解决:下载 v22.23.4 二进制包,用新版本 Node 运行 REA
教训:工具引擎版本检查可能差一个小版本号就拒绝;环境中备一份可快速切换的 Node 版本
五、最终验证
功能验证
在云手机上验证:
- 首页显示 4 条新闻(原有 3 条 + 新增 1 条)
- 每条新闻点击后导航到正确的详情页(001→详情1,002→详情2,003→详情3,004→详情4)
- 热点新闻页同样按 id 正确映射
- 出行搜索页面功能正常(回归测试通过)
逆向分析验证
REA 分析结果:
- 模块架构:完整恢复 85 个应用源码模块 + 106 个依赖模块
- 语义图谱:54,381 节点、31,227 关系、2,306 函数、6,599 调用点
- 数据模型:提取到 id(107次)、type(89次)、params(75次)等核心字段
- 路由核心:识别出 RouteEntryVM(23次绑定)为导航核心
- HAP 安全审计:15 项检查全部通过,无 source map、凭据、调试符号泄露
- HAP 结构:纯 ArkTS .abc 字节码,无原生 .so 库,架构无关
Git 提交
修改已提交推送到 GitCode(commit 24fb1f0),包含 6 个文件的变更。
六、复盘总结
做对了的事
- 先分析再动手:修改前完整追踪数据流,确认根因是 NewsDetail 始终取第一条
- 遵循项目现有模式:用项目已有的 interface + Array cast 模式处理路由参数,保持代码风格一致
- 逐层验证:每步修改后都重新构建,快速定位问题
- 日志驱动排障:构建失败时读完整 hvigor 日志,定位首个错误行号
- 安全审计意识:逆向时同步执行 HAP 发布暴露检查
可以改进的地方
- 工具链预检脚本:应提前写一个检查脚本,一次性验证 java/node/hvigorw/ohpm/hdc 全部可用
- JSON 编辑工具:应使用 JSON 编辑工具或脚本而非手动编辑,避免中文引号损坏
- Node 版本管理:应预装 nvm 或类似工具,快速切换 Node 版本
- 缺失 id 兜底测试:代码实现了兜底但未在设备上验证不存在的 id 场景
架构启示
-
ArkTS 类型安全路由模式:interface 定义参数 → pushByParams 传对象 → getParamByName + Array cast → 搜索匹配 → 兜底。这个模式可复用于所有需要传参的 HarmonyOS 路由跳转。
-
REA 对 ArkTS 的分析路径:REA 无 .abc 反编译器,但可通过 hvigor 编译输出的 TypeScript 中间产物进行分析。分析结果仍然有价值——模块架构、数据模型字段、UI 组件频率、安全边界都能恢复。
-
HAP 安全特性:纯 ArkTS 应用的 HAP 不含原生库,架构无关,安全攻击面比含 .so 的应用更小。
七、环境信息
| 项 | 值 |
|---|---|
| 操作系统 | Linux ARM64 |
| Node.js | v22.23.3(REA 需 v22.23.4,已下载切换) |
| hvigor | 6.26.8 |
| ohpm | 26.0.0.630 |
| HarmonyOS SDK | 5.0.0(12) |
| REA | v6.9.0 |
| 应用包名 | gjyy.1.xxxxxx |
| 应用版本 | 1.0.2 (versionCode 1000001) |
| HAP 大小 | 15MB, debug, unsigned |
| 构建模式 | debug (module mode, product=default) |
这次工作完整走过了 HarmonyOS 应用的构建-部署-增强-逆向全链路。最核心的经验是:ArkTS 不是 TypeScript 的简单扩展,它的 @Builder 返回 void、类型系统更严格、路由参数需要显式 interface 定义——这些差异点才是实际开发中最容易踩坑的地方。逆向分析方面,REA 虽然没有 ArkTS 专用支持,但通过编译中间产物仍然能恢复出丰富的架构信息,包括 5 万+节点的语义图谱和完整的安全审计。
- 点赞
- 收藏
- 关注作者
评论(0)