gradle tool升级到3.0注意事项小结
Gradle版本升级
其实当AS升级到3.0之后,GradlePlugin和Gradle不升级也是可以继续使用的,但很多新的特性如:Java8支持、新的依赖匹配机制、AAPT2等新功能都无法正常使用。
GradlePlugin升级到3.0.0及以上,修改project/build.gradle文件:
修改global.gradle(自定义lib管理的gradle)
tools=[ gradleTools:'com.android.tools.build:gradle:3.0.1' ]
修改project/build.gradle文件
buildscript{ repositories{ google() } applyfrom:'global.gradle' deftools=rootProject.ext.tools dependencies{ classpathtools.gradleTools } }
Gradle升级到4.1及以上,修改project/gradle/gradle-wrapper.properties文件
distributionUrl=https\://services.gradle.org/distributions/gradle-4.1-all.zip
生成APK文件名属性outputFile变为只读
在appmodule中修改build.gradle文件之前改apk名字的代码
variant.outputs.each{output-> defoutputFile=output.outputFile if(outputFile!=null&&outputFile.name.endsWith('.apk')){ deffileName="host_${variant.buildType.name}_${variant.productFlavors[0].name}_${mApplicationId}_${defaultConfig.versionCode}_v${mVersionName}.apk" output.outputFile=newFile(outputFile.parent,fileName) } }
由于outputFile属性变为只读,需要进行如下修改,直接对outputFileName属性赋值即可:
variant.outputs.all{ outputFileName="host_${variant.buildType.name}_${variant.productFlavors[0].name}_${mApplicationId}_${defaultConfig.versionCode}_v${mVersionName}.apk" }
依赖关键字的改变
- api:对应之前的compile关键字,功能一模一样。会传递依赖,导致gradle编译的时候遍历整颗依赖树
- implementation:对应之前的compile,与api类似,关键区别是不会有依赖传递
- compileOnly:对应之前的provided,依赖仅用于编译期不会打包进最终的apk中
- runtimeOnly:对应之前的'apk',与上面的compileOnly相反
关于implementation与api的区别,主要在依赖是否会传递上。如:A依赖B,B依赖C,若使用api则A可以引用C,而implementation则不能引用。
这里更推荐用implementation,一是不会间接的暴露引用,清晰知道目前项目的依赖情况;二是可以提高编译时依赖树的查找速度,进而提升编译速度。渠道需要声明flavordimensions
刚开始Sync的时候应该会报错:
Error:Allflavorsmustnowbelongtoanamedflavordimension.Learnmoreathttps://d.android.com/r/tools/flavorDimensions-missing-error-message.html
也就是每个flavor渠道都必须归属一个dimension维度,若只有一个维度,渠道中可以不写dimension属性,默认分配到该维度。直接添加一个默认的维度即可,如:flavorDimensions"dimension"
解决方法是在app.gradle添加flavorDimensions
defaultConfig{ flavorDimensionsgetVersion("VERSION_CODE") }
也可以像官方文档那样设置多个维度
//Specifiestwoflavordimensions. flavorDimensions"mode","minApi" productFlavors{ free{ //Assignsthisproductflavortothe"tier"flavordimension.Specifying //thispropertyisoptionalifyouareusingonlyonedimension. dimension"mode" ... } paid{ dimension"mode" ... } minApi23{ dimension"minApi" ... } minApi18{ dimension"minApi" ... } }
库多variant依赖方式的修改
Gradleplugin3.0.0+之后引入了新的variant自动匹配机制,也就是说app的flavorDebug变体会自动匹配library的flavorDebug变体。
回顾一下旧的方式,如果app在某个variant下需要依赖library相应的类型,需要按照下面的方式声明依赖:
dependencies{ hytestCompileproject(path:':main',configuration:'hytestRelease') productionCompileproject(path:':main',configuration:'productionRelease') }
新的方式,gradle会自动感知并匹配对应的variant(前提是app与library中有对应的variant类型):
dependencies{ implementationproject(':main') }
填坑
1、styleattribute‘@android:attr/windowEnterAnimation'notfound.这是aapt2导致的,3.0默认启用了aapt2。解决办法:在project的根目录下的gradle.properties最后添加关闭aapt2的代码:
android.enableAapt2=false
2、gradletool3.0使用最低SDKbuildTool26.0.2的版本
3、使用了aapt的需要去除掉,改用annotationProcessor
总结
以上所述是小编给大家介绍的gradletool升级到3.0注意事项小结,希望对大家有所帮助,如果大家有任何疑问欢迎给我留言,小编会及时恢复大家的!