在介紹下面的流程之前，先明確幾個概念，flavor，dimension，variant。

在 android gradle plugin 3.x 之後，每個 flavor 必須對應一個 dimension，可以理解為 flavor 的分組，然後不同 dimension 里的 flavor 組合成一個 variant。

舉個例子：

flavorDimensions "size", "color"

productFlavors {
big {
dimension "size"
}
small {
dimension "size"
}
blue {
dimension "color"
}
red {
dimension "color"
}
}

上面配置對應生成的 variant 就是 bigBlue，bigRed，smallBlue，smallRed，在這個基礎上，再加上 buildTypes，就是 bigBlueDebug，bigRedDebug，smallBlueDebug，smallRedDebug，bigBlueRelease，bigRedRelease，smallBlueRelease，smallRedRelease。

createAndroidTasks 的調用時機和上面不一樣，是在 project.afterEvaluate 里調用的，還記得之前文章里說道的 afterEvaluate 回調么？這個時候所有模塊配置已經完成了。所以在這個階段可以獲取到對應的 flavor 以及其他配置了。

// 創建 flavor 和 dimension 的組合
List<ProductFlavorCombo<CoreProductFlavor>> flavorComboList =
ProductFlavorCombo.createCombinations(
flavorDimensionList,
flavorDsl);
// 為每個組合創建 VariantData
for (ProductFlavorCombo<CoreProductFlavor> flavorCombo : flavorComboList) {
//noinspection unchecked
createVariantDataForProductFlavors(
(List<ProductFlavor>) (List) flavorCombo.getFlavorList());
}

創建出來的 VariantData 都是 BaseVariantData 的子類，裡面保存了一些 Task，可以看一下 BaseVariantData 里的一些重要的結構，對 BaseVariantData 有個大概的了解。

public abstract class BaseVariantData implements TaskContainer {
private final GradleVariantConfiguration variantConfiguration;
private VariantDependencies variantDependency;
private final VariantScope scope;
public Task preBuildTask;
public Task sourceGenTask;
public Task resourceGenTask; // 資源處理
public Task assetGenTask;
public CheckManifest checkManifestTask; // 檢測manifest
public AndroidTask<PackageSplitRes> packageSplitResourcesTask; // 打包資源
public AndroidTask<PackageSplitAbi> packageSplitAbiTask;
public RenderscriptCompile renderscriptCompileTask;
public MergeResources mergeResourcesTask; // 合併資源
public ManifestProcessorTask processManifest; // 處理 manifest
public MergeSourceSetFolders mergeAssetsTask; // 合併 assets
public GenerateBuildConfig generateBuildConfigTask; // 生成 BuildConfig
public GenerateResValues generateResValuesTask;
public Sync processJavaResourcesTask;
public NdkCompile ndkCompileTask; // ndk 編譯
public JavaCompile javacTask;
public Task compileTask;
public Task javaCompilerTask; // java 文件編譯
// ...
}

VariantData 里保存了很多 task，下一步就要創建這些 task。

2.createTasksForVariantData

VariantManager.createAssembleTaskForVariantData() // 創建 assembleXXXTask
TaskManager.createTasksForVariantScope() // 是一個抽象類，具體實現在 ApplicationTaskManager.createTasksForVariantScope()
TaskManager.createPostCompilationTasks() // 創建 .class to dex 的 task， 創建 transformTask，我們創建的 transform 就是這個階段添加進來的，是在 addCompileTask 里調用的

// createTasksForVariantScope 是一個抽象方法，具體實現在子類中，可以看一下 ApplicationTaskManager.createTasksForVariantScope()
// createTasksForVariantScope 里的實現，如果在業務中有需要查看相關 task 源碼時，可以來這裡找
void createTasksForVariantScope() {
this.createCheckManifestTask(tasks, variantScope); // 檢測 manifest
this.handleMicroApp(tasks, variantScope);
this.createDependencyStreams(tasks, variantScope);
this.createApplicationIdWriterTask(tasks, variantScope); // application id
this.createMergeApkManifestsTask(tasks, variantScope); // 合併 manifest
this.createGenerateResValuesTask(tasks, variantScope);
this.createRenderscriptTask(tasks, variantScope);
this.createMergeResourcesTask(tasks, variantScope, true); // 合併資源文件
this.createMergeAssetsTask(tasks, variantScope, (BiConsumer)null); // 合併 assets
this.createBuildConfigTask(tasks, variantScope); // 生成 BuildConfig
this.createApkProcessResTask(tasks, variantScope); // 處理資源
this.createProcessJavaResTask(tasks, variantScope);
this.createAidlTask(tasks, variantScope); // 處理 aidl
this.createShaderTask(tasks, variantScope);
this.createNdkTasks(tasks, variantScope); // 處理 ndk
this.createExternalNativeBuildJsonGenerators(variantScope);
this.createExternalNativeBuildTasks(tasks, variantScope);
this.createMergeJniLibFoldersTasks(tasks, variantScope); // 合併 jni
this.createDataBindingTasksIfNecessary(tasks, variantScope); // 處理 databinding
this.addCompileTask(tasks, variantScope);
createStripNativeLibraryTask(tasks, variantScope);
this.createSplitTasks(tasks, variantScope);
this.createPackagingTask(tasks, variantScope, buildInfoWriterTask); // 打包 apk
this.createLintTasks(tasks, variantScope); // lint
}

// createPostCompilationTasks 實現:
// 處理 Android Transform
void createPostCompilationTasks() {
for (int i = 0, count = customTransforms.size(); i < count; i++) {
Transform transform = customTransforms.get(i);
// TransformManager.addTransform 實際上是為 transform 創建了一個 Task
transformManager
.addTransform(tasks, variantScope, transform)
.ifPresent(t -> {
if (!deps.isEmpty()) {
t.dependsOn(tasks, deps);
}
// if the task is a no-op then we make assemble task depend on it.
if (transform.getScopes().isEmpty()) {
variantScope.getAssembleTask().dependsOn(tasks, t);
}
});
}
}

六、總結

android gradle plugin 的主要流程基本上就結束了，主要流程圖如下所示

這裡總結幾個要點:

1. com.android.application 入口類是 AppPlugin，但大部分工作都是在 BasePlugin 里完成的
2. build.gradle 里見到的 android {} dsl 是在 BasePlugin.configureExtension() 里聲明的
3. 主要的 task 是在 BasePlugin.createAndroidTasks() 里生成的
4. 主要 task 的實現可以在 TaskManager 中找到
5. transform 會轉化成 TransformTask

【Android 修鍊手冊】系列內容 每周五更新

歡迎關注下面賬號，獲取更新：

微信搜索公眾號: ZYLAB

知乎

推薦閱讀：