Binder Trace

Binder Trace 是一款用于拦截和解析 Android Binder 消息的工具。你可以把它视为“Binder 版 Wireshark”。

环境要求

python 版本 >= 3.9

⚙️ 安装

你需要一台已 root 的 Android 设备或模拟器。

• （仅限 Linux）- 安装 xclip 或 xsel 以获得“复制到剪贴板”功能

  sudo apt-get install xclip

  sudo apt-get install xsel

• 从 PyPi 安装

  pip install binder-trace

• 检查已安装的 frida 版本（请确保已通过 pip 安装所需依赖）

  pip list | grep frida

• 从 frida 发布页面 下载匹配版本的 frida-server

• 确保 adb 以 root 身份运行，将 frida-server 推送到设备上并运行它

  adb root

  adb push frida-server /data/local/tmp

  adb shell

  chmod u+x /data/local/tmp/frida-server

  /data/local/tmp/frida-server

参数

▶️ 启动 binder trace

要启动 binder trace，我们需要选择一个要附加到的设备和进程。 在下面的示例中，我们使用 adb 和 frida-ps 来识别本地模拟器上要附加到的进程。由于它是 Android 11 模拟器，我们选择 Android 11 structs 目录。请选择与你的 Android 版本最接近的 struct 目录。如果你需要其他 Android 版本的结构体，请告诉我们。运行起来后，开始使用目标应用来产生一些 binder 事务。

> adb devices
List of devices attached
emulator-5554   device

> frida-ps -Ua
 PID  Name           Identifier
----  -------------  ----------------------------
8334  Messaging      com.android.messaging
7941  Phone          com.android.dialer
9607  Settings       com.android.settings

> cd binder_trace
> binder-trace -d emulator-5554 -n Messaging -a 11

⌨️ 控制

🌐 全局

📈 频率窗格

🔎 配置文件

要过滤，请定义 interface、method、type 和 inclusive 选项中的任意一个或全部。不使用某个选项时，请将其留空 ""

不使用 -c 参数

> binder-trace -d emulator-5554 -n Contacts -a 13

使用 -c 参数

config.json

{
    "filters": [
        {
            "interface": "android.gui.IDisplayEventConnection",
            "method": "requestNextVsync",
            "type": "",
            "inclusive": false
        },
        {
            "interface": "android.content.IContentProvider",
            "method": "",
            "type": "call",
            "inclusive": false
        }
    ]
}

> binder-trace -d emulator-5554 -n Contacts -a 13 -c .\binder_trace\binder_trace\config.json

android.gui.IDisplayEventConnection->requestNextVsync->"" 和 android.content.IContentProvider->"" ->call 已被过滤掉

📦 结构兼容性

内部 binder 接口可能会在不同的小版本之间发生变化，而由于它们实际上是整体编译在一起的，没有运行时版本信息，因此很难为 Android 高度碎片化的生态系统中的每个版本提供 100% 准确的结构信息。

有关结构体的更多详细信息，请参见 结构说明页面。