国通快速免费建站跨平台软件开发工具

Public Artifact

支持的组件输出、输入类型

• FILE：文件
• DIRECTORY：目录

SingleArtifact

支持的转换类型：（列举几个常用的）

• APK：安装包路径
• MERGED_MANIFEST：Manifest 文件
• OBFUSCATION_MAPPING_FILE：mapping.txt 文件
• AAR：aar 包
• ASSETS：assets 文件
• MERGED_NATIVE_LIBS：so 库文件

1. 立刻终止构建

AGP7+

之前我是这样直接抛出异常，还是比较快终止构建，到 AGP8 之后发现不行了，默认开启即使抛出异常也会继续执行剩下的 Task

class ExceptionHelper {companion object {@JvmStaticfun throwExecution(msg: String) {throw GradleException(msg)System.exit(-1)}}
}

AGP8+

可以在插件初始化时设置

//抛出异常时立刻停止构建，其实 AGP 低版本也有这个
project.gradle.startParameter.isContinueOnFailure = false

2. Manifest 合并

AGP+7

• 获取所有 Task project.tasks.findAll().iterator()
• 遍历、判断 Task name，拿到特定任务（如 processReleaseManifest、mergeReleaseAssets）
• 为特定 Task 添加前后执行逻辑（设置 doFirst 、doLast）

project.afterEvaluate {expendTask()
}private List expendTask() {Iterator<Task> eIterator = project.tasks.findAll().iterator()while (eIterator.hasNext()) {Task theTask = eIterator.next()switch (CommUtils.judgeTaskType(theTask.name)) {case TaskType.TASK_PROCESS_RELEASE_MANIFEST:theTask.doLast {}break}}
}

AGP8+

• 指定输入：@get:InputFile
• 指定输出：@get:OutputFile（一定要输出，否则下一个 Transform 没有输入）
• 指定 SingleArtifact：SingleArtifact.MERGED_MANIFEST

private fun registerTransform(project: Project) {val androidExt = project.extensions.getByType(AndroidComponentsExtension::class.java)androidExt.onVariants { variant ->//处理 manifest 文件val manifestUpdater = project.tasks.register(variant.name + "ManifestTransformerTask", ManifestTransformerTask::class.java) {}variant.artifacts.use(manifestUpdater).wiredWithFiles(ManifestTransformerTask::mergedManifest,ManifestTransformerTask::updatedManifest).toTransform(SingleArtifact.MERGED_MANIFEST)}
}

abstract class ManifestTransformerTask : DefaultTask() {@get:InputFile@get:PathSensitive(PathSensitivity.NONE)abstract val mergedManifest: RegularFileProperty@get:OutputFileabstract val updatedManifest: RegularFileProperty@TaskActionfun taskAction() {println("ManifestTransformerTask run")var manifest = mergedManifest.asFile.get().readText()//todo：解析 manifest  并做相应修改或查找，最后输出更新updatedManifest.get().asFile.writeText(manifest)}
}

3. Assets 合并

AGP7+

project.afterEvaluate {expendTask()
}private List expendTask() {Iterator<Task> eIterator = project.tasks.findAll().iterator()while (eIterator.hasNext()) {Task theTask = eIterator.next()switch (CommUtils.judgeTaskType(theTask.name)) {case TaskType.TASK_MERGE_RELEASE_ASSETS:theTask.doLast {}break}}
}

AGP8+

• 指定输入：@get:inputDir
• 指定输出：@get:outputDir（一定要输出，否则下一个 Transform 没有输入）
• 指定 SingleArtifact：SingleArtifact.ASSETS

private fun registerTransform(project: Project) {project.plugins.withType(AppPlugin::class.java) {val appExt =project.extensions.getByType(ApplicationAndroidComponentsExtension::class.java)appExt.onVariants { variant ->//assets mergeval assetsTaskProvider =project.tasks.register(variant.name + ConstantStr.PREFIX_TRANSFORM + "AssetsTransformerTask",AssetsTransformerTask::class.java)variant.artifacts.use(assetsTaskProvider).wiredWithDirectories(AssetsTransformerTask::inputDir,AssetsTransformerTask::outputDir).toTransform(SingleArtifact.ASSETS)}}
}

注意点：

• transform 前清空输出目录：PluginFileUtils.deleteFolder(outFileDir)
• assets 路径变更：
  • AGP6+：build\intermediates\merged_assets
  • AGP7+、8+：build\intermediates\assets\release\mergeReleaseAssets

abstract class AssetsTransformerTask : DefaultTask() {@get:InputDirectoryabstract val inputDir: DirectoryProperty@get:OutputDirectoryabstract val outputDir: DirectoryProperty@TaskActionfun taskAction() {val outFileDir = outputDir.asFile.get()if (outFileDir.exists()) {//否则报错：文件已存在（不 clean build 目录情况下）CmdColorPrintUtils.outputYellow("重新打包前需要先清空目录：\n\t ${outFileDir.absolutePath}")PluginFileUtils.deleteFolder(outFileDir)}// We must copy the contents of the input directory to the output directory before our transformationinputDir.get().asFile.copyRecursively(outputDir.get().asFile)println("AssetsTransformerTask outputDir: ${outputDir.asFile.get().absolutePath}")outputDir.asFileTree.forEach {println("AssetsTransformerTask output =${it.absolutePath}")}}
}

如果注册了 assets Transform，那么 assets 输出目录下会有多个目录：

• mergeReleaseAssets：系统默认名称
• 其他自定义名称：例如我插件的 releaseDnAssetsTransformerTask

// 其他待完善