HarmonyOS开发中的知识：工具篇—hstack

 简介

hstack是DevEco Studio为开发人员提供的用于将release应用混淆后的crash堆栈还原为源码对应堆栈的工具，支持Windows、Mac、Linux三个平台。

hstack命令行格式为:

hstack -i <crash-dir> -o <output-dir> [options]

options: 可选配置，请参考表hstack命令行配置。

表1 hstack命令行配置

指令	说明
-s	可选，指定工程sourcemap文件归档目录。
--so	可选，指定工程shared object文件归档目录。
-n	可选 ，指定工程nameCache文件归档目录。
--version/-v	查看hstack版本。
--help/-h	查询hstack命令行帮助。

说明

• sourcemap与shared object文件归档目录至少提供一项。
• 如果需要对方法名进行解析还原，则需要同时提供sourcemap与nameCache文件。
• 路径参数不支持以下特殊字符：`~!@#$^&*=|{};,\s\[\]<>?~！@#￥……&*（）——|{}【】‘；：。，、？

环境配置

1. 本工具依赖Node环境, 需要将Node.js配置到环境变量中。
2. 如果需要对C++文件产生的异常进行解析，则需要将SDK中的native\llvm\bin目录配置到环境变量中，变量名设置为“ADDR2LINE_PATH”。

使用示例

1. 将应用产生的crash文件归档到crashDir目录下。