【笔记】Cordova平台创建项目以及进行apk签名的详细步骤(含keystore生成)
第一步 安装JDK
安装jdk,这个只需要在oracle官网下载即可,需要使用1.8以上的版本。
第二步 JDK环境变量
配置jdk的环境变量,这一步网络上有非常多的教程,不再赘述。
第三步 生成签名包
- windows徽标键+R 打开运行窗口,输入cmd 打开命令行工具。
- 输入
keytool -genkeypair -alias @alias -keyalg RSA -validity @expiredate -keystore @keystoreRepositoryName -storepass @password
命令
参数说明:
参数 | 说明 | 示例 |
---|---|---|
@alias | 别名 | taylor |
@expiredate | 过期天数(有效期) | 4000 |
@keystoreRepositoryName | 仓库名称 | taylor.keystore |
@password | 密码 | 123456 |
- 依照提示填写相关内容,牢记设置的密码。
第四步 安装Cordova
npm install -g cordova
-g
标志是告诉 npm
我们全局安装 cordova
。否则我们将会安装在当前工作目录的 node_modules
子目录。
第五步 创建APP
$ cordova create hello com.example.hello HelloWorld
然后修改config.xml
,设置Android的包名(ios的BundleId如果有需要也在此设置),具体方式如下:
- 打开文件找到
widget
元素。 - 新增
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进行签名。
- 首先我们复制前面生成的keystore文件到 apk所在的目录。
- 然后在目录的空白位置按住
shift+鼠标右键
,再弹出的菜单中选择在此处打开powershell窗口
- 执行如下命令进行签名:
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必须引用包含私有密钥和相应的公共密钥证书链的有效密钥库 密钥条目
这样的错误。
第十步 用签名工具获取应用签名
- 下载签名工具([点此下载(https://res.wx.qq.com/open/zh_CN/htmledition/res/dev/download/sdk/Gen_Signature_Android2.apk "微信签名工具")])
- 在模拟器中安装你的已签名APK项目。
- 在模拟器中安装下载好的签名工具。
- 在签名工具中输入上面设置的包名。
- 点击确定后就会在输入框下方显示 生成成功的应用签名。倘若包名填写错误,是无法生成应用签名的。
转载请注明出处,Cordova常见问题可以参考我的其他博客文章。