Android 编译插桩操纵字节码

本文讲解如何编译插桩操纵字节码。 就使用 ASM 来实现简单的编译插桩效果，通过插桩实现在每一个 Activity 打开时输出相应的 log 日志。实现思路
过程主要包含两步：

1、遍历项目中所有的 .class 文件​

        如何找到项目中编译生成的所有 .class 文件，是我们需要解决的第一个问题。众所周知，Android Studio 使用 Gradle 编译项目中的 .java 文件，并且从 Gradle1.5.0 之后，我们可以自己定义 Transform，来获取所有 .class 文件引用。但是 Transform 的使用需要依赖 Gradle Plugin。因此我们第一步需要创建一个单独的 Gradle Plugin，并在 Gradle Plugin 中使用自定义 Transform 找出所有的 .class 文件。

2、遍历到目标 .class 文件 （Activity）之后，通过 ASM 动态注入需要被插入的字节码

        如果第一步进行顺利，我们可以找出所有的 .class 文件。接下来就需要过滤出目标 Activity 文件，并在目标 Activity 文件的 onCreate 方法中，通过 ASM 插入相应的 log 日志字节码。

创建主项目 ASMLifeCycleDemo，当前项目中只有一个 MainActivity，如下：

package com.jscode.asmlifecycledemo;

import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;

public class MainActivity extends AppCompatActivity {

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
  }
}

创建自定义 Gradle 插件
首先在 ASMLifeCycleDemo 项目中创建一个新的 module，并选择 Android Library 类型，命名为 asm_lifecycle_plugin。将 asm_lifecycle_plugin module 中除了 build.gradle 和 main 文件夹之外的所有内容都删除。然后在 main 目录下分别创建 groovy 和 java 目录，结构如下：

因为 Gradle 插件是使用 groovy 语言编写的，所以需要新建一个 groovy 目录，用来存放插件相关的.groovy类。 
但 ASM 是 java 层面的框架，所以在 java 目录里存放 ASM 相关的类。 然后，在 groovy 中创建目录com.jscode.plugin，并在此目录中创建类 LifeCyclePlugin.groovy 文件。
在 LifeCyclePlugin 中重写 apply 方法，实现插件逻辑，因为是 demo 演示，所以我只是简单的打印 log 日志。 目录结构如上图，代码如下

package com.jscode.plugin

import com.android.build.gradle.AppExtension
import org.gradle.api.Plugin
import org.gradle.api.Project

public class LifeCyclePlugin implements Plugin<Project> {

    @Override
    void apply(Project project) {
        System.out.println("========LifeCyclePlugin========")
        def android = project.extensions.getByType(AppExtension)

        LifeCycleTransform lt = new LifeCycleTransform()

        android.registerTransform(lt)

    }
}

以看出 LifeCyclePlugin 实现了 gradle api 中的 Plugin 接口。当我们在 app module 的 build.gradle 文件中使用此插件时，其 LifeCyclePlugin 的 apply 方法将会被自动调用。
接下来，将 asm_lifecycle_plugin module 的 build.gradle 中的内容全部删掉，改为如下内容：

plugins {
    id 'groovy'
    id 'maven-publish'   //本文用到maven本地仓库来管理plugin
}

dependencies {
    implementation gradleApi()
    implementation localGroovy()
    implementation("com.android.tools.build:gradle:4.1.3")

    implementation 'org.ow2.asm:asm:7.1'
    implementation 'org.ow2.asm:asm-commons:7.1'
}

publishing {
    repositories {
        maven {
            // $rootDir 表示你项目的根目录
            // 这里配置发布到的本地目录
            url = "$rootDir/repo"
        }
    }

    publications {
        maven(MavenPublication) {

            // 插件的组ID，建议设置为插件的包名
            groupId = 'com.jscode.lifecycleplugin'
            // 插件的名字，后续在引用时会用到
            artifactId = 'myplugin'
            version = '1.0.0'
            // 组件类型
            from components.java
        }
    }
}

group 和 version 都需要在 app module 引用此插件时使用。 所有的插件都需要被部署到 maven 库中，我们可以选择部署到远程或者本地。
本文只是演示，所以只是将插件部署到本地目录中。具体地址通过 repository 属性配置，如图所示我将其配置在项目根目录下的 asm_lifecycle_repo 目录下。 
最后一步，创建 properties 文件。 在 plugin/src/main 目录下新建目录 resources/META-INF/gradle-plguins，然后在此目录下新建一个文件：lifecycleplugin.properties，其中文件名 lifecycleplugin 就是我们自定义插件的名称，稍后我们在 app module 中会使用到此名称。
在 .properties 文件中，需要指定我们自定义的插件类名 LifeCyclePlugin，如下所示：

implementation-class=com.jscode.plugin.LifeCyclePlugin

至此，自定义 Gradle 插件就已经写完，现在可以在 Android Studio 的右边栏找到 Gradle 中点击 publishT