Android R8 retrace混淆堆栈轨迹获取原始堆栈轨迹的工具使用

R8 retrace 这款工具用于从经过混淆处理的堆栈轨迹获取原始堆栈轨迹。系统会通过在映射文件中对类名和方法名与其原始定义进行匹配来重构堆栈轨迹。

注意：R8 retrace 是随 Android Studio 4.2 一起发布的 4.0 版命令行工具软件包中的一款独立工具。

如需使用 SDK 管理器下载命令行工具软件包，请参阅使用 SDK 管理器更新工具。SDK 管理器会在 cmdline-tools/version/bin/ 中安装 R8 retrace。

如需使用命令行下载命令行工具软件包，请参阅 sdkmanager。

用法

如需对经过混淆处理的堆栈轨迹进行轨迹还原，请将映射文件传递给 retrace：

retrace  path-to-mapping-file [path-to-stack-trace-file] [options] 

如果未在命令行中提供堆栈轨迹文件，R8 retrace 会等待用户通过标准输入文件来输入堆栈轨迹。输入后，终止输入流：

• Linux、macOS：Control+D
• Windows：Ctrl+Z+Enter

然后，系统会将经过轨迹还原的输出写入标准输出文件。

选项

下表介绍了 R8 retrace 的命令行选项：

选项	是否必需？	说明
--verbose	否	输出更多信息，例如方法参数和方法返回类型。
--info	否	将诊断级别设置为 info。如需更深入地了解相关信息，请参阅 DiagnosticsHandler。
--quiet	否	减少输出的信息量，以突出重点。
--regex <regular_exp>	否	覆盖用于解析堆栈轨迹行的默认正则表达式。例如，以下正则表达式可以解析基本堆栈轨迹： (?:.*? at %c\.%m\(%s(?::%l)?\))|(?:(?:.*?[:"] +)?%c(?::.*)?)。

使用说明

R8 retrace 使用生成的映射文件将经过混淆处理的类名和方法名映射回原始定义。如需详细了解如何缩减应用大小以正确地对其进行轨迹还原，请参阅解码经过混淆处理的堆栈轨迹部分。