调试预构建的 APK

Android Studio 3.0 及更高版本允许您分析和调试已启用调试的 APK,而无需从 Android Studio 项目中构建它们。

要开始调试 APK,请按照以下步骤操作

  1. 在 Android Studio 欢迎屏幕中,点击**分析或调试 APK**。

    如果您已打开项目,请从菜单栏中点击**文件 > 分析或调试 APK**。

  2. 在打开的对话框中,选择要导入到 Android Studio 的 APK。

  3. 点击**确定**。

如果此选项未显示,请确保已启用“Android APK 支持”插件。

然后,Android Studio 会显示解压缩的 APK 文件,类似于图 1。这并不是一组完全反编译的文件,但它确实提供了 SMALI 文件,以便更易于阅读 DEX 文件。

Importing a pre-built APK into Android Studio

图 1. 将预构建的 APK 导入到 Android Studio 中。

项目窗格中的**Android**视图允许您检查 APK 的以下内容

  • APK 文件:双击 APK 以打开 APK 分析器。
  • 清单:包含从 APK 中提取的应用清单。

  • java: 包含 Kotlin 或 Java 代码,Android Studio 会从 APK 的 DEX 文件中反编译(转换为 SMALI 文件)。此目录中的每个 SMALI 文件对应一个 Kotlin 或 Java 类。
  • cpp: 如果您的应用包含原生代码,则此目录包含 APK 的原生库 (SO 文件)。
  • 外部库: 包含 Android SDK。

您可以使用 Android Profiler开始测试应用的性能。

要调试应用的 Kotlin 或 Java 代码,您需要附加 Kotlin 或 Java 源代码并在 Kotlin 或 Java 源文件中添加断点。类似地,要调试原生代码,您必须附加原生调试符号

附加 Kotlin 或 Java 源代码

默认情况下,Android Studio 会从 APK 中提取 Kotlin 或 Java 代码并将其保存为 SMALI 文件。要使用断点调试 Kotlin 或 Java 代码,您需要将 IDE 指向与要调试的 SMALI 文件对应的 Kotlin 或 Java 源文件。

要附加 Kotlin 或 Java 源代码,请按以下步骤操作

  1. 双击**Android**视图中**Project**窗格中的 SMALI 文件。打开文件后,编辑器会显示一个横幅,要求您选择 Kotlin 或 Java 源代码:附加源代码横幅
  2. 点击编辑器窗口中横幅上的**Attach Kotlin/Java Sources...**。
  3. 导航到包含应用 Kotlin 或 Java 源文件的目录,然后点击**Open**。

在**Project**窗口中,Android Studio 会用其对应的 Kotlin 或 Java 源文件替换 SMALI 文件。Android Studio 还会自动包含内部类。现在,您可以添加断点并调试您的应用

附加原生调试符号

如果您的 APK 包含不包含调试符号的原生库 (SO 文件),Android Studio 会显示一个类似于图 1 中所示的横幅。如果没有附加可调试的原生库,则无法调试 APK 的原生代码或使用断点。

要附加可调试的原生库,请按以下步骤操作

  1. 如果尚未执行此操作,请下载 NDK 和工具
  2. 在**Android**视图中,在**Project**窗口的**cpp**目录下,双击不包含调试符号的原生库文件。

    编辑器会显示 APK 支持的所有 ABI 的表格。

  3. 点击编辑器窗口右上角的**Add**。

  4. 导航到包含要附加的可调试原生库的目录,然后点击**OK**。

如果 APK 和可调试的原生库是使用不同的工作站构建的,则还需要按照以下步骤指定本地调试符号的路径

  1. 通过编辑编辑器窗口**Path Mappings**部分中**Local Paths**列下的字段,添加缺少的调试符号的本地路径,如图 2 所示。

    在大多数情况下,您只需提供根文件夹的路径,Android Studio 就会自动检查子目录以映射其他源。Android Studio 还会自动将路径映射到远程 NDK 到您的本地 NDK 下载。

  2. 点击编辑器窗口**Path Mappings**部分中的**Apply Changes**。

Providing paths to local debug symbols

图 2. 调试符号的本地路径。

原生源文件将显示在**Project**窗口中。打开这些原生源文件以添加断点并调试您的应用。要删除映射,请点击编辑器窗口**Path Mappings**部分中的**Clear**。

已知问题:将调试符号附加到 APK 时,APK 和可调试的 SO 文件必须使用同一工作站或构建服务器构建。

在 Android Studio 3.6 及更高版本中,当 APK 在 IDE 外部更新时,您无需创建新项目。Android Studio 会检测 APK 中的变化,并为您提供重新导入它的选项。

Import updated APK

图 3. 可以重新导入在 Android Studio 外部更新的 APK。