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版本，这对于我们来说是多余的。