uniapp离线打包APK并运行至Android Studio

相信有不少做 uniapp 开发并打包成 APK 的小伙伴有过相同经历，每次更改项目之后需要部署之时，就逃不过 云打包并排队 以及 打包次数受限 的痛苦，况且每当周五下午，这个痛苦会再次加倍，所以下面就为各位介绍一下 uniapp离线打包 的完整教程（PS：真的有好多坑，整掉了我 1024 根头发 -_- ）

一、准备工作

1. 下载 Android Studio 并安装（一直下一步即可）
   
   Download Android Studio & App Tools - Android Developers (google.cn)
2. 下载 uniapp 官方提供的 SDK
   
   Android 离线SDK - 正式版 | uni小程序SDK (dcloud.net.cn)
3. 准备一个 uniapp 项目并进行本地打包

打包之后会生成一个以 __UNI__ 开头的文件，并保存在以下目录：

4. 创建 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

至此，准备工作已经完毕，接下来才是硬骨头，嘿嘿~~

二、开始鼓捣

1. 导入项目：将 uniapp 官方提供的 SDK 压缩包解压，并将其中的【HBuilder-Integrate-AS】导入 Android Studio，导入后将 Android 目录更改为 Projects 目录，更直观些

2. 将此目录整体替换成刚刚打包生成以 __UNI__ 开头的文件

3. 修改\HBuilder-Integrate-AS\simpleDemo\src\main\assets\data\dcloud_control.xml文件中的appid为自己项目的ID

4. 修改\HBuilder-Integrate-AS\simpleDemo\src\main\AndroidManifest.xml文件中的包名为刚刚创建离线打包Key中填入的包名，以及底下的meta-data标签dcloud_appkey的value值为上面生成的Android ID

5. 将自己项目中的密钥文件复制到simpleDemo目录下，如下图中的“kytest.keystore”；也可以使用Android Studio重新创建密钥，操作路径：Build>Generate Signed Bundle or APK>Next>Create new

6. 修改项目\HBuilder-Integrate-AS\simpleDemo\build.gradle中密钥配置为自己的刚刚生成的密钥内容，注意目录层级，外层还有一个同名build.gradle文件；然后将【applicationId】也改为自己的包名

7. 这个时候会发现控制台下方是爆红的，而且打包功能区【Build】下几乎都是灰色的，接下来就该改一下【JDK】和【Gradle】的版本了，点击左上角的【File】-【Settings】将【Gradle JDK】更改为【1.8】的版本然后保存；同样点击左上角【File】-【Project Structure…】将【Gradle Version】更改为【6.5】然后保存，等待项目重新加载【Gradle】，最后关闭 Android Studio 重新打开。

8. 点击右上角的运行按钮，等待项目运行，结果便是成功啦~

9. 点击功能区【Build】-【Generate Signed Bundle/APK…】选择【APK】-【Next】，填入刚刚生成的【密钥内容】（这里也可以生成新的，但是需要更改项目原本的，确实没必要哈哈哈），点击【Next】选择测试版还是发布版然后【Create】等待打包生成，结果便是成功啦~最后附上打包生成的APK目录

三、踩坑

我有过一次运行项目的时候模拟器显示【appkey is not configured or configured incorrect】，有以下几个原因：

1. 项目中的【build.gradle】密钥填错或者上方的【applicationId】没改成与申请AppKey时的appid一致
2. 项目中的【AndroidManifest.xml】最底下的【android:value】填错，或者上方的【package】包名没改成与申请AppKey时的appid一致
3. 检测离线项目的包名是否申请AppKey时的包名是否一致，见下图，发现不一致时可在【DCLOUD开发者中心-应用列表】中删除原有的，重新创建一个，务必要保证创建的【包名】与HbuilderX打包的文件名一致

相信不少做到最后且成功的小伙伴内心应该无比激动哈哈哈，总体下来的流程步骤巨多，有一个地方出错了都将前功尽弃，所以一定要细心细心再细心。最后还是恭喜大家成功了，有任何问题可以在下方留言哦，一起在前端开发的路上共同进步~~