uni-app Android平台签名证书(.keystore)生成指南

发布于 1周前 作者 yuanlaile 来自 Uni-App

uni-app Android平台签名证书(.keystore)生成指南

Android平台打包发布apk应用

Android平台打包发布apk应用，需要使用数字证书（.keystore文件）进行签名，用于表明开发者身份。

Android证书的生成是自助和免费的，不需要审批或付费。

可以使用JRE环境中的keytool命令生成。以下是windows平台生成证书的方法：

安装JRE环境（推荐使用JRE8环境，如已有可跳过）

可从Oracle官方下载jre安装包：https://www.oracle.com/java/technologies/downloads/#java8

下面以Windows平台，jre安装目录为“C:\Program Files\Java\jre1.8.0_201”为例，实际操作时请修改为自己安装目录

建议将JRE安装路径添加到系统环境变量，已配置可跳过此章节

打开命令行（cmd），输入以下命令：

d:  
set PATH=%PATH%;"C:\Program Files\Java\jre1.8.0_201\bin"
  • 第一行：切换工作目录到D:路径
  • 第二行：将jre命令添加到临时环境变量中

生成签名证书

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

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

回车后会提示：

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要求这两个密码一致），直接回车就可以

以上命令运行完成后就会生成证书，路径为“D:\test.keystore”。

注意：上述信息填写要规范，乱填有可能会影响应用上架应用市场。

查看证书信息

可以使用以下命令查看：

keytool -list -v -keystore test.keystore  
Enter keystore password: //输入密码，回车

会输出以下格式信息：

Keystore type: PKCS12    
Keystore provider: SUN    

Your keystore contains 1 entry    

Alias name: test    
Creation date: 2019-10-28    
Entry type: PrivateKeyEntry    
Certificate chain length: 1    
Certificate[1]:    
Owner: CN=Tester, OU=Test, O=Test, L=HD, ST=BJ, C=CN    
Issuer: CN=Tester, OU=Test, O=Test, L=HD, ST=BJ, C=CN    
Serial number: 7dd12840    
Valid from: Fri Jul 26 20:52:56 CST 2019 until: Sun Jul 02 20:52:56 CST 2119    
Certificate fingerprints:    
         MD5:  F9:F6:C8:1F:DB:AB:50:14:7D:6F:2C:4F:CE:E6:0A:A5    
         SHA1: BB:AC:E2:2F:97:3B:18:02:E7:D6:69:A3:7A:28:EF:D2:3F:A3:68:E7    
         SHA256: 24:11:7D:E7:36:12:BC:FE:AF:2A:6A:24:BD:04:4F:2E:33:E5:2D:41:96:5F:50:4D:74:17:7F:4F:E2:55:EB:26    
Signature algorithm name: SHA256withRSA    
Subject Public Key Algorithm: 2048-bit RSA key    
Version: 3

其中证书指纹信息（Certificate fingerprints）：

  • MD5
    证书的MD5指纹信息（安全码MD5）
  • SHA1
    证书的SHA1指纹信息（安全码SHA1）
  • SHA256
    证书的SHA256指纹信息（安全码SHA245）

安卓签名获取工具

直接通过一个apk，获取安装到手机的第三方应用签名的apk包。详情：链接

注意事项

云端打包默认会添加V1/V2签名，已知V1签名不支持2048位的DSA算法，使用2048-bit DSA key云端打包可能失败，提示以下错误：

* What went wrong:  
Execution failed for task ':app:packageRelease'.  
> A failure occurred while executing com.android.build.gradle.tasks.PackageAndroidArtifact$IncrementalSplitterRunnable  
   > java.io.IOException: Failed to generate v1 signature

解决方法

  • 第一种方法：重新生成证书，在生成证书命令中添加“-keyalg RSA”参数指定使用RSA算法
  • 第二种方法：设置miniSdkVersion大于等于24，因为V2签名需Android7及以上设备才支持，设置miniSdkVersion大于等于24表示不支持android7以下设备，从而不需要包含V1签名，设置miniSdkVersion详情参考：链接

查看证书算法的方法

使用“keytool -list -v”查看证书信息，看“Subject Public Key Algorithm: ”项的信息，如下表示使用DSA算法：

Subject Public Key Algorithm: 2048-bit DSA key

其他

可获取MD5签名的JDK版本分享

【详见】链接


Harmonyos Next教程
1 回复

在uni-app开发中，为了发布Android应用，我们需要生成签名证书（.keystore文件）。以下是使用Java的keytool命令生成Android平台签名证书的详细步骤及代码案例。

步骤一：安装Java开发工具包（JDK）

首先，确保你的计算机上已安装JDK，因为keytool是JDK自带的一个工具。如果未安装，可以从Oracle官网或OpenJDK网站下载并安装。

步骤二：打开命令行工具

在Windows上，你可以使用命令提示符（cmd）或PowerShell；在macOS或Linux上，使用终端（Terminal）。

步骤三：生成.keystore文件

使用keytool命令生成签名证书。以下是一个示例命令，你可以根据自己的需求调整参数：

keytool -genkeypair -v -keystore my-release-key.keystore -alias my-key-alias -keyalg RSA -keysize 2048 -validity 10000
  • -genkeypair：生成密钥对。
  • -v：详细输出。
  • -keystore my-release-key.keystore：指定生成的.keystore文件名。
  • -alias my-key-alias：为密钥设置别名。
  • -keyalg RSA：使用RSA算法。
  • -keysize 2048：密钥长度为2048位。
  • -validity 10000：证书有效期为10000天。

步骤四：填写密钥库（keystore）信息

执行上述命令后，系统会提示你输入以下信息：

  • Keystore密码：用于保护keystore文件的密码。
  • 你的名字与姓氏：开发者或组织的名称。
  • 组织单位名称：开发者或组织的部门名称。
  • 组织名称：开发者或组织的全称。
  • 所在城市或区域名称：开发者或组织所在的城市或地区。
  • 所在省/州/自治区名称：开发者或组织所在的省份或州。
  • 所在国家/地区代码（两位字母）：开发者或组织所在的国家/地区代码，如CN代表中国。

示例完整命令及输出

keytool -genkeypair -v -keystore my-release-key.keystore -alias my-key-alias -keyalg RSA -keysize 2048 -validity 10000
Enter keystore password:  ********
Re-enter new password: ********
What is your first and last name?
  [Unknown]:  John Doe
What is the name of your organizational unit?
  [Unknown]:  Development
What is the name of your organization?
  [Unknown]:  MyCompany
What is the name of your City or Locality?
  [Unknown]:  Beijing
What is the name of your State or Province?
  [Unknown]:  Beijing
What is the two-letter country code for this unit?
  [Unknown]:  CN
Is CN=John Doe, OU=Development, O=MyCompany, L=Beijing, ST=Beijing, C=CN correct?
  [no]:  yes

Generating 2,048 bit RSA key pair and self-signed certificate (SHA256withRSA) with a validity of 10,000 days
        for: CN=John Doe, OU=Development, O=MyCompany, L=Beijing, ST=Beijing, C=CN
...

完成上述步骤后，你将得到一个名为my-release-key.keystore的签名证书文件，可以在uni-app项目中配置此文件以发布Android应用。

回到顶部