【笔记】Cordova平台创建项目以及进行apk签名的详细步骤(含keystore生成)

第一步 安装JDK

安装jdk,这个只需要在oracle官网下载即可,需要使用1.8以上的版本。

第二步 JDK环境变量

配置jdk的环境变量,这一步网络上有非常多的教程,不再赘述。

第三步 生成签名包

  1. windows徽标键+R 打开运行窗口,输入cmd 打开命令行工具。
  2. 输入 keytool -genkeypair -alias @alias -keyalg RSA -validity @expiredate -keystore @keystoreRepositoryName -storepass @password 命令

参数说明:

参数 说明 示例
@alias 别名 taylor
@expiredate 过期天数(有效期) 4000
@keystoreRepositoryName 仓库名称 taylor.keystore
@password 密码 123456
  1. 依照提示填写相关内容,牢记设置的密码。

第四步 安装Cordova

npm install -g cordova 

-g 标志是告诉 npm 我们全局安装 cordova。否则我们将会安装在当前工作目录的 node_modules子目录。

第五步 创建APP


$ cordova create hello com.example.hello HelloWorld

然后修改config.xml,设置Android的包名(ios的BundleId如果有需要也在此设置),具体方式如下:

  1. 打开文件找到 widget 元素。
  2. 新增 android-packageName 属性,其值即为android的包名。ios-CFBundleIdentifier属性 用于设置BundelId。

<widget id="com.xxx.xxx" android-packageName="com.xxx.www" ios-CFBundleIdentifier="com.xxx.www" version="1.0.0" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
...
</widget>

如果你没有设置 android-packageName 那么在打包的时候,会默认以 id属性作为包名。

第六步 添加平台

$ cordova platform add @platformname --save

@platformname的可选值:

参数 说明
android 安卓平台
ios 苹果IOS平台
browser 浏览器平台
wp8 windowsPhone 8
blackberry10 黑莓 10
windows Windows
  • 添加的平台类型决定在打包之后的应用程序可以安装在何种平台上,常用的添加android和browser即可。构建android平台需要安装androidsdk,构建ios平台同样需要相关的软件支持,因此在windows上几乎不能开发ios平台的app了。

第七步 检查前置条件(环境支持)

$ cordova requirements

执行上述命令可以检查目前的开发环境所缺少的配置项,如果完全满足条件,则会显示类似如下的内容:

$ cordova requirements
Requirements check results for android:
Java JDK: installed .
Android SDK: installed
Android target: installed android-19,android-21,android-22,android-23,Google Inc.:Google APIs:19,Google Inc.:Google APIs (x86 System Image):19,Google Inc.:Google APIs:23
Gradle: installed

Requirements check results for ios:
Apple OS X: not installed
Cordova tooling for iOS requires Apple OS X
Error: Some of requirements check failed

第八步 构建APP

运行下面命令为 所有添加的平台 构建:

$ cordova build

也可以指定平台进行构建:

$ cordova build android

构建(build)好的apk文件一般会在 \platforms\android\app\build\outputs\apk\debug\目录,或许您已经注意到了其中的debug,没错上述命令生成的实际上是调试版本的应用程序,此处应该使用$ cordova build -realeas android生成正式版的apk文件,生成后的文件一般会在 \platforms\android\app\build\outputs\apk\release\ 目录内,文件名称为app-release-unsigned.apk

第九步 签名APK

在上一个步骤中,已经生成了正式版本的apk文件了,接下来需要对apk进行签名。

  1. 首先我们复制前面生成的keystore文件到 apk所在的目录。
  2. 然后在目录的空白位置按住shift+鼠标右键,再弹出的菜单中选择 在此处打开powershell窗口
  3. 执行如下命令进行签名:

jarsigner -verbose -keystore @keystoreRepositoryName -signedjar @apkfilename @unreleasessignedapkname @alias 

参数 说明 示例
@keystoreRepositoryName keystore文件名 taylor.keystore
@apkfilename 签名后的apk文件名称 taylor.apk
@unreleasessignedapkname 当前文件中未签名的apk文件名称 app-release-unsigned.apk
@alias 别名 taylor

执行完上述命令之后,就会在当前目录生成已签名的apk文件。

  • 注意:通常在网上搜索的资料,会将@alias参数写成 xxx.keystore格式,对读者产生误导,实际上此处应该填写的是你在创建keystore时候所填写的keystore别名,否则你会产生jarsigner: 找不到xxxAPKKey.jks的证书链。xxxxAPKKey.jks必须引用包含私有密钥和相应的公共密钥证书链的有效密钥库 密钥条目这样的错误。

第十步 用签名工具获取应用签名

  1. 下载签名工具([点此下载(https://res.wx.qq.com/open/zh_CN/htmledition/res/dev/download/sdk/Gen_Signature_Android2.apk "微信签名工具")])
  2. 在模拟器中安装你的已签名APK项目。
  3. 在模拟器中安装下载好的签名工具。
  4. 在签名工具中输入上面设置的包名。
  5. 点击确定后就会在输入框下方显示 生成成功的应用签名。倘若包名填写错误,是无法生成应用签名的。

转载请注明出处,Cordova常见问题可以参考我的其他博客文章。

推荐阅读更多精彩内容