Binder Trace开发者指南：扩展自定义解析器和过滤器-育师

Binder Trace开发者指南：扩展自定义解析器和过滤器

【免费下载链接】binder-traceBinder Trace is a tool for intercepting and parsing Android Binder messages. Think of it as "Wireshark for Binder".项目地址: https://gitcode.com/gh_mirrors/bi/binder-trace

Binder Trace是一款强大的Android Binder消息拦截与解析工具，被誉为"Binder领域的Wireshark"。本文将详细介绍如何为Binder Trace开发自定义解析器和过滤器，帮助开发者更高效地分析Android系统中的Binder通信。

自定义解析器开发

解析器是Binder Trace的核心组件，负责将原始的Binder二进制数据转换为人类可读的结构化信息。通过扩展解析器，您可以支持更多自定义的Binder接口和数据类型。

解析器基础架构

Binder Trace的解析功能主要实现在binder_trace/parsing.py文件中。该文件包含了一系列关键函数：

parse_parcel_type: 解析Parcelable类型
parse_generic_type: 解析泛型类型
parse_value_from_definition: 从定义中解析基本值
parse_conditional: 解析条件字段
parse_repeated_value: 解析重复值（数组/列表）

这些函数共同构成了一个灵活的解析框架，可以处理各种复杂的Binder数据结构。

创建自定义解析器步骤

定义数据结构：首先需要为您的自定义类型创建结构定义，通常以.struct文件形式存储在相应的Android版本目录下，如binder_trace/structs/android-14.0.0_r28/
实现解析逻辑：在parsing.py中添加新的解析函数，或扩展现有函数以支持新的数据类型。例如，要解析一个自定义Parcelable，您可以：

def parse_custom_parcelable(definition: Dict[Any, Any], parcel: ParcelParser, parent: Field): # 自定义解析逻辑 name = definition.get("name", "custom_parcelable") # 读取字段并添加到父Field field = parcel.parse_field(name, "CustomParcelable", custom_reader_function, parent) return field

注册解析器：在parse函数中添加对新解析函数的调用，使其能够被框架自动识别和使用。

解析器示例

下面是一个简单的解析器实现示例，展示了如何解析一个包含条件字段的复杂数据结构：

def parse_conditional(definition: Dict[Any, Any], parcel: ParcelParser, parent: Field): conditional = definition["__conditional"] backreference = definition["__backreference"] backreference_field = parent.walk_back_to(backreference) if not backreference_field or not backreference_field.content: return Field.empty() conditional_field = Field(f"Conditional On '{backreference}'", [], "", None, parent) parent.content.append(conditional_field) startPos = parcel.pos for var in conditional: parse(var, parcel, conditional_field) conditional_field.position = FieldData(startPos, parcel.pos)

自定义过滤器开发

过滤器允许用户根据特定条件筛选Binder事务，帮助聚焦于感兴趣的通信内容。Binder Trace提供了灵活的过滤框架，可以轻松扩展以满足特定需求。

过滤器架构

过滤器系统主要在binder_trace/tui/filter.py中实现，核心类包括：

Filter: 单个过滤规则的实现
FilterSet: 多个过滤器的集合管理

创建自定义过滤器

扩展Filter类：创建新的Filter子类，重写passes方法实现自定义过滤逻辑：

class CustomFilter(Filter): def passes(self, block: DisplayTransaction) -> bool: # 自定义过滤逻辑 # 示例：过滤特定UID的事务 return block.uid == self.custom_uid

实现UI集成：在binder_trace/tui/widget/filters.py中添加新的过滤器UI组件，允许用户配置和启用自定义过滤器。
持久化支持：修改过滤器的to_json和from_json方法，确保自定义过滤器的配置可以被保存和加载。

过滤器使用示例

下面是一个过滤器使用示例，展示了如何创建和应用过滤器来筛选特定的Binder事务：

# 创建过滤器：包含"android.app.IActivityManager"接口的事务 am_filter = Filter( interface="android.app.IActivityManager", method=None, types=None, include=True ) # 创建过滤器集合并添加过滤器 filter_set = FilterSet() filter_set.append(am_filter) # 应用过滤器 filtered_transactions = [t for t in all_transactions if filter_set.passes(t)]