使用 Ionic & Cordova 构建 Android 应用

密钥库和密钥

创建密钥库和密钥

创建 PKCS12 格式密钥库,并新建一个密钥:

keytool -v -genkeypair -keystore <keystore>.keystore -storetype pkcs12 -alias <alias> -keyalg RSA -keysize 2048 -validity 36500

Tips: <keystore> 为密钥库名称,<alias> 为密钥的别名,有效期 36500 天。

输入两次密钥库密码,再输入证书信息,最后输入 Y 确认证书信息完成创建。

由于 JDK 8 的 keytool 工具 bug,在 PKCS12 格式密钥库新建密钥时无法同时创建密码,需要手动给新建的密钥设置密码:

keytool -v -keystore <keystore>.keystore -alias <alias> -keypasswd

管理密钥库和密钥

查看密钥库信息:

keytool -v -list -keystore <keystore>.keystore

查看密钥库里指定的密钥信息:

keytool -v -list -keystore <keystore>.keystore -alias <alias>

密钥库新增密钥:

keytool -v -genkeypair -keystore <keystore>.keystore -alias <alias> -keyalg RSA -keysize 2048 -validity 36500

删除密钥库里指定密钥:

keytool -v -delete -keystore <keystore>.keystore -alias <alias>

修改密钥库密码:

keytool -v -keystore <keystore>.keystore -storepasswd

修改密钥库指定密钥密码:

keytool -v -keystore <keystore>.keystore -alias <alias> -keypasswd

修改密钥库指定密钥别名:

keytool -v -keystore <keystore>.keystore -alias <alias> -changealias

Android 平台配置

Cordova 项目配置

打开 Cordova 配置文件 config.xml

widget

  • id 应用 ID,一般用倒序写的域名,如 io.ionic.app

  • version 应用 Version,采用 <major>.<minor>.<patch> 格式的语义化版本号

widget.name

应用的正式名称,会显示在应用商店以及安装后的设备屏幕上。

widget.description

应用描述,会显示在应用商店。

widget.author

应用作者姓名,会显示在应用商店。

  • email 作者邮箱地址,会显示在应用商店。

  • href 应用官网,会显示在应用商店。

生成 Android 项目

使用 Cordova 平台生成 Android 项目:

ionic cordova platform add android

生成 Android 项目时,会安装插件,由于 Cordova 强制使用 npm 安装插件,可能会导致依赖安装出错,需要手动重新 使用 Yarn 安装一次依赖:

# 删除 npm 包锁定文件
rm -rf package-lock.json

# 使用 Yarn 重新安装依赖
yarn --ignore-optional

构建 Android 应用

构建测试版

构建 Android debug 应用:

ionic cordova build android --prod --debug

Tips: 构建 debug 应用会默认使用 ~/.android/debug.keystore 签名应用。

构建发行版

构建 Android release 应用:

ionic cordova build android --prod --release

使用 zipalign 对 APK 文件归档对齐:

zipalign -v 4 platforms/android/app/build/outputs/apk/release/app-release-unsigned.apk app-release.apk

使用 apksigner 给应用签名:

apksigner sign --ks <keystore>.keystore --ks-key-alias <alias> app-release.apk

验证签名并显示证书信息:

apksigner verify -v --print-certs app-release.apk

参考文献

Last updated