往期推文全新看点（文中附带全新鸿蒙5.0全栈学习笔录）

✏️ 鸿蒙应用开发与鸿蒙系统开发哪个更有前景？

✏️ 嵌入式开发适不适合做鸿蒙南向开发？看完这篇你就了解了~

✏️ 对于大前端开发来说，转鸿蒙开发究竟是福还是祸？

✏️ 鸿蒙岗位需求突增！移动端、PC端、IoT到底该怎么选？

✏️ 记录一场鸿蒙开发岗位面试经历~

✏️ 持续更新中……

---

场景描述

工程源码的混淆可以降低工程被破解攻击的风险，但会导致无法直接通过Release应用的堆栈信息定位到源码的具体文件和行位置，不易于开发者快速定位解决问题。本工具使用指南将以开发者视角，向开发者讲解，如何分别使用IDE自带反混淆工具AnalyzeStaceTrace和hstack命令行对Release应用中C++堆栈、ArkTS堆栈以及ArkTS堆栈中混淆的方法名进行还原，方便开发者进行错误信息定位（注：仅支持API12及以上的工程）。

文件准备工作

1.已混淆的工程和报错日志，这里以混淆工程为例，混淆规则配置如下：

# 开启属性名称混淆
  -enable-property-obfuscation
# 开启字面量名称混淆
  -enable-string-property-obfuscation
# 开启文件/文件夹名称混淆
  -enable-filename-obfuscation
# 开启顶层作用域名称混淆(作用于类名、方法名)
 -enable-toplevel-obfuscation
# 开启export导出对象混淆
  -enable-export-obfuscation

两次运行工程分别点击工程内的Native按钮和ArkTS按钮获取混淆后的报错日志。

2.获取原工程混淆后build产物目录下的sourceMaps.map文件，nameCache.json文件，以及生成的so文件（根据运行的设备的CPU架构选取对应的so文件）产物路径参考下图：

方案描述

1.使用IDE自带工具Analyze Stace Trace工具进行日志反混淆。

a.当前工程为堆栈所在应用对应的工程，且存在Release构建产物：

i.单击菜单栏Code->Analyze Stack Trace，或在FaultLog页面异常堆栈信息处右键选择Analyze Stack Trace。

ii.在弹出的Analyze Stack Trace对话框中，粘贴Release应用的异常堆栈信息。取消勾选Unscramble stack,点击Start Analyze进行解析，对话框右侧及为解析结果：

b.当前工程不为堆栈所在应用对应的工程。

i.ArkTS堆栈报错信息反混淆操作演示。

打开Analyze Stack Trace工具栏，勾选Unscramble stack，分别添加应用对应的sourceMaps.map文件、nameCache.json文件点击Start Analyze即可进行解析，对话框右侧即为解析结果：

ii.Native堆栈报错信息反混淆操作演示。

打开Analyze Stack Trace工具栏，勾选Unscramble stack，分别添加应用对应的sourceMaps.map文件、nameCache.json文件和对应的so文件，点击Start Analyze即可进行解析：

iii.IDE界面参数介绍：

• 左侧输入框：输入需要解析的堆栈信息，右侧为输出结果区域。
• Unscramble stack：不勾选表示以当前IDE工程的realease产物来解析堆栈。
• Source map：文件中存有混淆前后代码位置的映射关系。
• so：动态链接库，包含了已编译的可重用代码，可以被程序在运行时动态加载和链接。
• Name cache：混淆名称映射表，文件中包含混淆前和混淆后的名称。
• Start Analyze：开始解析。

如果你对这篇鸿蒙开发的技术分析感兴趣，还请帮忙来个“素质三连”，后续带你探索 “→更多←（0区籽廖）” 鸿蒙开发的技术奥秘！

2.使用hstack命令的方式进行日志反混淆。

准备工作：

建议准备五个空的文件夹（文件名可自定义），这里在E:\hstackTest目录下分别新建nameCache、nativeso、sourcemap、output、input五个空的文件夹为例。将nameCache.json文件放入nameCache文件内，将sourceMaps.map文件放入sourceMaps文件夹中，将生成的so文件放入nativeso文件中，input文件存放ArkTS和Native堆栈报错信息文件，output文件作为输出目录。

工具下载和环境配置：

a.Node.js配置到环境变量中，以Windows系统为例：（建议使用18.14.1版本）。

b.如果需要对C++文件产生的异常进行解析，则需要将SDK中的native\llvm\bin目录配置到环境变量中，变量名设置为“ADDR2LINE_PATH”（路径的文件名不能包含空格）。

c.根据电脑的操作系统，从 DP平台 上的套件货架上下载对应版本的hstack工具。

ArkTS堆栈报错信息反混淆操作演示。

将ArkTS堆栈文件放入input文件夹内，在工具所在目录打开终端，输入指令：

hstack -i E:\hstackTest\input -o E:\hstackTest\output -s E:\hstackTest\sourcemap -n E:\hstackTest\nameCache

在output文件夹中即可看到解析后的ArkTS堆栈文件（解析后的文件会在原文件名下增加一个“_”命名），解析效果展示：

Native堆栈报错信息反混淆操作演示。

将Native堆栈文件放入input文件夹内，在工具所在目录打开终端，输入指令：

hstack -i E:\hstackTest\input -o E:\hstackTest\output -s E:\hstackTest\sourcemap --so E:\hstackTest\nativeso -n E:\hstackTest\nameCache

解析效果展示：

hstack命令行配置说明：

指令	说明
-s	可选，指定工程sourcemap.map文件归档目录。参数为文件夹
–so	可选，指定工程so文件归档目录。参数为文件夹
-n	可选 ，指定工程nameCache.json文件归档目录。参数为文件夹
-i	堆栈文件目录，参数为文件夹
-o	反混淆文件输出目录，参数为文件夹
–version/-v	查看hstack版本。
–help/-h	查询hstack命令行帮助。

注意事项：

• sourcemap与so文件归档目录至少提供一项。
• 如果需要对方法名进行解析还原，则需要同时提供sourcemap与nameCache文件。
• 路径参数，包括ADDR2LINE_PATH这个环境变量的参数值，不支持以下特殊字符：`！@#￥……&*（）——|{}【】‘；：。，、？。