转载

Android全埋点解决方案之ASM

Android App 的打包流程，可以参考下图: 通过下图可知，我们只要在图中红圈处拦截，就可以拿到所有的 .class 文件，然后遍历 .class 文件中的所有方法，再根据条件找到目标方法，最后进行修改并保存，就可以插入埋点代码了。

Google 从 Android Gradle 1.5.0 开始，提供了 Trans- form API，允许第三方的插件(Plugin)在 Android App 打包成 .dex 文件之前的编译过程中操作 .class 文件。我们只要实现一套 Transform，去遍历所有 .class 文件的所有方法，然后进行修改，最后再对原文件进行替换，即可达到插入代码的目的。

Android全埋点解决方案之ASM

Gradle Transform

Gradle Transform 是 Android 官方提供给开发者在项目构建阶段，即由 .class 到 .dex 转换期间修改 .class 文件的一套 API。目前比较经典的应用是字节码插桩、代码注入技术。

概括来说，Transform 就是把输入的 .class 文件转变成目标字节码文件。

我们先了解一下 Transform 的两个概念:

• TransformInput

TransformInput 是指这些输入文件的抽象。它包括两部分:

1)DirectoryInput 集合

是指以源码方式参与项目编译的所有目录结构及其目录下的源码文件。

2)JarInput 集合

是指以 jar 包方式参与项目编译的所有本地 jar 包和远程 jar 包。

• TransformOutputProvider

是指 Transform 的输出，通过它可以获取输出路径。

我们下面了解一下 Transform.java 的定义。 Transform.java 是一个抽象类，它的定义如下: Android全埋点解决方案之ASM 它定义了几个抽象方法如下:

Gradle Transform 实例

我们下面实现一个 Gradle Transform 的实例，该实例其实没有什么特定功能，仅仅是把所有的输入文件原封不动的拷贝到输出目录。通过 Transform 提供的 API 可以遍历所有文件，包括目录和 jar 包。但是要实现 Transform 的遍历 .class 文件的操作，需要通过 Gradle 插件来实现。完整的项目源码后续会 release 给大家。

ASM

ASM 是一个功能比较齐全的 Java 字节码操作与分析框架。它能被用来动态生成类或者增强既有类的功能。ASM 可以直接产生二进制 class 文件，也可以在类被加载入 Java 虚拟机之前动态改变类的行为。Java class 被存储在严格格式定义的 .class 文件里，这些类文件拥有足够的元数据来解析类中的所有元素，包括类名称、方法、属性以及 Java 字节码(指令)。 ASM 从类文件中读入这些信息后，能够改变类行为、分析类的信息，甚至能够根据具体的要求生成新的类。我们下面简单的介绍一个 ASM 框架中几个核心的类:

Android全埋点解决方案之ASM

ClassVisitor 定义了一系列的 API，它按照一定的标准次序来遍历类中的成员。

在 ClassVisitor 中，我们可以根据实际的需求进行条件判断，只要满足我们特定条件的类，我们才会去修改它的方法。比如，我们要自动采集 Button 的点击事件，那么只有实现了 View$OnClickListener 接口的类，我们才会去遍历它的方法并找到 onClick(view) 方法，然后进行修改操作。我们下面重点介绍 ClassVisitor 中的 visit 方法和 visitMethod 方法。