因为之前的习惯,每天早上会准时打开微信,点开订阅去找鸿洋和郭神及其他关注订阅号推荐的文章去看,才能让我在每天忙碌的生活中,提高自己顺便了解一下外面的世界和技术的走向。
切入主题,这次是看到了郭神推荐的文章,想起了自己之前一直想总结的Gradle知识,现在总结好,分享给大家(实用篇):
一. Gradle模块化配置
1.defaultConfig默认设置
在项目根目录新建config.gradle文件,如下:
之后在 app路径下的 build.gradle中获取并使用:
def cfg = rootProject.ext.android
defaultConfig {
applicationId "applicationId"
minSdkVersion cfg.minSdkVersion
targetSdkVersion cfg.targetSdkVersion
versionName cfg.versionName
versionCode cfg.versionCode
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
multiDexEnabled true
}
这种方式能够将我们的gradle统一进行管理。
注:config.gradle文件中的versionName和versionCode我是放在了项目中gradle.properties文件中来管理,用来记录版本发版时间和版本简要注释,如下图:
2.url地址优化
按照config的配置,一般来讲,我们开发的时候至少会有两个服务器地址,正式跟测试,你每切换一次,都需要重新同步一下,还有就是,多人协作开发的时候,每次从Git服务器上面更新代码,只要更新到app目录下的gradle,都是需要重新同步的,参照config的配置,我们如果是引用的话就每次只需要读取引用的那个url,切换只需要修改config中的代码就可以了,下面是进行的优化:
url = [
"debug" : "debugUrl1",
//"debug" : "debugUrl2",
//"debug" : "debugUrl3",
"release": "releaseUrl1",
// "release": "releaseUrl2"
]
在app路径下的build.gradle中获取并使用:
def url = rootProject.ext.url
buildTypes {
release {
minifyEnabled true
shrinkResources true
buildConfigField "String", "AlphaUrl", "\"${url["release"]}\""
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
signingConfig signingConfigs.config
}
debug {
minifyEnabled true
shrinkResources true
debuggable true
buildConfigField "String", "AlphaUrl", "\"${url["debug"]}\""
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
signingConfig signingConfigs.config
}
}
这样的话,在打包的时候直接选择就好了,release/debug;直接在真机或者模拟器上运行的话为debug版本。
3.第三方开源库和组件版本号的管理
在config中添加:
libsVersion = [
// 第三方库版本号的管理
supportLibraryVersion = "26.1.0",
constraintlayout = "1.0.2",
recyclerview = "26.1.0",
cardview = "26.1.0",
butterknife = "8.8.1",
]
// 依赖库管理 compile "com.facebook.react:react-native:+"
dependencies = [
"appcompatV7" : "com.android.support:appcompat-v7:$rootProject.supportLibraryVersion",
"cardview" : "com.android.support:cardview-v7:$rootProject.cardview",
"recycleview" : "com.android.support:recyclerview-v7:$rootProject.recyclerview",
"constraintlayout": "com.android.support.constraint:constraint-layout:$rootProject.constraintlayout",
"butterknife" : "com.jakewharton:butterknife:$rootProject.butterknife",
]
在app路径下的build.gradle中获取并使用:
def librarys = rootProject.ext.dependencies
dependencies {
implementation fileTree(include: ['*.jar'], dir: 'libs')
testImplementation 'junit:junit:4.12'
androidTestImplementation 'com.android.support.test:runner:1.0.1'
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.1'
annotationProcessor 'com.jakewharton:butterknife-compiler:8.8.1'
debugCompile 'com.squareup.leakcanary:leakcanary-android:1.5.4'
releaseCompile 'com.squareup.leakcanary:leakcanary-android-no-op:1.5.4'
//实际上librarys就是一个Map,我们可以写一个循环来简化这些代码,就跟HashMap的遍历一样,这里我只挑选了compile :
librarys.each { k, v -> compile v }
}
二. 多渠道打包
1.让签名信息安全
在项目根目录的keystore.properties文件中设置好key密钥和路径,这个文件是存在本地的(如果没有这个文件,就新建)。
之后在 build.gradle文件中设置签名文件信息,如图:
首先获取到签名文件
然后设置签名信息
当然,这一步也可以不设置,直接在 build.gradle文件中添加签名信息:
2.多渠道打包配置:productFlavors 用法
productFlavors顾名思义,就是用来分别定义产品不同的特性,使用它可以用一套代码创建不同的产品
就是用于定义产品的特性,这是每个产品不同的地方。有了它我们可以用同一套代码创建不同的产品。设置productFlavors的方法如下:
在 build.gradle文件中加入 productFlavors结构:
android{
......
productFlavors{
productA{
//这里定义产品A的特性
}
productB{
//这里定义产品B的特性
}
//更多产品 ...
}
设置渠道包信息:
//友盟多渠道打包
flavorDimensions "Yin"
productFlavors {
wandoujia {
versionName = project.VERSION_NAME
dimension "Yin"
}
_360 {
dimension "Yin"
}
huawei {
dimension "Yin"
}
xiaomi {
dimension "Yin"
}
meizu {
dimension "Yin"
}
vivo {
dimension "Yin"
}
}
productFlavors.all { flavor ->
manifestPlaceholders.put("UMENG_CHANNEL_VALUE", name)
}
注:这里用的还是友盟的关键字;为了适配gradle
3.0还,在使用flavor时,必须定义flavorDimension,还需要在AndroidManifest.xml文件中添加:
最后,在 buildTypes的 release设置中添加下面这段代码(批量修改生成的apk文件名):
注:可能出现的错误:
//Gradle升级了3.0后,output.outputFile变成了只读属性,不能再往里面写东西了,以下是3.0之前的配置:
applicationVariants.all { variant -> //批量修改Apk名字
variant.outputs.each { output ->
def outputFile = output.outputFile
if (outputFile != null && outputFile.name.endsWith('.apk') && 'release'.equals(variant.buildType.name)) {
def fileName = outputFile.name.replace("${variant.flavorName}", "V${defaultConfig.versionName}-${variant.flavorName}")
fileName = fileName.replace('.apk', "-${buildTime()}.apk")
output.outputFile = new File(outputFile.parent, fileName)
}
}
}
//下面是经过修改之后3.0里面批量修改APK名字的配置:
applicationVariants.all { variant -> //批量修改Apk名字
variant.outputs.all { output ->
if (!variant.buildType.isDebuggable()) {
//获取签名的名字 variant.signingConfig.name
//要被替换的源字符串
def sourceFile = "-${variant.flavorName}-${variant.buildType.name}"
//替换的字符串
def replaceFile = "_V${variant.versionName}_${variant.flavorName}_${variant.buildType.name}_${buildTime()}"
outputFileName = output.outputFile.name.replace(sourceFile, replaceFile);
}
}
}
3.多渠道打包
在AS上直接像平时一样打包,只不过在选择路径的时候有了更多的选择,可以单独打一个标签的,也可以多选打出各个渠道的包,如图:
好了,大功告成。欢迎大家吐槽,这个Gradle东西太多,我只总结了,我用到的部分。关于Gradle详解可以在下面的参考链接中学习。
最后附上,项目地址:Gradle模块化配置及多渠道打包
三. 参考链接
1.一个完整Android项目所需要用到的gradle配置技巧
2.Gradle模块化配置:让你的gradle代码控制在100行以内
3.终极组件化框架项目方案详解
4.Android开发中Gradle配置的相关概念
5.Cannot set the value of read-only property 'outputFile' for ApkVariantOutputImpl_Decorated