封装 Shell 脚本

使用原生代码对应用进行调试和性能剖析时,使用需要在进程启动时启用的调试工具通常很有用。这要求您以全新的进程运行应用,而不是从 zygote 克隆。例如:

使用封装 Shell 脚本

使用 wrap.sh 非常简单:

  1. 编译封装了以下内容的自定义可调试 APK:
    • 一个名为 wrap.sh 的 Shell 脚本。有关更多详情,请参阅创建封装 Shell 脚本封装 wrap.sh
    • 您的 Shell 脚本需要的任何其他工具(例如您自己的 strace 二进制文件)。
  2. 在设备上安装可调试 APK。
  3. 启动应用。

创建封装 Shell 脚本

当您启动包含 wrap.sh 的可调试 APK 时,系统会执行该脚本并传递相应命令作为参数来启动应用。脚本负责启动应用,但可以对环境或参数进行任何更改。脚本应遵循 MirBSD Korn Shell (mksh) 语法。

以下代码段展示了如何编写只用于启动应用的简单 wrap.sh 文件:

    #!/system/bin/sh
    exec "$@"
    

Malloc 调试

要通过 wrap.sh 使用 malloc 调试,请添加以下行:

    #!/system/bin/sh
    LIBC_DEBUG_MALLOC_OPTIONS=backtrace logwrapper "$@"
    

ASan

ASan 文档中有一个示例说明了如何为 ASan 执行此操作。

封装 wrap.sh

为了充分利用 wrap.sh,您的 APK 必须可调试。请确保在 Android 清单的 <application> 元素中配置了 android:debuggable="true" 设置,如果您使用的是 Android Studio,请确保已在 build.gradle 文件中配置了调试编译版本。

还需要在 <application> 中设置 android:extractNativeLibs="true"。这是默认设置,但如果您明确将其设置为 false,则 wrap.sh 脚本将无法运行。

必须将 wrap.sh 脚本与应用的原生库一起封装。如果应用没有原生库,请手动将 lib 目录添加到项目目录中。对于应用支持的每种架构,必须在该原生库目录下提供封装 Shell 脚本的副本。

以下示例展示了同时支持 ARMv8 和 x86-64 架构的文件布局:

    # App Directory
    |- AndroidManifest.xml
    |- …
    |- lib
       |- arm64-v8a
          |- ...
          |- wrap.sh
       |- x86_64
          |- ...
          |- wrap.sh
    

Android Studio 仅封装 lib/ 目录中的 .so 文件,因此如果您是 Android Studio 用户,则需要将 wrap.sh 文件放在 src/main/resources/lib/* 目录中,这样它们才会正确封装。

请注意,resources/lib/x86 在界面中显示为 lib.x86,但实际上它应该是子目录:

在 Android Studio 中封装 wrap.sh 的示例

使用 wrap.sh 时进行调试

如果您在使用 wrap.sh 时想要附加调试程序,则 Shell 脚本将需要手动启用调试。如何执行此操作因版本而异,此示例展示了如何为支持 wrap.sh 的所有版本添加适当的选项:

#!/system/bin/sh

    cmd=$1
    shift

    os_version=$(getprop ro.build.version.sdk)

    if [ "$os_version" -eq "27" ]; then
      cmd="$cmd -Xrunjdwp:transport=dt_android_adb,suspend=n,server=y -Xcompiler-option --debuggable $@"
    elif [ "$os_version" -eq "28" ]; then
      cmd="$cmd -XjdwpProvider:adbconnection -XjdwpOptions:suspend=n,server=y -Xcompiler-option --debuggable $@"
    else
      cmd="$cmd -XjdwpProvider:adbconnection $@"
    fi

    exec $cmd