生成 Android 签名证书

Android APK 调用其他如微信 Open SDK，通常需要对应用进行签名，从而绑定签名后的 md5 值。 可理解为： sign(你的 App) = 固定的应用签名（md5）

一、生成签名证书

首先，应用签名需要先生成一个「签名证书」，如已有签名证书可跳过这步阅读

  • 签名证书常规有两种格式 jks 和 keystore，前者可以通过 Android Studio 生成，后者可通过 keytool 命令生成
  • 不同应用市场的签名证书的格式要求存在差异，用户选择性生成所需的证书，然后两个证书也是可以互相转换的
  • 而在微信开放平台创建移动应用需配置的签名为通过 keystore 生成的，因此本文仅介绍生成 kyestore 证书的方法

1、生成 kyestore 证书

a) 方式 1，使用 kyestore 命令工具生成证书

使用keytool -genkey命令生成证书：

keytool -genkey -alias testalias -keyalg RSA -keysize 2048 -validity 36500 -keystore test.keystore
  • testalias 是证书别名，可修改为自己想设置的字符，建议使用英文字母和数字
  • test.keystore 是证书文件名称，可修改为自己想设置的文件名称，也可以指定完整文件路径
  • 36500 是证书的有效期，表示 100 年有效期，单位天，建议时间设置长一点，避免证书过期

补充说明：需先安装 JDK

回车后会提示：

Enter keystore password:  //输入证书文件密码，输入完成回车  
Re-enter new password:   //再次输入证书文件密码，输入完成回车  
What is your first and last name?  
  [Unknown]:  //输入名字和姓氏，输入完成回车  
What is the name of your organizational unit?  
  [Unknown]:  //输入组织单位名称，输入完成回车  
What is the name of your organization?  
  [Unknown]:  //输入组织名称，输入完成回车  
What is the name of your City or Locality?  
  [Unknown]:  //输入城市或区域名称，输入完成回车  
What is the name of your State or Province?  
  [Unknown]:  //输入省/市/自治区名称，输入完成回车  
What is the two-letter country code for this unit?  
  [Unknown]:  //输入国家/地区代号（两个字母），中国为CN，输入完成回车  
Is CN=XX, OU=XX, O=XX, L=XX, ST=XX, C=XX correct?  
  [no]:  //确认上面输入的内容是否正确，输入y，回车  
Enter key password for <testalias>  
        (RETURN if same as keystore password):  //确认证书密码与证书文件密码一样（HBuilder|HBuilderX要求这两个密码一致），直接回车就可以

以上命令运行完成后就会生成证书

b) 方式 2，使用开发者工具的「Android 签名证书生成」工具

  • 路径为：工具栏 - 选择设备 - 签名证书管理 - Android 签名证书生成
  • 按照要求填入下方信息即可生成证书

补充说明：

  • 证书别名：即证书的 key-Alias，该配置项为必填

  • 证书密码：即证书的 key-Password，该配置项为必填

  • 证书文件密码：即证书的 storePassword，该配置项为必填

  • 成功后，即可前往证书文件路径中查看已生成的证书文件

二、签名证书使用

生成的签名证书有如下应用场景：

  • 在微信开发者工具运行于 Android 模拟器和真机前需配置证书项目信息
  • 在微信开发者工具构建 APK 时需配置证书项目信息
  • 用于生成签名填写于微信开放平台移动应用的开发信息中

1、运行于模拟器和真机

首次运行于Android 模拟器和真机时会出现如下签名管理弹窗：

相关的说明如下：

  • 证书别名：即证书的 key-Alias，该配置项为必填
  • 证书密码：即证书的 key-Password，该配置项为必填
  • 证书文件密码：即证书的 storePassword，该配置项为必填

2、构建 APK

  • 构建 APK 时需要单独设置对应的签名证书信息，详情可查看打包生成 APK
  • 即，通过上述方式配置的证书信息不会同步到「构建 APK」面板中，需重新配置用于构建正式 APK 的证书配置；（但是推荐使用同一份，因为证书信息不一致回影响生成的签名的不一致，从而有可能会出现在真机调试的时候没有签名，但是构建 APK 后会出现「由于应用包签名信息校验不通过，无法分享到微信」）

3、生成应用签名和公钥