【Android 字节码插桩】Gradle插件基础 Transform API的使用

前言

啪~我给大家开个会（手机扔桌子上）
什么叫做 客户无感的数据脱敏！？
师爷给翻译翻译什么叫做客户无感的数据脱敏？
什么特么的叫做客户无感数据脱敏？
举个栗子~
客户端Sdk新升级了一个版本，增加针对客户的数据的脱敏，但是客户不需要重新调用新的api，且旧的api执行的性能还是不变的，那么大家可能就会问， 切入点在哪呢？ 你不调用新的api或者改动旧的api，如何获取用户数据呢？

字节码的插桩就是做这个用的， 一句话描述~
我（字节码插桩）来这，就是将一段代码通过某种策略插入到另一段代码，或替换另一段代码

一、Gradle插件基础

在Gradle官方文档上是这么描述的：
…
我的理解:
Gradle 是一种开源构建自动化工具，依赖管理目前只支持 Maven 和 Ivy 兼容的存储库和文件系统

当然， 如果你更喜欢gradle 官方文档上面的描述的话，也行…

在日常写bug的时候，我们每一次新建的工程，最常见的是：
build.gradle 中的 apply plugin: ‘com.android.application’，
而apply plugin: ‘com.android.application’ 就是Android提供出来构建APK的一个gradle插件

在该篇文章中，我们主要使用 静态类型的 Java 或 Kotlin 实现的插件，实际测试java 或 kotlin实现的插件， 比 groovy 实现的性能更好一些，当然只要你喜欢， 可以使用任何你喜欢的语言来实现gradle插件， 当然前提是最终可以被编译为jvm字节码~

Gradle插件编写方式

一般来讲，比较流行的是以下三种编写Gradle 插件的编写方式：

  • 项目中编写脚本
    直接在构建脚本中包含插件的源代码。这样做的好处是插件会自动编译并包含在构建脚本的类路径中，而您无需执行任何操作。但是，该插件在构建脚本之外不可见，因此您不能在定义它的构建脚本之外重用该插件
  • 项目中编写buildSrc 项目 （module）
    插件的源代码放在rootProjectDir/buildSrc/src/main/java目录中（rootProjectDir/buildSrc/src/main/groovy或rootProjectDir/buildSrc/src/main/kotlin取决于您喜欢的语言）。Gradle 将负责编译和测试插件，并使其在构建脚本的类路径上可用。该插件对构建使用的每个构建脚本都是可见的。但是，它在构建之外不可见，因此不能在定义它的构建之外重用插件
  • 独立项目 （SDK）
    插件创建一个单独的项目。该项目生成并发布一个 JAR，然后您可以在多个构建中使用它并与他人共享。通常，这个 JAR 可能包含一些插件，或者将几个相关的任务类捆绑到一个库中。或者两者的某种组合

简单介绍完成之后，就开始了我们写实际的操作了，请看VCR ~

为了方便，文中均使用Java来开发Gradle插件，当然，你也可以用Groovy或者Kotlin来试试

1. Gradle 的插件编写之构建脚本

构建脚本这种方式是最简单的，简单到只需要修改build.gradle文件即可，而不需要其他特殊的编码操作，当然功能也是有限
首先，创建新项目，然后我们可以在 项目的 app/build.gradle文件末尾添加~
示例代码：

class PHPluginExtension {// 为插件扩展定义一个字符串类型的变量String message = "hello，this is my custom plugin..."
}// 自定义的插件必须继承Plugin接口
class PH2Plugin implements Plugin<Project> {@Overridevoid apply(Project project) {// 创建插件扩展，greeting为插件扩展的名称，可以在gradle文件其他地方使用def extension = project.extensions.create('greeting', MyPluginExtension)project.task('hello') {doLast {//执行其他代码或者打印相关信息println extension.message}}}
}// 使用这个自定义的插件
apply plugin: PH2Plugin

然后去sync项目，在AndroidStudio右侧的Gradle视图里，可以发现Tasks/others下面出现了一个hello任务，我们双击该任务执行它，会发现控制台中出现如下信息：

这样，就表示我们的gradle插件已经正常执行了，还可以在外部单独写一个文件，跟 app/build.gradle 同级目录， 比如说叫panghu.gradle， 再在app/build.gradle文件中引用panghu.gradle文件即可，类似于下面代码：

apply plugin: 'com.android.application'// 这一行可以引用外部的gradle文件
apply from: './panghu.gradle'android {...
}
// 通过这种配置方式，修改自定义插件中配置的message的值
PH2{message = "更新你想要的文字"
}

buildSrc编写gradle插件项目主要也是用在当前项目中，不能被外部的项目引用，它的创建有一套固定的流程，步骤如下：

第二种是使用buildSrc，首先再项目的根目录创建一个buildsrc目录， 然后点击make按钮， as会自动在 buildSrc文件下面生成一些文件
会有， build.gradle ,.gradle，src，build，
在 build.gradle 中指向对应的包名的类， src/main/java 目录下新建mplugin 类，继承 Plugin类，
然后实现对应的方法，apply…

2. Gradle 的插件编写之buildSrc

buildSrc编写gradle插件项目的是在当前项目下使用，不能也没办法给外部使用，创作流程如下：

1.首先在项目根目录下新建一个buildSrc目录，然后点击AS的make 编译，AS就会自动在buildSrc目录下创建一些文件，如下图所示：

在这里插入图片描述

2.在buildSrc目录下新建build.gradle文件并加入如下代码：

apply plugin: 'java-library'sourceSets {main {java{srcDir 'src/main/java'}resources {srcDir 'src/main/resources'}}
}java {sourceCompatibility = JavaVersion.VERSION_1_8targetCompatibility = JavaVersion.VERSION_1_8
}

3.在buildSrc目录下创建src目录，并在src目录下分别创建main/java和main/resources目录

4.在src/main/java目录下编写插件代码，比如这里我们创建一个简单的插件类，代码如下

package com.panghu.mplugin;import org.gradle.api.Plugin;
import org.gradle.api.Project;public class MPlugin implements Plugin<Project> {@Overridepublic void apply(Project project) {System.out.println("Hello from MPlugin...");}
}

5.配置插件
在src/main/resources/目录下再创建META-INF/gradle-plugins目录，并在该目录中添加一个文件，文件的命名需要根据插件所在类的名称来，比如上面我们编写的插件类在com.panghu.mplugin包下面，那么就需要创建一个com.panghu.mplugin.properties文件，该文件内容如下：

implementation-class=com.panghu.mplugin.MPlugin

项目整体的结构如下图：
在这里插入图片描述
以上所有步骤都做完之后，即可在app module中引用插件了，引用插件的方法是直接在app/build.gradle文件头部通过apply plugin: 'com.panghu.mplugin’的方式即可，然后我们通过AndroidStudio make图标编译项目，在输出的日志中会发现该插件打印的消息~ 诸君可以把打出来的放在评论区~

3. Gradle 的插件编写之独立项目（SDK）

当然，以上内容只适合在自己的项目中使用，那么我如果想打成sdk供其他人使用呢？ 看下面：

如果要使我们编写的gradle插件被外部项目所引用，比如每个AndroidStudio创建的项目都依赖了’com.android.application’这个插件，那么我们就需要使用这种独立项目来完成gradle插件的开发了，开发步骤如下：

  1. 在Android项目上右键，选择New - Module - Java or Kotlin Library创建一个Java library，这里我们取名为plugin
  2. 在该library module的build.gradle文件中编写如下代码：
apply plugin: 'groovy'
apply plugin: 'maven'repositories {mavenLocal()
}dependencies {implementation gradleApi()
}//publish to local directory
group "com.panghu.plugin"
version "1.0.0"uploadArchives{ //当前项目可以发布到本地文件夹中repositories {mavenDeployer {repository(url: uri('./repo')) //定义本地maven仓库的地址}}
}

  1. 同第二种实现gradle插件的方式一样，在library的根目录下创建src目录，并在src目录下分别创建main/java main/resources目录

  2. 在src/main/java目录下编写插件代码，这里测试用的代码如下：

package com.panghu.plugin;import org.gradle.api.Plugin;
import org.gradle.api.Project;public class MPlugin implements Plugin<Project> {@Overridepublic void apply(Project project) {System.out.println("Hello this is a single gradle plugin...");}
}
  1. 在src/main/resources/META-INF/gradle-plugins目录下创建文件，文件名为com.panghu.plugin.properties，文件内容为：
implementation-class=com.panghu.plugin.MPlugin

然后再去同步 sync， 在AndroidStudio右侧的Gradle视图中，我们会看到该插件对应的任务，如下图所示：

在这里插入图片描述
ps：上面这个图片中没有对应的task，编写博客和code不在一个时空，但是位置在这里，仅作参考~

我们双击Tasks - 对应的任务名，AS会自动将该插件打包并上传到maven仓库，注意在上面的第2步中，我们设置了maven仓库为本地地址./repo，则任务执行成功后，会在library的根目录下生成repo目录~

最后，为了引用该插件，我们需要在Android项目中做如下配置：

buildscript {repositories {google()mavenCentral()maven { // 本机的repo目录地址url '/.../repo'}}dependencies {classpath "com.android.tools.build:gradle:4.2.2"classpath "com.panghu.plugin:plugin:1.0.0" //配置的版本号// NOTE: Do not place your application dependencies here; they belong// in the individual module build.gradle files}
}

在app module的build.gradle文件头部引用该插件：

apply plugin: 'com.panghu.plugin'

然后，编译项目，可以看到该插件输出的日志信息~

那么以上就是三种gradle插件的编写方式，第二种第三种大同小异， 打的包不同而已；第一种是在对应的gradle文件中直接写了，其实都可~ 依据项目需求而定~

二、 TransformAPI是什么

简介

这里是对 TransformAPI 的相关介绍， 有兴趣的哥们可以去看看

其实理解起来就是，TransformAPI可以让我们在编译打包安卓项目时，在源码编译为class字节码后，处理成dex文件前，对字节码做一些操作。

实现自定义的Transform一般要复写如下几个方法，下面对每个方法做一下详细解释~

TransformAPI常用复写方法

getName()

getName()方法用于指明自定义的Transform的名称，在gradle执行该任务时，会将该Transform的名称再加上前后缀，如上面图中所示的，最后的task名称是transformClassesWithXXXForXXX这种格式。

getInputTypes()

用于指明 Transform 的输入类型，可以作为输入过滤的手段。在 TransformManager 类中定义了很多类型：

// 代表 javac 编译成的 class 文件，常用
public static final Set<ContentType> CONTENT_CLASS;
public static final Set<ContentType> CONTENT_JARS;
// 这里的 resources 单指 java 的资源
public static final Set<ContentType> CONTENT_RESOURCES;
public static final Set<ContentType> CONTENT_NATIVE_LIBS;
public static final Set<ContentType> CONTENT_DEX;
public static final Set<ContentType> CONTENT_DEX_WITH_RESOURCES;
public static final Set<ContentType> DATA_BINDING_BASE_CLASS_LOG_ARTIFACT;
getScopes()

用于指明 Transform 的作用域。同样，在 TransformManager 类中定义了几种范围：


// 注意，不同版本值不一样
public static final Set<Scope> EMPTY_SCOPES = ImmutableSet.of();
public static final Set<ScopeType> PROJECT_ONLY;
public static final Set<Scope> SCOPE_FULL_PROJECT; // 常用
public static final Set<ScopeType> SCOPE_FULL_WITH_IR_FOR_DEXING;
public static final Set<ScopeType> SCOPE_FULL_WITH_FEATURES;
public static final Set<ScopeType> SCOPE_FULL_WITH_IR_AND_FEATURES;
public static final Set<ScopeType> SCOPE_FEATURES;
public static final Set<ScopeType> SCOPE_FULL_LIBRARY_WITH_LOCAL_JARS;
public static final Set<ScopeType> SCOPE_IR_FOR_SLICING;

常用的是 SCOPE_FULL_PROJECT ，代表所有 Project 。

确定了 ContentType 和 Scope 后就确定了该自定义 Transform 需要处理的资源流。比如 CONTENT_CLASS 和 SCOPE_FULL_PROJECT 表示了所有项目中 java 编译成的 class 组成的资源流。

isIncremental()

指明该 Transform 是否支持增量编译。需要注意的是，即使返回了 true ，在某些情况下运行时，它还是会返回 false 的。

transform(TransformInvocation transformInvocation)

一般在这个方法中对字节码做一些处理。

TransformInvocation是一个接口，源码如下：

public interface TransformInvocation {/*** Returns the context in which the transform is run.* @return the context in which the transform is run.*/@NonNullContext getContext();/*** Returns the inputs/outputs of the transform.* @return the inputs/outputs of the transform.*/@NonNullCollection<TransformInput> getInputs();/*** Returns the referenced-only inputs which are not consumed by this transformation.* @return the referenced-only inputs.*/@NonNull Collection<TransformInput> getReferencedInputs();/*** Returns the list of secondary file changes since last. Only secondary files that this* transform can handle incrementally will be part of this change set.* @return the list of changes impacting a {@link SecondaryInput}*/@NonNull Collection<SecondaryInput> getSecondaryInputs();/*** Returns the output provider allowing to create content.* @return he output provider allowing to create content.*/@NullableTransformOutputProvider getOutputProvider();/*** Indicates whether the transform execution is incremental.* @return true for an incremental invocation, false otherwise.*/boolean isIncremental();
}

我们既可以通过TransformInvocation来获取输入,同时也获得了输出的功能，举个例子：

public void transform(TransformInvocation invocation) {for (TransformInput input : invocation.getInputs()) {input.getJarInputs().parallelStream().forEach(jarInput -> {File src = jarInput.getFile();JarFile jarFile = new JarFile(file);Enumeration<JarEntry> entries = jarFile.entries();while (entries.hasMoreElements()) {JarEntry entry = entries.nextElement();//处理}}

TransformAPI 实际操作

本文通过编写一个TransformAPI实例来介绍如何在Android项目中使用TransformAPI~ 请看VCR~

首先 使用Android Studio创建Android项目，这里我取名为TransformDemo~
按照buildSrc的形式，创建一个文件夹，上文有描述~ 格式如下：
在这里插入图片描述

在buildSrc目录下创建build.gradle文件，加入如下代码：

apply plugin: 'groovy'
apply plugin: 'maven'repositories {google()mavenCentral()
}dependencies {implementation gradleApi()implementation localGroovy()implementation 'com.android.tools.build:gradle:4.2.2'
}sourceSets {main {java {srcDir 'src/main/java'}resources {srcDir 'src/main/resources'}}
}java {sourceCompatibility = JavaVersion.VERSION_1_8targetCompatibility = JavaVersion.VERSION_1_8
}

在插件包com.panghu.plugin中创建一个MPlugin类，代码如下：

package com.panghu.plugin;import com.android.build.gradle.BaseExtension;import org.gradle.api.Plugin;
import org.gradle.api.Project;public class MPlugin implements Plugin<Project> {@Overridepublic void apply(Project project) {// 将Transform注册到插件中，执行插件时就会自动执行该TransformBaseExtension ext = project.getExtensions().findByType(BaseExtension.class);if (ext != null) {ext.registerTransform(new MTransform());}}
}

创建MyTransform类，代码如下~

package com.panghu.plugin;import com.android.build.api.transform.QualifiedContent;
import com.android.build.api.transform.Transform;
import com.android.build.api.transform.TransformException;
import com.android.build.api.transform.TransformInvocation;
import com.android.build.gradle.internal.pipeline.TransformManager;import java.io.IOException;
import java.util.Set;public class MTransform extends Transform {@Overridepublic String getName() {// 最终执行时的任务名称为transformClassesWithMyTestFor[XXX] (XXX为Debug或Release)return "MTest";}@Overridepublic Set<QualifiedContent.ContentType> getInputTypes() {return TransformManager.CONTENT_CLASS;}@Overridepublic Set<? super QualifiedContent.Scope> getScopes() {return TransformManager.SCOPE_FULL_PROJECT;}@Overridepublic boolean isIncremental() {return false;}@Overridepublic void transform(TransformInvocation transformInvocation) throws TransformException, InterruptedException, IOException {super.transform(transformInvocation);System.out.println("Hello MTransform...");}
}

然后就是注册插件，使用插件了~
这些已经讲过了就不再赘述了~

总结

对于APM & 数据隐私行业，字节码插码是一个比较好用工具~ 完结撒花，有问题随时评论@
文中部分素材取用： https://blog.csdn.net/yubo_725/article/details/118545829~

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.hqwc.cn/news/444655.html

如若内容造成侵权/违法违规/事实不符，请联系编程知识网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

uniapp+微信小程序+nodejs问题记录

uniapp+微信小程序+nodejs问题记录

一、前言 通过uniapp进行微信小程序调试。服务端使用NodeJs。 二、报错统计 1、本地调试时微信小程序报错&#xff1a;request:Cannot send network request to localhost 解决方法&#xff1a; 【微信小程序开发平台】-【本地设置】-勾选“不校验合法域名、web-view、TLS版本…
阅读更多...
猫什么时候发腮？性价比高的发腮主食冻干推荐

猫什么时候发腮？性价比高的发腮主食冻干推荐

猫什么时候发腮&#xff1f;发腮是猫咪成长过程中一个重要的体征&#xff0c;也是猫父母们非常关心的问题。想要让猫咪拥有可爱的肉嘟嘟脸型&#xff0c;主人需要在适龄的年龄段加强营养补给&#xff0c;不要错失最佳发腮期。猫什么时候发腮呢&#xff1f;应该怎样喂养才能让猫…
阅读更多...
关于谷歌新版调试用具(Chrome Dev Tool )，网络选项(chrome-network)默认开启下拉模式的设置

关于谷歌新版调试用具(Chrome Dev Tool )，网络选项(chrome-network)默认开启下拉模式的设置

今天在使用谷歌浏览器进行调试的时候&#xff0c;打开调试工具网络选项发现过滤不同模式的选项卡不见了&#xff0c;转而变成一个下拉式选项&#xff0c;如下图 这样一来使得切换不同类型查看的时候变得非常不方便&#xff0c;然后网上查了一下发现这个功能谷歌在很早版本就已…
阅读更多...
Modelsim10.4安装

Modelsim10.4安装

简介&#xff08;了解&#xff0c;可跳过&#xff09; modelsim是Mentor公司开发的优秀的HDL语言仿真软件。 它能提供友好的仿真环境&#xff0c;采用单内核支持VHDL和Verilog混合仿真的仿真器。它采用直接优化的编译技术、Tcl/Tk技术和单一内核仿真技术&#xff0c;编译仿真速…
阅读更多...
【ARM Trace32(劳特巴赫) 使用介绍 3.1 -- 不 attach core 直接访问 memory】

【ARM Trace32(劳特巴赫) 使用介绍 3.1 -- 不 attach core 直接访问 memory】

文章目录 背景介绍背景介绍 在使用 trace32 时在有些场景需要不 attach core 然后去读写 memory，比如在某些情况下 core 已经挂死连接不上了，这个时候需要dump内存，这个时候需要怎做呢？ print "test for memory access directly";SYStem.OPTION WAITRESET OF…
阅读更多...
Python实现免费压缩解压---tarfile模块详解

Python实现免费压缩解压---tarfile模块详解

文章目录 tarfile 压缩模块tarfile的语法格式&#xff08;1&#xff09;打开/创建压缩包&#xff08;2&#xff09;压缩文件&#xff08;3&#xff09;解压文件&#xff08;4&#xff09;追加文件&#xff08;5&#xff09;查看压缩包中的内容 使用with进行改造 tarfile 压缩模…
阅读更多...
SmartX 在保险（2023）：服务 40+ 客户，聚焦信创转型与高性能数据库场景

SmartX 在保险（2023）：服务 40+ 客户，聚焦信创转型与高性能数据库场景

更新内容&#xff1a; 更新 SmartX 超融合在保险行业的覆盖范围与部署规模。更新保险客户超融合应用情况。新增 Nutanix 国产化替代、高性能数据库构建与验证、企业云原生转型等场景实践。更多超融合金融核心生产业务场景实践&#xff0c;欢迎阅读文末电子书。 近两年来&…
阅读更多...
稀疏场景高性能训练方案演变|京东广告算法架构体系最佳实践

稀疏场景高性能训练方案演变|京东广告算法架构体系最佳实践

近年来&#xff0c;推荐场域为提升模型的表达能力和计算能力&#xff0c;模型规模和计算复杂度大幅增加&#xff0c;同时&#xff0c;高规格硬件资源为模型迭代、算法优化带来了更大的机遇和挑战。为了应对模型规模和算力升级带来的存储、IO和计算挑战&#xff0c;京东零售广告…
阅读更多...
网络服务第四次项目（配置dns服务的正反向解析）

网络服务第四次项目（配置dns服务的正反向解析）

目录 实验要求 实验步骤 一、基础配置 1.1、服务端配置静态IP 1.2、客户端配置静态IP 二、配置dns服务的正向解析 2.1、服务端编辑主配置文件named.conf 2.2、服务端编辑主配置文件named.rfc1912.zones 2.3&#xff0c;服务端编辑数据配置文件&#xff0c;使用拷贝…
阅读更多...
结合创新！11种多尺度特征融合方法，附论文和代码

结合创新！11种多尺度特征融合方法，附论文和代码

随着深度学习和计算机视觉技术的快速发展&#xff0c;多尺度特征融合已经成为一个备受关注的、不断探索的研究方向&#xff0c;它通过捕捉不同尺度和层次上的特征信息&#xff0c;提高对图像和视频内容的理解能力&#xff0c;为图像处理、计算机视觉和深度学习等领域的应用提供…
阅读更多...
【基础算法练习】并查集模板

【基础算法练习】并查集模板

文章目录 算法思想代码模板题目描述&#xff1a;代码并查集模板模板题二&#xff08;求并查集内集合的数量&#xff09; 算法思想 并查集的核心操作&#xff1a; 将两个集合合并询问两个元素是否在一个集合中 基本原理&#xff1a;每个集合我们将他维护成一颗树&#xff0c;…
阅读更多...
【安装指南】nodejs下载、安装与配置详细教程

【安装指南】nodejs下载、安装与配置详细教程

目录 &#x1f33c;一、概述 &#x1f340;二、下载node.js &#x1f337;三、安装node.js &#x1f341;四、配置node.js &#x1f33c;一、概述 Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时&#xff0c;用于构建可扩展的网络应用程序。Node.js 使用事件驱动、…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023