Android开发升级AGP7.0后的一些适配方法技巧
作者：究极逮虾户
升级
年初了，我们打算升级下apg，这样之后就拥抱下jetpack compose了！！
想用comopse有两个必选项agp7.0和kotlin版本1.5.31.
Java11配置
因为apg7.0需要把所有的module编译环境切换到java11版本上，然而这个地方很容易出错。
首先是命令行的配置，对于mac用户来说，可能会写死默认的java环境到1.8. 这个时候我们需要做的就是删除bashprofile内的java配置。
同时最好用命令行java --version尝试下输出的版本是不是java11。
as的配置则相对来说比较简单了。
按照这两个配置完成之后重新同步下工程应该就行了。
AndroidComponentsExtension
之前在现在准备好告别Transform了吗？的文章就简单展开了下AndroidComponentsExtension，新版本更换了extensions。这次给项目升级适配之前写的哪些插件，想了想用新不用久吗，尝试下新东西了。
onVariants
以前在写android插件的时候很多时候都需要在gralde的afterEvaluate方法执行之后才能获取到很多安卓对应的属性。
这次在v2的api中，则提供了非常多不同的节点，让我们在不同的阶段做一些不同的事情。
比如说onVariants,beforeVariants,finalizeDsl这三个不同的阶段，正常情况下我们选择onVariants就足够了。
Component Artifacts
Gralde 内的一部分核心是Task，但是要想写好一个Task其实并没有想象中的那么容易。特别是一个CacheableTask,他更多的关注与他们的输入和输出。
构建缓存(build cache)的工作原理是：在缓存中存储已编译的类、测试输出和其他构建构件，同时考虑所有的任务输入，包括输入文件内容、相关类路径和任务配置。
所以在AGP 7.0中，提供了这部分新的api让我们简化对于task，输入输出这些参数的优化，让我们可以更专注到我们想要变更的东西上。
比如说APk,MANIFEST,MAPPING_FILE,BUNDLE,AAR或者其他的一些编译产物，当前agp给我们提供的也是相对来说比较少的一部分功能。
另外一点就是，我们如果想要知道一个task的输入其实如果不去阅读源码，之后获取对应的路径或者源代码，其实是一个非常繁琐的过程。之后还要通过变更dependon或者finalizedBy等等手段将任务插入到编译流程内。
所以就有了我们这次的其中一个主角Artifacts,他主要负责帮助我们将我们的task，插入到编译流程内，让我们尽量少的关注到输入和输出。
// 生成TaskProvider
val taskProvider = project.tasks.register(
"manifestCopy${variant.name}Task",
ManifestSampleTask::class.java
)
// 获取variant的artifacts之后将Task转化成我们所想要的
variant.artifacts.use(taskProvider).wiredWithFiles(
ManifestSampleTask::mergedManifest,
ManifestSampleTask::outputManifest
).toTransform(SingleArtifact.MERGED_MANIFEST)
这个就是官方的一个Artifacts的简单的使用了，通过变化我们可以轻松的完成一个有获取合并后的Manifest作为输入，之后以另外一个Manifest文件作为输出的一个task。而且会被直接添加编译流程内，就不需要我们关心他们的前置和后置任务是啥了。
registerJavaGenerateTask 没了
原先在v1的api上吧，有registerJavaGenerateTask这个方法，能加一些简单的代码生成的操作，比如j神以前生成的R2就是通过挂载这个方法。
这次v2版本我在AndroidComponentsExtension中没找到的对应的api，所以只能无中生友，自己搞一个出来咯。
@Override
public void registerJavaGeneratingTask(@NonNull Task task, @NonNull File... sourceFolders) {
getVariantData().registerJavaGeneratingTask(task, sourceFolders);
}
open fun registerJavaGeneratingTask(
task: Task,
generatedSourceFolders: Collection<File>
) {
@Suppress("DEPRECATION")
taskContainer.sourceGenTask.dependsOn(task)
val fileTrees = extraGeneratedSourceFileTrees ?: mutableListOf<ConfigurableFileTree>().also {
extraGeneratedSourceFileTrees = it
}
for (f in generatedSourceFolders) {
val fileTree = services.fileTree(f).builtBy(task)
fileTrees.add(fileTree)
}
addJavaSourceFoldersToModel(generatedSourceFolders)
}
我仔细观察了下registerJavaGenerateTask的源代码，发现其中只做了两件比较简单的事情。将Task挂载到generateVariantResources任务之后，然后将生成java类的文件夹加入到sourcetSet上去，这样就行了。
sourcetSet就是javac的将java转化成class的编译路径。
所以相对来说就比较简单，我们用新的api模拟出原来的效果就差不多可以了，我们只要找到挂载的任务之后，顺便把代码添加到java和kotlin的sourceset中就行了
fun Project.registerJavaGenerateTask(
variant: String?,
task: TaskProvider<out Task>,
generatedSourceFolders: Collection<File>
) {
if (variant.isNullOrEmpty().not()) {
variant?.apply {
// 因为task生成在配置阶段完成之后
afterEvaluate {
findJavaGenerateTask(variant)?.dependsOn(task)
}
// 获取最新版本sourceSet
val application = extensions.findByType(ApplicationExtension::class.java)
application?.sourceSets {
findByName(variant)?.apply {
generatedSourceFolders.forEach {
java.srcDir(it)
kotlin.srcDir(it)
}
}
}
}
}
}
这次升级适配主要的代码就是这个了，其实代码量上来说不多。但是把有个坑点，之前因为偷懒就直接用了setSrcDirs这个api，所以文件就被覆盖了。导致了一部分代码没有被编译成class，导致了classnotfound异常。
其他
获取applicationId,我们的插件内有对于应用id的判断，之后进行不同的manifest pleaceholder的调整。逻辑比较简单，只是切换了新版本的api而已。
if (variant is ApplicationVariant) {
val applicationId = variant.applicationId.get()
variant.manifestPlaceholders.put("xxxxx", applicationId)
}
对resValue插入新的string或者values。也是原来就有的能力，但是要对新版本进行一次小小的适配和更换。
private fun addAPGClassFile(config: Variant, key: String, value: String) {
val resValue = ResValue(value)
val reskey = config.makeResValueKey("string", key)
config.resValues.put(reskey, resValue)
}
启动configuration cache
启用配置缓存的操作，本质上是在项目的 gradle.properties 文件中设置了环境变量 org.gradle.unsafe.configuration-cache=true。
结尾
AGP对我们这个算是每年一更新了，会碰到一些新的有趣的api以及新的写法。另外每次新版本的AGP对于编译上都有变更和优化，更多关于AGP7.0升级适配的资料请关注脚本之家其它相关文章！