Gradle 使用技巧 (一)

前言

Gradle 是使用 Groovy 语言构建，所以既然是语言，那么就有他的语法，而不是简单的配置项。关于 Gradle 有时间会出一系列的文章。

1. 自定义 apk 输出名称 (3.0)

本配置为 Android studio3.0 及以上的配置，3.0 以下版本适用，下面的配置会将所有的 Variants 都输出。

// 便利所有的Variants，all是迭代遍历操作符，相当于for
applicationVariants.all { variant ->// 遍历得出所有的variant
	variant.outputs.all {// 遍历所有的输出类型，一般是debug和replease
		// 定义apk的名字，拼接variant的版本号
		def apkName = "app_${variant.versionName}"
		// 判断是否为空
		if (!variant.flavorName.isEmpty()) {
			apkName += "_${variant.flavorName}"
		}
		// 赋值属性
		outputFileName = apkName + ".apk"
	}
}

配置到 buildTypes 的 release 和 debug 下面

2. 配置签名

我们在使用百度地图和微信相关的 API 的时候，是需要我们填入相关的的 app 签名进行校验后才能进行操作，而默认我们在调试模式下使用的是 AS 为我们提供的 android.keystore，所幸，Gradle 为我们提供了相关的方法，我们可以为 debug 和 release 指定密钥文件和前面。我们需要先在 app.gradle 的 android 节点做做相关的配置。

2.1 配置签名信息

android{
	...
	signingConfigs {
		debug {
			try {
				storeFile file("../签名文件.jks")
				storePassword "密码"
				keyAlias "别名"
				keyPassword "密码"
				v1SigningEnabled true
				v2SigningEnabled false
			}
			catch (ex) {
				ex.printStackTrace()
				throw new InvalidUserDataException("秘钥用户名或密码错误${ex.getMessage()}")
			}
		}
		release {
			try {
				storeFile file("../签名文件.jks")
				storePassword "密码"
				keyAlias "别名"
				keyPassword "密码"
				v1SigningEnabled true
				v2SigningEnabled false
			}
			catch (ex) {
				throw new InvalidUserDataException("秘钥用户名或密码错误")
			}
		}
	}
	...
}

• signingConfigs 是处于 android 节点中
• 这里需要注意的是 storeFile 的路径是指当前 app.gradle 的相对路径。
• 关于 v1SigningEnabled 和 v2SigningEnabled
  • APK Signature Scheme v2 是 Android 7.0 引入一项新的应用签名方案 APK Signature Scheme v2，它能提供更快的应用安装时间和更多针对未授权 APK 文件更改的保护。一般情况下都会选择关闭。

2.2 在相应的 buildTypes 中指定签名

buildTypes{
	release{
		signingConfig signingConfigs.release
		...
	}
	debug{
		signingConfig signingConfigs.debug
		...
	}
}

虽然不指定这一步，我们依然能够正常运行，但是为了出不必要的幺蛾子，我们还是把它加上吧。

3. release 和 debug 设置全局变量

3.1 全局 debug 开关

写程序就会要有 log，有 log 我们就需要在打 release 包的时候就需要手动的设置 debug 开关为 false，但是在某些情况下我们可能会忘记关闭的。所以可以选择在 gradle 中通过 buildConfigField 定义变量，然后再需要的时候直接进行引用。

buildTypes {
	release {
		...
		buildConfigField "boolean", "isDebug", "false"
		...
	}
	debug {
	...
		buildConfigField "boolean", "isDebug", "true"
	...
	}
}

以上，我们在两种模式中都创建了一个叫做 isDebug 的布尔值的变量，根据类型不同设置值，然后需要重新编译一下。
编译完成后直接调用 BuildConfig.isDebug 作为开关设置即可

关于 BuildConfig 的内容，可以看下面的截图

3.2 API 地址的配置

既然有了全局 debug 开关的设置，那么就肯定有这么一个需求：debug 和 release 下使用不同的 API 请求地址，其实也就是和前面一个套路，直接通过 buildConfigField 定义变量。

buildTypes {
	release {
		...
		buildConfigField "boolean", "isDebug", "false"
		buildConfigField "String", "API", "http://192.168.1.1/release"
		...
	}
	debug {
	...
		buildConfigField "boolean", "isDebug", "true"
		buildConfigField "String", "API", "\"http://192.168.1.1/debug\""
	...
	}
}

String 类型一定要记得加双引用转义。
String 类型一定要记得加双引用转义。
String 类型一定要记得加双引用转义。

后续敬请期待！
免为其难的关注一下公众号吧！！