AGP Transform Optimization

TL;DR: 本文主要介绍 android build 中 transform 阶段的开箱即用的增量编译优化方案，相比于原生的 Transform，这套方案主要是通过"尽可能"在增量中编译最少的代码、处理最小范围的变动，来达到增量编译优化的目的。

概述

Transform 基本介绍

android.registerTransform(new CustomTransform())

class TestTransform: Transform() {
    override fun transform(transformInvocation: TransformInvocation) {
        val input = transformInvocation.getInputs() // 拿到本次的 inputs
    }
}

1. JarInput：表示编译中的所有的 jar 文件，一般是各种二方库、三方库、子 module 的 jar，JarInput 可以分为四种状态 Changed/Added/Removed/Not Changed。

2. DirectoryInput：表示编译中所有的文件夹，一般是 app module 中的 class，以及其它的资源等，directory 本身没有状态，但是它有一个 changedFiles 的字段，里面是个 map，这个 map 表示了文件和状态的映射。

存在的问题

Output 命名问题

if (format == Format.DIRECTORY) {
    return Integer.toString(index);
}

return Integer.toString(index) + DOT_JAR;

if (format == Format.DIRECTORY) {
    return getRealName(name);
} else {
    return getRealName(name) + DOT_JAR;
}

private String getRealName(String name) {
    if (!name.contains("/")) return name.replace(".jar", "");
    else return name.substring(name.lastIndexOf("/") + 1).replace(".jar", "");
}

切仓重编问题

/**
 * Version of TransformStream handling input that is not generated by transforms.
 */
public class OriginalStream extends TransformStream;

/**
 * Version of TransformStream handling outputs of transforms.
 */
class IntermediateStream extends TransformStream

• OriginalStream: 传给第一个 transform 的是 OriginalStream，它没有被其它 transform 处理过，是 AGP 生成出来的。

• IntermediateStream: 它的 input 是其它的 transform 的 output，处理的是二手文件。

1. a.jar NotChanged

2. b.jar Removed

3. c.jar NotChanged

1. a.jar NotChanged

2. c.jar NotChanged

3. b.jar Removed

Jar2Dir 优化

• JarInput

• DirectoryInput

• 对于新增的 jar，我们返回一个 DirectoryInput，里面所有的 class 的状态都是 ADDED

• 对于删除的 jar，我们返回一个 DirectoryInput，里面所有的 class 状态都是 REMOVED

• 对于改动的 jar，我们返回一个 DirectoryInput，将解压后的文件和原来的文件进行对比，返回发生了变动的 class。

效果

写在最后