相信有不少做 uniapp
开发并打包成 APK
的小伙伴有过相同经历,每次更改项目之后需要部署之时,就逃不过 云打包并排队
以及 打包次数受限
的痛苦,况且每当周五下午,这个痛苦会再次加倍,所以下面就为各位介绍一下 uniapp离线打包
的完整教程(PS:真的有好多坑,整掉了我 1024
根头发 -_- )
一、准备工作
- 下载 Android Studio 并安装(一直下一步即可)
Download Android Studio & App Tools - Android Developers (google.cn) - 下载 uniapp 官方提供的 SDK
Android 离线SDK - 正式版 | uni小程序SDK (dcloud.net.cn) - 准备一个 uniapp 项目并进行本地打包
打包之后会生成一个以 __UNI__
开头的文件,并保存在以下目录:
- 创建 Android ID,登录 Dcloud 后台
应用列表 (dcloud.net.cn)
路径如下:应用管理 - 我的应用,点击右上角创建应用
,应用类型选择uni-app
,填写名称点击创建即可在列表中看到刚刚创建的一项,然后在列表中点击蓝色的应用名称进入配置
然后点击各平台信息
-新增
准备一个 Android 打包的 签名文件
,如下图是应用场景:
- 首先你得先安装JRE环境(安装Android Studio的时候也得安装JDK,同时就有安装JRE了)
- 随便进入一个磁盘,这里我是在C盘操作的,执行
cmd
进入命令行 - 使用keytool -genkey命令生成证书:keytool -genkey -alias kytest -keyalg RSA -keysize 2048 -validity 36500 -keystore kytest.keystore
- 填写相关信息,按Y生成一个
签名文件
- 然后打印详情输入:keytool -list -v -keystore kytest.keystore
注:kytest 别名:可替换自己的签名证书别名;kytest.keystore 为生成的签名证书文件名称,默认为jre目录bin文件夹内
- 然后将上述生成的东西填入,包名按照【com.android.uniApp】格式命名:
- 提交成功之后在列表页中点击
创建
即可生成离线打包Key
至此,准备工作已经完毕,接下来才是硬骨头,嘿嘿~~
二、开始鼓捣
- 导入项目:将 uniapp 官方提供的 SDK 压缩包解压,并将其中的【HBuilder-Integrate-AS】导入 Android Studio,导入后将 Android 目录更改为 Projects 目录,更直观些
- 将此目录整体替换成刚刚打包生成以
__UNI__
开头的文件
- 修改\HBuilder-Integrate-AS\simpleDemo\src\main\assets\data\dcloud_control.xml文件中的appid为自己项目的ID
- 修改\HBuilder-Integrate-AS\simpleDemo\src\main\AndroidManifest.xml文件中的包名为刚刚创建
离线打包Key
中填入的包名,以及底下的meta-data标签dcloud_appkey的value值为上面生成的Android ID
- 将自己项目中的密钥文件复制到simpleDemo目录下,如下图中的“kytest.keystore”;也可以使用Android Studio重新创建密钥,操作路径:Build>Generate Signed Bundle or APK>Next>Create new
- 修改项目\HBuilder-Integrate-AS\simpleDemo\build.gradle中密钥配置为自己的刚刚生成的密钥内容,注意目录层级,外层还有一个同名build.gradle文件;然后将【applicationId】也改为自己的包名
- 这个时候会发现控制台下方是爆红的,而且打包功能区【Build】下几乎都是灰色的,接下来就该改一下【JDK】和【Gradle】的版本了,点击左上角的【File】-【Settings】将【Gradle JDK】更改为【1.8】的版本然后保存;同样点击左上角【File】-【Project Structure…】将【Gradle Version】更改为【6.5】然后保存,等待项目重新加载【Gradle】,最后关闭 Android Studio 重新打开。
- 点击右上角的运行按钮,等待项目运行,结果便是成功啦~
- 点击功能区【Build】-【Generate Signed Bundle/APK…】选择【APK】-【Next】,填入刚刚生成的【密钥内容】(这里也可以生成新的,但是需要更改项目原本的,确实没必要哈哈哈),点击【Next】选择测试版还是发布版然后【Create】等待打包生成,结果便是成功啦~最后附上打包生成的APK目录
三、踩坑
我有过一次运行项目的时候模拟器显示【appkey is not configured or configured incorrect】,有以下几个原因:
- 项目中的【build.gradle】密钥填错或者上方的【applicationId】没改成与申请AppKey时的appid一致
- 项目中的【AndroidManifest.xml】最底下的【android:value】填错,或者上方的【package】包名没改成与申请AppKey时的appid一致
- 检测离线项目的包名是否申请AppKey时的包名是否一致,见下图,发现不一致时可在【DCLOUD开发者中心-应用列表】中删除原有的,重新创建一个,务必要保证创建的【包名】与HbuilderX打包的文件名一致
相信不少做到最后且成功的小伙伴内心应该无比激动哈哈哈,总体下来的流程步骤巨多,有一个地方出错了都将前功尽弃,所以一定要细心细心再细心。最后还是恭喜大家成功了,有任何问题可以在下方留言哦,一起在前端开发的路上共同进步~~