HarmonyOS ArkTS 应用从构建到逆向的完整实战:公交出行 App 功能增强与 REA 逆向分析

举报
yd_221196422 发表于 2026/11/16 17:54:24 2026/11/16
【摘要】 HarmonyOS ArkTS 应用从构建到逆向的完整实战:公交出行 App 功能增强与 REA 逆向分析本文记录了一个 HarmonyOS 公交出行应用从源码构建、云手机部署、功能增强、到 REA 逆向分析的完整过程,涵盖 ArkTS 类型系统踩坑、HAP 安全审计、以及语义图谱逆向恢复。 一、背景:为什么要做这件事有一个 HarmonyOS 公交出行应用 busprogram,需要验证...

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 个文件:

  1. Interface.ets:在 NewsDetailSegmentInterface 中添加 id: string 字段,新增 NewsDetailParam interface
  2. MockData.ets:在 newsData 添加第 4 条新闻(id ‘004’),在 newsDetailPiece 添加对应详情
  3. HomePage.ets:ForEach 的 onClick 传递 { id: item.id } 作为路由参数
  4. NewsHotspot.ets:同样的 onClick 参数传递模式
  5. NewsDetail.ets:接收路由参数,用 Array<NewsDetailParam> cast,按 id 搜索 newsDetailPiece,找不到则兜底到第一条
  6. 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 个文件的变更。

六、复盘总结

做对了的事

  1. 先分析再动手:修改前完整追踪数据流,确认根因是 NewsDetail 始终取第一条
  2. 遵循项目现有模式:用项目已有的 interface + Array cast 模式处理路由参数,保持代码风格一致
  3. 逐层验证:每步修改后都重新构建,快速定位问题
  4. 日志驱动排障:构建失败时读完整 hvigor 日志,定位首个错误行号
  5. 安全审计意识:逆向时同步执行 HAP 发布暴露检查

可以改进的地方

  1. 工具链预检脚本:应提前写一个检查脚本,一次性验证 java/node/hvigorw/ohpm/hdc 全部可用
  2. JSON 编辑工具:应使用 JSON 编辑工具或脚本而非手动编辑,避免中文引号损坏
  3. Node 版本管理:应预装 nvm 或类似工具,快速切换 Node 版本
  4. 缺失 id 兜底测试:代码实现了兜底但未在设备上验证不存在的 id 场景

架构启示

  1. ArkTS 类型安全路由模式:interface 定义参数 → pushByParams 传对象 → getParamByName + Array cast → 搜索匹配 → 兜底。这个模式可复用于所有需要传参的 HarmonyOS 路由跳转。

  2. REA 对 ArkTS 的分析路径:REA 无 .abc 反编译器,但可通过 hvigor 编译输出的 TypeScript 中间产物进行分析。分析结果仍然有价值——模块架构、数据模型字段、UI 组件频率、安全边界都能恢复。

  3. 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 万+节点的语义图谱和完整的安全审计。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。