Android Dynamic Binary Instrumentation (ADBI) 项目常见问题解决方案

Android Dynamic Binary Instrumentation (ADBI) 项目常见问题解决方案

ADBI Android Dynamic Binary Instrumentation tool for tracing Android native layer 项目地址: https://gitcode.com/gh_mirrors/adb/ADBI

项目基础介绍

Android Dynamic Binary Instrumentation (ADBI) 是一个用于动态追踪 Android 原生层的工具。通过这个工具，用户可以在运行中的 Android 系统进程地址空间中动态插入追踪点（以及相应的处理程序）。当追踪点被触发时，用户自定义的 C 语言处理程序将被执行。用户可以通过处理程序传递自己的代码，访问进程变量和内存。主机端的 Python 工具与本地的 adbiserver 进程通信，将源代码级别的符号转换为最终二进制文件中的地址。据作者所知，这是 ARM（包括 ARM64）架构的第一个此类工具。

ADBI 项目主要使用以下编程语言：

• C
• Python
• C++
• Assembly
• Makefile
• Shell

新手使用注意事项及解决方案

1. 环境配置问题

问题描述：新手在配置 ADBI 项目环境时，可能会遇到依赖库缺失或版本不兼容的问题。

解决步骤：

1. 检查依赖库：确保系统中已安装所有必要的依赖库，如 libelf、libdl 等。
2. 版本兼容性：确认所使用的依赖库版本与 ADBI 项目要求的版本一致。如果不一致，尝试降级或升级依赖库。
3. 编译工具链：使用项目提供的 make_toolchain_deb.sh 脚本编译工具链，确保工具链版本与目标 Android 设备兼容。

2. 权限问题

问题描述：在 Android 设备上运行 ADBI 时，可能会遇到权限不足的问题，导致无法插入追踪点或执行自定义代码。

解决步骤：

1. 提升权限：确保在 Android 设备上以 root 权限运行 ADBI。可以使用 adb root 命令获取 root 权限。
2. 检查 SELinux 状态：如果设备启用了 SELinux，确保 SELinux 处于宽容模式（permissive mode）。可以使用 setenforce 0 命令将 SELinux 设置为宽容模式。
3. 权限配置：检查项目中的权限配置文件，确保所有必要的权限已正确配置。

3. 符号解析问题

问题描述：在插入追踪点时，可能会遇到符号解析失败的问题，导致无法正确插入追踪点。

解决步骤：

1. 符号表检查：确保目标二进制文件包含完整的符号表。如果符号表缺失，尝试使用 nm 或 objdump 工具检查并修复符号表。
2. 符号解析工具：使用项目提供的符号解析工具，确保符号解析工具配置正确，并且能够正确解析目标二进制文件中的符号。
3. 调试信息：如果符号解析仍然失败，尝试在编译目标二进制文件时添加调试信息（如 -g 选项），以便更好地进行符号解析。

通过以上步骤，新手可以更好地理解和解决在使用 ADBI 项目时可能遇到的问题。

ADBI Android Dynamic Binary Instrumentation tool for tracing Android native layer 项目地址: https://gitcode.com/gh_mirrors/adb/ADBI