Android Gradle 多版本多APK打包，修改生成APK名称

前言

在之前写过Android 多渠道打包的文章，可以发布不同APP商店的版本。有时候，我们也会遇到这样的需求，就是应用可能有一个测试版，线上版本等不同版本，可能不同的版本的一些配置信息不同，比如服务器地址，应用名称，图标等，如果我们在每安装一个版本的时候，都去代码里边更改这些值的话，就会显得很繁琐，而且效率很低。下边就说一下如何利用Gradle高效的实现这一需求！

多版本打包

首先，我们要对app的build.gradle这个文件有一个比较全面的了解，知道其中目录的意义，对于其中的语法呢，知道个大概就行了。
对于Gradle的相关知识，可以参考深入理解Android之Gradle

对于build.gradle目录中的各个内容，这里不再赘述，不是本篇文章的内容，具体可以参考：详解build.gradle

①配置
首先在app的build.gradle的android标签中添加：

//配置多版本的apk  
productFlavors{  
	Offline{  
		applicationId "com.xxxx.xxxx.beta"  
		manifestPlaceholders = [app_name:"xxxx" ,icon: "@mipmap/ic_launcher_xxxx"]  
		resValue("string" , "baseUrl","xxxxxxx")  
	}  
	Online{  
		applicationId "com.xxxx.xxxx.online"  
		manifestPlaceholders = [app_name:"xxxx" ,icon: "@mipmap/ic_launcher_xxxx"]  
		resValue("string" , "baseUrl","xxxxxxx") 
	}  

需要注意的几个问题：

1. 上边分了两个版本offline和online，其中applicationId 表示这个版本apk的包名，如果没有写这一项，则默认是defaultConfig {}标签下的包名。
2. manifestPlaceholders=[]这项是配置应用的名称或者图标，如果设置了这一项，需要在AndroidManifese.xml的application标签下配置 android:label="${app_name}" android:icon="${icon}"
3. resValue可以配置一些我们需要的不同的值，第一个参数是变量的类型，第二个参数key，第三个参数是变量的value。具体的使用
   value=context.getResources().getString(R.string.key)
   还有就是在代码中使用的时候，我们要把build.gradle先sync同步一下，要不然会报错找不到这个key。

打包

方法一：

直接在AS的Terminal终端输入命令：./gradlew assemble，之后回车，然后所有的包就打包好了！

方法二：

在AS右侧，点击打开Gradle，依次打开项目名/Tasks/builid/xxxx，我们就会发现会有好多打包项可以选择，需要哪种的就选择哪种就可以了！

方法三：

在AS工具栏，选择build---->select build variant...，会弹出下边的内容：

之后，选择一个就可以了！当然了，这里选择一个之后，我们如果要在手机上运行，点击三角运行的时候，安装的版本就是这里选择的版本了！

好了，对版本的打包就先介绍到这里了！

如果还想了解更多的打包的文章，比如多平台的打包等，可以参考下边一个系列的文章，写的很清楚！
android studio gradle 多版本多apk打包（打包系列教程之五）

修改生成的APK名称

默认生成的apk名字是app-debug.apk,app-release.apk，如果我们配置了上边的版本，生成的是app-offline-debug.apk等。那么如果我们想要生成的apk中加上版本号，或者当前的时间等信息，该如何生成呢？

以上边为例，我想要offline的版本加上版本号和当前日期，格式为app_offline_debug_v1.0-20170419.apk这样的格式！

首先我们需要在build.gradle根目录，定义得到当前日期的函数：

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

然后在build.gradle中android{}标签下，添加：

//在apk文件后边生成版本号信息
android.applicationVariants.all {
	variant ->
		variant.outputs.each {
		output -> output.outputFile = new File(output.outputFile.parent, "app_" + productFlavors[0].name + "_" + buildType.name + "_v" + defaultConfig.versionName + "-${releaseTime()}.apk");
		}
}

①output.outputFile.parent表示生成apk的路径，这个是默认路径在项目/app/build/outpus/apk，当然我们可以自己写路径。
②productFlavors[0].name表示productFlavors标签下的名称，这里就是offline或者online。
③buildType.name指编译类型，就是debug或者release
④defaultConfig.versionName表示在defaultConfig标签下写的版本号
⑤releaseTime()表示我们定义的得到日期的函数

另外上边，我们可以全部用字符串进行拼接，也可以像${releaseTime()}一样定义为变量，效果是一样的！

2019.4.3更新：
在下边评论中vhgcc同学指出，上述修改生成apk名称在AS3.0之后已经有所变化，确实是这样的！这里简单说一下！

详情可以参考官方文档：迁移到 Android Plugin for Gradle 3.0.0

比如上边的代码在3.0中主要的改动在于修改 each() 和 outputFile() 方法为all()和 outputFileName：

android.applicationVariants.all {
	variant ->
		variant.outputs.all {
		outputFileName = rootProject.getName()+"_" + productFlavors[0].name + "_" + buildType.name + "_v" + defaultConfig.versionName + "-${releaseTime()}.apk"
		}
}

另外，关于productFlavor产品风格的配置也有一个问题需要注意，现在必须配置一个产品维度flavorDimensions，然后必须将风格分配到指定的风格维度，否则将会报错： Error:All flavors must now belong to a named flavor dimension.

详情参考官方文档：配置产品风格

比如：

    flavorDimensions "version"
    productFlavors {
        Offline {
            dimension "version"
        }
        Online {
            dimension "version"
        }
    }

再次感谢vhgcc同学！