Android Studio 3.0 及更高版本支持直接对已启用调试的 APK 进行性能分析和调试,而不必从 Android Studio 项目构建这些 APK。
若要开始调试 APK,请按以下步骤操作:
在 Android Studio 欢迎屏幕上,点击 Profile or debug APK。
如果您已经打开一个项目,请在菜单栏中依次点击 File > Profile or Debug APK。
在打开的对话框中,选择要导入 Android Studio 的 APK。
点击确定。
如果此选项未显示,请确保您已启用“Android APK Support”插件。
Android Studio 随后会显示解包后的 APK 文件,类似于图 1。 这不是完全反编译的文件集,不过它为 DEX 文件提供了我们更容易读懂的 SMALI 版本。
在“Project”窗格的 Android 视图中,您可以检查 APK 的以下内容:
- APK 文件:双击相应 APK 以打开 APK 分析器。
- manifests:包含从 APK 中提取的应用清单。
- java:包含 Android Studio 根据 APK 的 DEX 文件反汇编的 Kotlin 或 Java 代码(生成 SMALI 文件)。 此目录中的每个 SMALI 文件都对应一个 Kotlin 或 Java 类。
- cpp:如果您的应用包含原生代码,此目录将包含您的 APK 的原生库(SO 文件)。
- External Libraries:包含 Android SDK。
您可以使用 Android 性能分析器开始测试应用的性能。
若要调试应用的 Kotlin 或 Java 代码,您需要附加 Kotlin 或 Java 源代码,并在 Kotlin 或 Java 源文件中添加断点。同样,若要调试原生代码,您必须附加原生调试符号。
附加 Kotlin 或 Java 源代码
默认情况下,Android Studio 会从您的 APK 中提取 Kotlin 或 Java 代码,并将其另存为 SMALI 文件。若要使用断点调试 Kotlin 或 Java 代码,您需要将 IDE 指向要调试的 SMALI 文件对应的 Kotlin 或 Java 源文件。
如需附加 Kotlin 或 Java 源代码,请按以下步骤操作:
- 在 Android 视图中,从 Project 窗格中双击 SMALI 文件。 打开文件后,编辑器会显示一个横幅,要求您选择 Kotlin 或 Java 源代码:
- 在编辑器窗口中,点击横幅中的 Attach Kotlin/Java Sources…。
- 找到包含应用的 Kotlin 或 Java 源文件的目录,然后点击 Open。
在 Project 窗口中,Android Studio 会将 SMALI 文件替换为对应的 Kotlin 或 Java 源文件。Android Studio 还会自动包含内部类。您现在可以添加断点并调试应用了。
附加原生调试符号
如果您的 APK 包含的原生库(SO 文件)中不包含调试符号,Android Studio 会显示类似图 1 中所示的横幅。您必须附加可调试的原生库,才能调试 APK 的原生代码或使用断点。
如需附加可调试的原生库,请按以下步骤操作:
- 如果您尚未下载,请下载 NDK 和工具。
在 Android 视图中,从 Project 窗口中的 cpp 目录下,双击一个不包含调试符号的原生库文件。
编辑器将显示一个表格,其中列出了您的 APK 支持的所有 ABI。
点击编辑器窗口右上角的 Add。
找到包含要附加的可调试原生库的目录,然后点击 OK。
如果 APK 和可调试原生库是使用不同的工作站构建的,您还需要指定本地调试符号的路径,具体操作步骤如下:
在编辑器窗口的 Path Mappings 部分中的 Local Paths 列下修改相关字段,添加缺失调试符号的本地路径,如图 2 所示。
在大多数情况下,您只需提供根文件夹的路径,Android Studio 会自动检查子目录以映射其他源路径。Android Studio 还会自动将远程 NDK 的路径映射到您的本地 NDK 下载路径。
在编辑器窗口的 Path Mappings 部分中,点击 Apply Changes。
Project 窗口中会显示原生源文件。打开这些原生源文件,以添加断点并调试应用。若要移除映射,请在编辑器窗口的 Path Mappings 部分中点击 Clear。
已知问题:将调试符号附加到 APK 时,APK 和可调试的 SO 文件必须使用相同的工作站或构建服务器进行构建。
在 Android Studio 3.6 及更高版本中,如果 APK 在 IDE 外部进行了更新,您便不需要创建新项目。Android Studio 会检测 APK 中的更改,并为您提供重新导入 APK 的选项。