对包含原生代码的应用进行调试和性能剖析时,一些需要在进程启动时便启用的调试工具通常很有用。这要求您以全新的进程来运行应用,而不是从 zygote 克隆。例如:
注意:wrap.sh
仅适用于 API 级别 27 及更高级别。
wrap.sh
的使用非常简单:
wrap.sh
的 Shell 脚本。如需了解详情,请参阅创建封装 Shell 脚本和打包 wrap.sh。strace
二进制文件)。当您启动包含 wrap.sh
的可调试 APK 时,系统会执行该脚本并传递启动应用的命令作为参数。脚本负责启动应用,但可以对环境或参数进行任何更改。脚本应遵循 MirBSD Korn Shell (mksh) 语法。
以下代码段展示了如何编写只用于启动应用的简单 wrap.sh
文件:
#!/system/bin/sh exec "$@"
如需通过 wrap.sh
使用 malloc 调试,请添加以下行:
#!/system/bin/sh LIBC_DEBUG_MALLOC_OPTIONS=backtrace logwrapper "$@"
ASan 文档中包含一个示例,说明了如何为 ASan 执行此操作。
为了充分利用 wrap.sh
,您的 APK 必须是可调试的。请确保在 Android 清单的 android:debuggable="true"
设置,如果您使用的是 Android Studio,请确保已在 build.gradle 文件中配置了调试 build。
还需要在应用的 build.gradle
文件中将 useLegacyPackaging 设置为 true
。在大多数情况下,此选项默认设置为 false
,因此您可能需要将其明确设置为 true
以避免发生任何意外。
必须将 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
,但实际上它应该是子目录:
如果您在使用 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 -XjdwpOptions:suspend=n,server=y $@"
fi
exec $cmd