Android gradle kts 8.0以上版本配置签名和修改APK输出名字

概述

之前写过一篇文章是通过Kotlin的Dsl结合gradle编写的插件来管理项目依赖，我是从一个开源项目叫DanDanPlayAndroid项目上学到的，那时还没有使用toml文件来管理项目依赖的技术。不过虽然现在有了toml文件管理依赖的技术，但我觉得使用插件的方式也很好，读者自己选择吧。这里提这个插件的原因就是在插件中涉及到修改输出的APK名字和签名配置的问题，在最新的gradle kts 版本中，这些配置有点小变化，所以在此处记录下。

修改签名配置

Android的应用都需要签名，才能正常安装使用，为了方便，我们可以将签名的信息配置到gradle中，打包的时候直接运行对应的gradle任务就可了，具体步骤如下所示：

新建签名文件目录

为APK签名一般都需要使用一个签名文件，可以是keystore文件，也可以是jks文件。我们在项目中新建一个目录，将签名文件放到目录里面

注意：这里的签名文件不要放发布apk的正式签名文件，这里的签名文件可以放一个debug的，或者是我们的项目只是为了自己做demo验证问题使用的，如果是正式的签名文件，需要放到私服上，然后加密保护好，防止被窃取。这里放到根目录只是为了演示如何配置签名信息。

在这里插入图片描述

配置签名信息

签名信息在我们生成keystore或者是jks文件时会设置的。将其配置到下面的signingConfigs中，以packJKS来标识

 signingConfigs {create("packJKS"){keyAlias = "demo" // 别名keyPassword = "123456" // 密码storeFile = file("${rootDir.absolutePath}/keystore/demo.jks") // 存储keystore或者是jks文件的路径storePassword = "123456" // 存储密码}}

使用签名信息

配置好签名信息后，接下来就是使用签名信息了，在buildTypes中找到对应的配置并设置给debug和release,如下所示

 buildTypes {// 通过前面配置的签名信息对应的标识符：packJKS拿到签名的配置信息// 保存在mySignConfig中，分别在debug和release中配置上就行了val mySignConfig = signingConfigs.getByName("packJKS")release {isMinifyEnabled = falseproguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"),"proguard-rules.pro")// 配置release 的签名信息signingConfig = mySignConfig}debug {isMinifyEnabled = falseproguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"),"proguard-rules.pro")// 配置debug的签名信息signingConfig = mySignConfig}}

打包

配置好签名信息后，我们可以同步下gradle，如果没有报错的话我们就可以打包了。在gradle中找到下面的两个任务，执行对应的任务就可以打对应的包了。
在这里插入图片描述
执行完任务后，就能得到想要的APK 了，如下所示：

在这里插入图片描述

修改APK名称

经过上面的配置我们可以打出正常可以安装的apk了，但是如过要区分还是很难的，因为名字都是默认的app-release.apk啥的，标识效果不好，并且如果需要给不同的客户提供，还需要手动改，非常麻烦，在之前的gradle版本中是通过修改BaseVariantOutput来达到修改APK 输出文件名的方法，具体的大家可以百度，但是最新的8.0以上不支持这种修改方法了，所以我们就提供了一种使用gradle的任务修改的办法，在android{…}闭包中加入下面的代码，如下所示：

  android.buildTypes.forEach {buildType ->// 拿到对应的任务类型名称，比如是release或debug,后面需要用它去拼接成对应的任务名称val typeName = buildType.name// 获取版本号versionName写到apk的民称中val versionName = android.defaultConfig.versionName// 往apk的名称中加入时间val date = SimpleDateFormat("yyyy-MM-dd-HH-mm", Locale.US).format(Date())// 按名称遍历productFlavors然后创建两个任务分别打release包和debug包android.productFlavors.map { it.name }.ifEmpty { listOf("") }.forEach {flavorName->// 将获取到的名称首字母变为大写，比如：release变为Releaseval combineName = "${flavorName.capitalize()}${typeName.capitalize()}"// 为我们的任务命名：比如叫packReleaseval taskName = "pack$combineName"// 找到打包的任务，比如release就是assembleRelease任务val originName = "assemble$combineName"// 创建一个任务专门做我们的自定义打包任务project.task(taskName){// 为任务分组group = "Pack apk"// 执行我们的任务之前会先执行的任务，比如，打release包时会先执行assembleRelease任务dependsOn(originName)// 执行完任务后，我们将得到的APK 重命名并输出到根目录下的apks文件夹下doLast{copy{from(File(project.buildDir,"outputs/apk/$typeName"))into(File(rootDir,"apks"))rename{"AppPackDemo-V-$versionName-$date.apk"}include("*.apk")}}}}}