# 简述
对于使用 AGP8 的 toTransform 的api的各位小伙伴来说都应该接入本框架，或遵循本框架的设计，这将使打包速度显著加快
### 版本限制
版本要求AGP 7.6 以上
## 使用步骤
**在开始之前可以给项目一个Star吗？非常感谢，你的支持是我唯一的动力。欢迎Star和Issues!**
### 1、在 你的插件库的类库中引入
```gradle
dependencies {
implementation 'io.github.FlyJingFish.FastTransform:fast-transform:1.0.5'
}
```
### 2、使用本库
```kotlin
class MyPlugin : Plugin {
override fun apply(project: Project) {
val androidComponents = project.extensions.getByType(AndroidComponentsExtension::class.java)
androidComponents.onVariants { variant ->
val task = project.tasks.register("${variant.name}XXX", MyClassesTask::class.java)
/*
variant.artifacts
.forScope(ScopedArtifacts.Scope.ALL)
.use(taskProvider)
.toTransform(
ScopedArtifact.CLASSES,
MyTask::allJars,
MyTask::allDirectories,
MyTask::outputFile
)
*/
variant.toTransformAll(task) //等价于上边的写法
// variant.toTransformAll(task,false) 第二个参数传入 false 就代表使用原本未加速的逻辑
}
}
}
//继承 DefaultTransformTask
abstract class MyClassesTask : DefaultTransformTask() {
// 相当于以前被 @TaskAction 注解的方法
override fun startTask() {
/**
* singleClassesJar() 是否只有一个jar包，返回true代表之前有一个使用 toTransform 的插件，而且他没有使用本插件或没有遵循本设计
*/
/**
* isFastDex 是调用 toTransformAll 传入的第二个参数
*/
allDirectories().forEach { directory ->
directory.walk().forEach { file ->
if (file.isFile) {
val relativePath = file.getRelativePath(directory)
val jarEntryName: String = relativePath.toClassPath()
FileInputStream(file).use { inputs ->
val cr = ClassReader(inputs)
val cw = ClassWriter(cr,0)
cr.accept(
MyClassVisitor(cw),
ClassReader.EXPAND_FRAMES
)
cw.toByteArray().inputStream().use {
//写入jar
directory.saveJarEntry(jarEntryName,it)
}
}
}
}
}
allJars().forEach { file ->
if (file.absolutePath in ignoreJar){
return@forEach
}
val jarFile = JarFile(file)
val enumeration = jarFile.entries()
while (enumeration.hasMoreElements()) {
val jarEntry = enumeration.nextElement()
val entryName = jarEntry.name
if (jarEntry.isDirectory || entryName.isEmpty() || entryName.startsWith("META-INF/") || "module-info.class" == entryName || !entryName.endsWith(".class")) {
continue
}
jarFile.getInputStream(jarEntry).use { inputs ->
val cr = ClassReader(inputs)
val cw = ClassWriter(cr,0)
cr.accept(
MyClassVisitor(cw),
ClassReader.EXPAND_FRAMES
)
cw.toByteArray().inputStream().use {
//写入jar
file.saveJarEntry(jarEntryName,it)
}
}
}
jarFile.close()
}
}
override fun endTask() {
//在此写一些结束性工作
}
}
```
## 直接加速现有项目
你现有的项目存在使用 `toTransform` 的插件，而它没有使用本框架或遵循本框架的设计，则可以选择下边一种方式去加速你的项目
### 方式一
在 **项目根目录** 的 `build.gradle` 里依赖插件
- 新版本
```gradle
plugins {
//必须项 👇 注意 apply 设置必须为 true
id "io.github.FlyJingFish.FastTransform" version "1.0.5" apply true
}
```
- 或者老版本
```gradle
buildscript {
dependencies {
//必须项 👇
classpath 'io.github.FlyJingFish.FastTransform:fast-transform:1.0.5'
}
}
apply plugin: "fast.dex"
```
### 方式二
在 **app 所在module** 的 `build.gradle` 里依赖插件
```gradle
//必须项 👇
plugins {
...
id "io.github.FlyJingFish.FastTransform" version "1.0.5"
}
```
### 最后推荐我写的另外一些库
- [AndroidAOP 帮助 Android App 改造成AOP架构的框架，只需一个注解就可以请求权限、切换线程、禁止多点、一次监测所有点击事件、监测生命周期等等](https://github.com/FlyJingFish/AndroidAOP)
- [OpenImage 轻松实现在应用内点击小图查看大图的动画放大效果](https://github.com/FlyJingFish/OpenImage)
- [ShapeImageView 支持显示任意图形，只有你想不到没有它做不到](https://github.com/FlyJingFish/ShapeImageView)
- [GraphicsDrawable 支持显示任意图形，但更轻量](https://github.com/FlyJingFish/GraphicsDrawable)
- [ModuleCommunication 解决模块间的通信需求，更有方便的router功能](https://github.com/FlyJingFish/ModuleCommunication)
- [FormatTextViewLib 支持部分文本设置加粗、斜体、大小、下划线、删除线，下划线支持自定义距离、颜色、线的宽度；支持添加网络或本地图片](https://github.com/FlyJingFish/FormatTextViewLib)
- [主页查看更多开源库](https://github.com/FlyJingFish)