Android APP基于Android Studio多版本构建实战

关于多版本构建，我们可以通过buildTypes来新增构建类型，一般而言这里也不需要自行定义，默认会生成debug和release两种类型。

重点在于使用productFlavors生成不同“风味”的版本，我们可以构建标准版和中性版APP，这在企业应用中非常普遍，中性版本不含有logo信息，可再次贴牌等。同时应该在release版本中关闭log输出。

我这里的区别为中性版assets/defaultLogo/logo_default.png和标准版的资源是不一样的，所以需要创建对应的productFlavor文件夹，放入需要替换的logo_default.png资源。同时不论是中性版还是标准版还有四种机型需要适配（F600P、F600、F200P、F200），也就是说我们需要生成8个版本的app。

1.目标

生成多个不同“风味”的版本很容易，只要定义productFlavors即可。但目标应该更进一步，通过只敲一次命令行生成所有的标准版和中性版release app，并且按照我们的命令格式重命名apk文件，最后只需要到build/outputs/apk拿出对应的安装包。

2.使用Gradle命令行

(1).查看gradle命令是否可用

默认情况下打开Android Studio的Terminal面板，键入gradle -version会提示找不到这个命令，无法使用，这需要配置环境变量。

(2).查看Android Studio自带Gradle安装位置

在File-Settings中查看Gradle home（Android Studio安装后会自带一个Gradle，就在其安装目录gradle下）所在位置。

(3).配置Gradle环境变量

建议使用用户变量，只有当前用户可用。添加一个变量名为GRADLE_HOME、变量值为E：/as/gradle/gradle-2.14.1的环境变量。然后编辑path环境变量，新建一行，并填入%GRADLE_HOME%/bin/即可。

(4).验证

再次在Terminal中输入gradle –version命令后回车。出现下面的gradle版本信息，就说明gradle构建工具在命令行方式下已经正常工作。

3.关闭log开关

当然前提是log可以全局通过一个boolean值控制。

使用以下函数可以判断是否debug版本，非debug版本也就是正式版关闭log即可。

/**
* 判断当前应用是否debug状态
*
* @param context
* @return
*/
public static boolean isApkDebug(Context context) {
ApplicationInfo info = context.getApplicationInfo();
return (info.flags & ApplicationInfo.FLAG_DEBUGGABLE) != 0;
}

我在自定义的Application（MainApp.java）中根据判断是否开启log开关。

// Log开关
Logger.DEBUG = AppUtils.isApkDebug(this);

4.配置正式签名

android{
…
signingConfigs {
releaseSign {
storeFile file("E:\\xx\\xx\\xx.keystore")
storePassword "xxxxx"
keyAlias "xx"
keyPassword "xxxxx"
}
}

buildTypes {
release {
signingConfig signingConfigs.releaseSign
…
}
}
…
}

这段代码很好理解，通过在android闭包下配置signingConfigs，并在buildTypes的release下引用即可。

5.配置productFlavors

productFlavors {
// 中性版本F600P
neutralF600P {
// 这里替换了assets内logo_default.png资源
manifestPlaceholders = getVersionNameMap('F600P')
}
// 标准版本F600P
standardF600P {
manifestPlaceholders = getVersionNameMap("F600P")
}
// 中性版本F600
neutralF600 {
manifestPlaceholders = getVersionNameMap("F600")
}
// 标准版本F600
standardF600 {
manifestPlaceholders = getVersionNameMap("F600")
}
// 中性版本F200P
neutralF200P {
manifestPlaceholders = getVersionNameMap("F200P")
}
// 标准版本F200P
standardF200P {
manifestPlaceholders = getVersionNameMap("F200P")
}
// 中性版本F200
neutralF200 {
manifestPlaceholders = getVersionNameMap("F200")
}
// 标准版本F200
standardF200 {
manifestPlaceholders = getVersionNameMap("F200")
}
}

通过在android闭包下配置8个版本的flavor，并给中性版创建对应的文件夹，放入需要替换的logo_default.png资源。Flavor对应的文件夹位于src下，和main平级。

src->

main

neutralF600P

neutralF600

neutralF200P

neutralF200



再来看getVersionNameMap(key)函数。

/**
* 根据key获取version Map
* @param key
* @return
*/
def getVersionNameMap(key) {
def versionNameMap = [:]
if (key == "F600P") {
versionNameMap.D_VERSION_NAME = "F600P"
} else if (key == "F600") {
versionNameMap.D_VERSION_NAME = "F600"
} else if (key == "F200P") {
versionNameMap.D_VERSION_NAME = "F200P"
} else if (key == "F200") {
versionNameMap.D_VERSION_NAME = "F200"
} else {
versionNameMap.D_VERSION_NAME = "F600P"
}

return versionNameMap
}

解释一下：manifestPlaceholders是android gradle dsl中定义的属性，用来替换其中的一些字段，使用groovy GString在AndroidMainifest中占位，通过给manifestPlaceholders赋值Map，将Map中的值替换到AndroidMainifest中。

AndroidMainfest.xml中定义如下：

<?xml version="1.0" encoding="utf-8"?>
<manifest
xmlns:android="http://schemas.android.com/apk/res/android"
package="xxx" >
<application
android:name="xx.MainApp"
android:allowBackup="true"
android:hardwareAccelerated="false"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@android:style/Theme.Black.NoTitleBar.Fullscreen">
…
<meta-data
android:name="D_VERSION"
android:value="${D_VERSION_NAME}" />
…
</application>
</manifest>

Java代码中通过meta-data的对应value去配置为不同的版本，如F600P或F600,当然这部分代码需要在Java中实现对应的逻辑。

/**
* 通过key获取Application标签下meta-data的值
*
* @param context
* @param key
* @return
*/
public static String getApplicationMetaDataVal(Context context, String key) {
ApplicationInfo appInfo = null;
String msg = null;
try {
appInfo = context.getPackageManager().getApplicationInfo(context.getPackageName(), PackageManager.GET_META_DATA);
msg = appInfo.metaData.getString(key);
} catch (NameNotFoundException e) {
e.printStackTrace();
}
return msg;
}

接下来再看转化为版本Version的代码，则部分代码并非必须的，相信看到这里已经明白了，我们是间接的用AndroidMainfest中的meta-data标签传递在build.gradle配置的值，从而达到让java代码加载不同版本的目的。

// 获取不同版本的对应配置参数
Version version = Version.F600P;
String versionName = AppUtils.getApplicationMetaDataVal(this, "D_VERSION");

if (versionName.equals(Version.F600P.getName())) {
version = Version.F600P;
} else if (versionName.equals(Version.F600.getName())) {
version = Version.F600;
} else if (versionName.equals(Version.F200P.getName())) {
version = Version.F200P;
} else if (versionName.equals(Version.F200.getName())) {
version = Version.F200;
}

Log.d("version", "v:" + version.getName());

versionConfig = VersionFactory.getVersionConfig(version);

6.定制重命名逻辑

android {
…
android.applicationVariants.all { variant ->
variant.outputs.each { output ->
def outputFile = output.outputFile
if (outputFile != null && outputFile.name.endsWith('.apk')) {
String flavorName = variant.productFlavors[0].name
//修改apk文件名
def fileName = "xxx-${flavorName}-${defaultConfig.versionName}-${defaultConfig.versionCode}-signed-${releaseTime()}.apk"
def fileParentDir
if (flavorName.startsWith("standard")) {
fileParentDir = flavorName.substring("standard".length(), flavorName.length());
} else if (flavorName.startsWith("neutral")) {
fileParentDir = flavorName.substring("neutral".length(), flavorName.length());
}
File dir = new File(outputFile.parent + File.separator + fileParentDir + File.separator)
if (!dir.exists()) {
dir.mkdirs()
}
output.outputFile = new File(dir, fileName)
}
}
}
…
}

xxx-${flavorName}-${defaultConfig.versionName}-${defaultConfig.versionCode}-signed-${releaseTime()}.apk

这一大段就是重命名后的apk文件名，最终生成的文件名为：

xxx-neutralF600P-v1.0.5-2455-signed-20170502.apk

很好懂，用GString的写法占位。其中后面还有一段的逻辑为把同一型号下标准版和中性版的app放到同一目录下，如F600P文件夹下，放入neutralF600P 和standardF600P app。

最后来看一下releaseTime()函数，作用为按照yyyyMMdd格式化当前时间，即格式化为年月日的形式。

def releaseTime() {
return new Date().format("yyyyMMdd",TimeZone.getTimeZone("UTC"))
}

7.最后一步

以上步骤配置好了生成签名版程序的所有要素，最后在android studio命令行中敲入：

gradle aR

回车后任务开始进行，全部finish后到xx工程\xx\build\outputs\apk下取出apk即可。

详解：

之所以可以使用gradle aR命令是因为gradle支持这种简短的驼峰式写法，实际上和gradle assembleRelease命令是等价的。

另外，我们使用这个命令生成的apk全部为release版本，虽然通过gradle build和gradle assemble都可以生成我们想要的release版本，但gradle build同时生成了debug版本，这对于我们来说是多余的。