阅读 615

signingConfigs——安卓 gradle

目录
一、前言
二、signingConfigs
三、signingConfig 结构解析
四、signingConfig 属性
五、一些建议
六、写在最后

一、前言

今天分享 signingConfigs 配置,从字面知道有 “签署配置” 的意思。该配置的作用,就是为编译出来的apk签上我们的“名字”,这样才能将apk发布安装到用户的设备上。

设备(手机、TV等)对 apk 的唯一认定,并不只是包名,而是 包名和签名,其中一项不同,都会认为这个 apk 包是不同的。

包名的不同,表现为多个应用。签名的不同,在应用升级时表现为无法安装,如果是第一次安装,则不会有问题。

二、signingConfigs

signingConfigs 下能够配置多个 signingConfig,例如下面代码中的 sign1 和 sign2。可以供我们变体选择需要的签名。

signingConfigs {
	sign1 {
	//....
	}
	sign2 {
		//....
	}
}
复制代码

三、signingConfig 结构解析

1、signingConfig 的存在位置

signingConfig 会映射为 com.android.build.gradle.internal.dsl.SigningConfig 类,继承结构如下:

2、如何运行

signingConfig 主要是用于打包时的签名,所以我们需要的是进行apk的打包编译。

// app:clean 为了先清空之前的文件
// app:aR 进行编译 release 包
// mac 使用 ./gradlew 
// window 使用 gradlew 
./gradlew app:clean app:aR
复制代码

四、signingConfig 属性

4.1 keyAlias

  • 类型:String
  • 描述:我们所使用的签名别名。
  • 使用方法:
sign1 {
	keyAlias 'gradleStudy'
	//...其他属性
}
复制代码

4.2 keyPassword

  • 类型:String
  • 描述:签名的密码
  • 使用方法:
sign1 {
	keyPassword '123456'
	// ...其他属性
}
复制代码

4.3 storeFile

  • 类型:File
  • 描述:使用的签名文件,如果使用相对路径,是相对于我们设置该属性的gradle文件所处位置。
  • 使用方法:
sign1 {
	storeFile file('../key/gradleStudy.jks')
	// ...其他属性
}
复制代码

4.4 storePassword

  • 类型:String
  • 描述:签名文件的密码
  • 使用方法:
sign1 {
	storePassword 'gradleStudy'
	// ...其他属性
}
复制代码

4.5 storeType

  • 类型:String
  • 描述:签名类型。当我们不填时,默认为 jks 类型。
  • 使用方法:
sign1 {
	storeType 'jks'
	// ...其他属性
}
复制代码

4.6 v1SigningEnabled

  • 类型:boolean
  • 描述:是否使用 v1 类型的签名方案。默认为true,即开启状态。如果我们将其置为false,则会导致在 7.0 以下版本,无法正常安装。
  • 使用方法:
sign1 {
	v1SigningEnabled false
	// ...其他属性
}
复制代码

4.7 v2SigningEnabled

  • 类型:boolean
  • 描述:是否使用 v2 类型的签名方案。默认为true,即开启状态。v2在 7.0 版本之后才支持。
  • 使用方法:
sign1 {
	v2SigningEnabled true
	// ...其他属性
}
复制代码

略带一提,v1、v2、v3 的签名方案在此处就不展开了,有兴趣的同学可以移步官方的文档查看,请进传送门

五、一些建议

因为签名文件和信息对于个人或是公司来说都是很重要的,官方并不建议直接写在gradle中,而是在根目录下建一个 keystore.properties 文件,存放我们的签名配置,然后在 gradle 中将其引入。

具体代码可以查看小盆友的另一个项目,多渠道打包

六、写在最后

Gradle项目地址:Github传送门

本篇博文的 signingConfigs 配置,请进传送门

如果觉得本篇博文对你有所启发或是解决了困惑,给个赞或关注我呀,小盆友会继续分享更多的优质文章。

或是请我喝杯咖啡吧,小盆友会更加信心百倍的写下去

关注下面的标签,发现更多相似文章
评论