项目Gradle版本从4.4升级到4.6
1、背景
Gralde版本与AGP（Android Gradle Plugin）版本具备必定的对应关系，缘由在于AGP实质上做为Gradle的插件，依赖于Gradle做为宿主。所以，不一样的AGP版本须要与相应的Gralde版本相匹配。他们之间版本的对应关系以下：java
具体能够参照官方文档：
developer.android.com/studio/rele…android
当前项目中使用Gradle版本是4.4，AGP版本是3.1.0。为遵循渐进式策略，本次升级，目标是将Gralde版本升级到4.6，与之对应的，AGP升级到3.2.1。git
主要考虑点：
1，渐进式升级，只从4.4升级到4.6，兼顾版本升级的同时，确保项目稳定性；
2，升级Gralde及AGP版本，有利于项目构建速度提高；
3，为不久后的升级到AndroidX作准备。github
2、主要问题及解决
鉴于以往的感觉：每次升级都不只仅是单纯的改一下版本号那么简单，每次升级也都会遇到一些问题须要处理。
一样的，这次升级，仍是遇到了一些问题，主要记录以下：api
2.1 项目自定义插件中的方法签名问题
1，问题：
修改gradle-wrapper.properties中Gradle版本，从4.4改为4.6bash
....
distributionUrl=https\://services.gradle.org/distributions/gradle-4.6-all.zip
复制代码
修改项目根目录下的build.gradle文件，将AGP从3.1.升级到3.2.1。app
dependencies {
classpath 'com.android.tools.build:gradle:3.2.1'
....
....
}
复制代码
项目构建，发现出现以下错误：ide
App:cornProdReleaseMultidexKeep (Thread[Task worker for ':' Thread 4,5,main]) started.
:App:cornProdReleaseMultidexKeep
Caching disabled for task ':App:cornProdReleaseMultidexKeep': Caching has not been enabled for the task
Task ':App:cornProdReleaseMultidexKeep' is not up-to-date because:
Task has not declared any outputs.
try to update manifest_keep.txt
can't find getManifestKeepListFile method, exception:groovy.lang.MissingMethodException: No signature of method: com.android.build.gradle.internal.scope.VariantScopeImpl.getManifestKeepListFile() is applicable for argument types: () values: [] :App:cornProdReleaseMultidexKeep FAILED :App:cornProdReleaseMultidexKeep (Thread[Task worker for ':' Thread 4,5,main]) completed. Took 0.071 secs. 复制代码
依据错误信息，是执行:App:cornProdReleaseMultidexKeeptask时，有调用到getManifestKeepListFile方法，因AGP版本升级，此处并无作好对应的向历史兼容，直接报错。
工具
2，解决：
当前项目分包直接采用Google官方multidex方案。经查，此处是项目团队自定义的插件，并提供了对外的配置项。目的是仿照tinker写法，在分包时将对应的maindex配置项经过追加到manifest_keep.txt中，以保留到对应的maindexlist.txt，从而对应的类会被打包到maindex中，5.0如下机型不至于出现ClassNotFoundException相关的错误。插件中将对应任务hook到了multidex对应的task环节，至关于完成了额外的maindex配置。开发工具
主体实现逻辑以下：
OptMainDexTask.groovy
@TaskAction
def doAction() {
def ext = project.extensions.findByName(OptMainDexExtension.NAME) as OptMainDexExtension
if (!ext.enable) {
project.logger.error("optMainDex enable set false!")
return
}
project.logger.error("try to update manifest_keep.txt")
StringBuffer lines = new StringBuffer()
lines.append("#optMainDex.loader patterns here\n")
Iterable<String> loader = ext.loader
for (String pattern : loader) {
if (pattern.endsWith("*")) {
if (!pattern.endsWith("**")) {
pattern += "*"
}
}
lines.append("-keep class " + pattern + " {\n" +
" <init>(...);\n" +
"}\n")
.append("\n")
}
File multiDexKeepProguard = null
try {
multiDexKeepProguard = applicationVariant.getVariantData().getScope().getManifestKeepListProguardFile()
} catch (Throwable ignore) {
try {
multiDexKeepProguard = applicationVariant.getVariantData().getScope().getManifestKeepListFile()
} catch (Throwable e) {
project.logger.error("can't find getManifestKeepListFile method, exception:${e}")
}
}
if (multiDexKeepProguard == null) {
project.logger.error("auto add multidex keep pattern fail, you can only copy ${file} to your own multiDex keep proguard file yourself.")
return
}
FileWriter manifestWriter = new FileWriter(multiDexKeepProguard, true)
try {
for (String line : lines) {
manifestWriter.write(line)
}
} finally {
manifestWriter.close()
}
}
复制代码
cornPlugin.groovy
@Override
void apply(Project project) {
...
initDex(project)
...
}
def initDex(Project project) {
// 只支持Gradle 3.0以上
project.extensions.create(OptMainDexExtension.NAME, OptMainDexExtension)
def android = project.extensions.android
project.afterEvaluate {
OptMainDexExtension optMainDexExtension = project.extensions.getByName(OptMainDexExtension.NAME)
if (!optMainDexExtension.enable) {
return
}
android.applicationVariants.all { variant ->
def variantOutput = variant.outputs.first()
def variantName = variant.name.capitalize()
def variantData = variant.variantData
boolean multiDexEnabled = variantData.variantConfiguration.isMultiDexEnabled()
if (multiDexEnabled) {
OptMainDexTask dexConfigTask = project.tasks.create("corn${variantName}MultidexKeep", OptMainDexTask)
dexConfigTask.applicationVariant = variant
// for java.io.FileNotFoundException: app/build/intermediates/multi-dex/release/manifest_keep.txt
// for gradle 3.x gen manifest_keep move to processResources task
dexConfigTask.mustRunAfter variantOutput.processResources
def multidexTask = TaskUtil.getMultiDexTask(project, variantName)
if (multidexTask != null) {
multidexTask.dependsOn dexConfigTask
}
def collectMultiDexComponentsTask = TaskUtil.getCollectMultiDexComponentsTask(project, variantName)
if (collectMultiDexComponentsTask != null) {
dexConfigTask.mustRunAfter collectMultiDexComponentsTask
}
}
}
}
}
复制代码
OptMainDexTask中，是仿照以前tinker的写法，如今tinker的新版本中，此处也已经通过了修改，由于tinker也将AGP版本升级到了3.2.1，并支持了更高版本的使用。
developer.android.com/studio/buil…
参照multidex官方文档，实际上针对maindex的配置，是不必从插件中绕一道的，直接经过multiDexKeepFile或multiDexKeepProguard在主工程中配置便可。
对应的，删除项目团队本身的插件中的maindex此处逻辑，升级插件版本，主工程从新引入，去掉主工程对应的配置，并将须要保留在maindex的配置对应的配置好在multiDexKeepProguard文件中，并引入。
defaultConfig {
....
....
multiDexEnabled true
multiDexKeepProguard file('multidex-config.pro')
....
....
}
复制代码
2.2 资源混淆工具AndResGuard异常
1，问题：
从新构建，出现以下错误信息：
parse to get the exist names in the resouces.arsc first
com.tencent.mm.androlib.AndrolibException: Could not decode arsc file
at com.tencent.mm.androlib.res.decoder.RawARSCDecoder.decode(RawARSCDecoder.java:74)
at com.tencent.mm.androlib.ApkDecoder.decode(ApkDecoder.java:190)
at com.tencent.mm.resourceproguard.Main.decodeResource(Main.java:96)
....
复制代码
对应搜索，发现AndResGuard GitHub上也有很多人反馈，如对应issues： github.com/shwenzhang/…
2，解决：
缘由在于升级后，系统默认升级了buildToolsVersion版本到28.0.3。从而致使对资源的解码出现问题。项目当前buildToolsVersion版本为27.0.3，直接去除，采用AGP对应的默认buildToolsVersion版本配置。
同时，AndResGuard最新版本已经解决了此问题，直接升级版本到当前最新版本。
....
classpath 'com.tencent.mm:AndResGuard-gradle-plugin:1.2.17'
....
复制代码
再次构建，构建成功。
核验maindex分包相关的manifest_keep.txt和maindexlist.txt，与预期相符。在5.0如下手机上安装测试，能够正常运行。
3、结语
Gradle升级到4.6，AGP相应升级到3.2.1，主要的更新点：
1，buildToolsVersion开始采起默认版本策略，AGP会按照其自身版本对应配置buildToolsVersion版本，即便因特别须要，人为也能够去指定buildToolsVersion版本，但版本范围仍是须要与AGP版本对应。
2，开始对迁移到AndroidX提供官方的直接支持。Google已经将android.*替换成androidx.*，并将再也不更新维护原来的扩展库，所以，尽早将项目的扩展库迁移成AndroidX形式，也是必要的。
3，D8中的Desugaring（脱糖）默认开启，为进一步使用Java8提供了支持。
4，新的代码混淆工具，R8，以取代原有的ProGuard工具，当前默认未开启，能够经过配置开启。
android.enableR8 = true
复制代码
Andorid项目开发中，涉及到各类版本的概念。项目不断迭代的同时，官方开发工具、对应配套环境、工具库、扩展库等，也在不断更新。为持续拥有更好的开发体验、编译速度和新功能支持，须要不断的适时升级相应版本。