概述
我们在开发过程中,会经常遇到,同样的业务逻辑,需要配置不同的资源的情况。有时是不同的渠道,有时是不同的语言环境,各种不同。
如果我们在业务逻辑中,去实现这些差异化,会导致两个问题:
- 代码量很大,分支路径很多。而很多路径在实际使用中是用不到的,造成代码质量差。
- 用业务逻辑去区分情况加载资源,会导致包内需要包含大量的资源,造成包体积过大。
所以,我们需要在编译阶段,就区分种种情况,给予相应的资源。
Android中build.gradle
的productFlavors为我们提供了这样的能力。
快速使用
在module的build.gradle中,我们通过flavorDimensions和productFlavors的配合,来实现多维度的区分:
android {
compileSdkVersion 27
defaultConfig {
applicationId "com.example.oceanlong.buildtestpro"
minSdkVersion 21
targetSdkVersion 27
versionCode 1
versionName "1.0"
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
}
...
flavorDimensions "country"
productFlavors {
china {
applicationId "com.example.oceanlong.buildtestfree"
dimension "country"
}
usa {
applicationId "com.example.oceanlong.buildtestpro"
dimension "country"
}
}
...
}
flavorDimensions
flavorDimensions表示flavor的维度。比如我们可以根据渠道区分打包方式,可以根据国家区分打包方式。在上面的例子中,我们以国家区分打包方式,假定了我们需要两个国家的包:china和usa。
productFlavors
productFlavors包含了各种flavor包,每种flavor,我们以名字作为开头,然后在它的作用域内,加上当前flavor所属的维度。
在每个productFlavors的作用域中,我们可以对当前包,做一些设置。在上面的例子中,我们对不同国家的APK设置了不同的包名。
在Android Studio中,我们可以选择想要打包的flavor:
获取使用命令行:
./gradlew assembleChinaRelease
细节用法
productFlavors除了能够改变包名,还能够根据不同的flavor改变非常多的东西。首先,我们定义android的defaultConfig中的所有属性,比如versionCode、versionName,不再细说。
AndroidManifest
productFlavorA{
manifestPlaceholders = ["APP_KEY": "123456789",]
}
<meta-data
android:name = "APP_KEY"
android:value = "${APP_KEY}"
>
</meta-data>
资源对象
productFlavorA{
resValue "string", "appName", '"微信"'
}
productFlavorB{
resValue "string", "appName", '"Wechat"'
}
<resources>
<string name="app_name">@string/appName</string>`
</resource>
自定义变量
我们也可以在productFlavors中,定义一个公共变量,然后在代码中读取它的值。
productFlavorA {
buildConfigField "String" , "channel" , '"1"'
}
String channel = BuildConfig.channel;
总结
ProductFlavors为我们根据不同flavors在打包时进行不同的配置,提供了解决方案。我们可以通过ProductFlavors修改应用资源、AndroidManifest等。
此外,ProductFlavors还可以定义一些自定义的变量,我们甚至可以打入一些Json等各种编码数据,为我们快速构建多个不同版本提供了基础。
如有问题,欢迎指正。