uinapp Android离线打包-环境和资料准备（一）

一时失言乱红尘 2022-11-28 00:43 373阅读 0赞

**uinapp Android离线打包-环境和资料准备（一）**  
（如果想直接看离线打包的，可以直接从第二步骤开始看）  
提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

### 文章目录 ###

*  前言
 *  一、为什么突然要离线打包
 *   *   *  详细的过渡调整方案如下：
     *  第一种方法：升级HBuilderX
     *   *  附：大概说下我工程里都用到了哪些插件
         *   *  1）路由插件 \`uni-simple-router\`
             *  2）网易易盾验证码插件
             *  3）网易手机号一键登录插件
     *  第二种方法：离线打包
 *  二、Android离线打包（基于\`SDK2.6.16\`）
 *   *  1、资料准备
     *   *  1-1）开发工具
         *  1-2）uniapp离线打包资源
 *  三、Android工程配置
 *  四、简单配置安装
 *   *  1、原来工程打包生成离线资源
     *  2、配置离线工程\`HBuilder-Hello\`
     *   *  2-1、将上个步骤中生成的本地打包资源，拷贝到\`HBuilder-Hello\`的工程里。
         *  2-2、删除 “\`HBuilder-Hello/app/src/main/assets/apps/\`”目录下原来的HelloH5文件夹。
         *  2-3、把示例中的\`appid\`替换成自己的\`appid\`：（\`\_\_UNI\_\_xxxx\`）。
 *  五、总结：
 *  附：
 *   *  附1、Android工程Gradle编译失败
     *  附2、其他说明

--------------------

# 前言 #

接触`uniapp`也有两年+了，因为基于uniapp开发app,不需要你对脚手架熟悉，`HBuilderX`里面环境已经配好了,对原生也不用处理太多的东西，大部分原生的都已经扩展好了。会v`ue`基础和小程序基础，那么学习`uni-app`会很快，只需要专注业务代码就行了。  
好久不写文章了，前几个月一直在忙于公考，趁这次离线打包的机会记录下吧，方便以后接手项目的人和自己以后看看吧，珍惜当前码代码的岁月吧。（PS:趁年轻早点想退路，代码吃青春饭啊。钱没挣到，身体还垮了，为了以后的生活，决定放弃这条道路了，希望早日脱坑吧。)

# 一、为什么突然要离线打包 #

为什么突然要离线打包，前面不是说，基于这个平台开发app,不用知道太多的原生的东西么，那么离线打包，不是更加麻烦了么，还要熟悉原生开发打包的那一套东西，去了解原生工程的配置等。  
因为基于`SDK2.6.16`的工程（项目基于`SDK2.6.16`版本 `非V3`），在2020年08月12日,云打包突然不支持了。云打包相关的提示等会贴出，没办法，只能各种折腾，要么升级，要么走离线打包。只有这两种方法，别无选择。  
云打包的提示如下：

* 自 HBuilderX 2.7.0 版本开始，云端打包不再支持非 V3 版本，请升级 HBuilderX。如果项目使用 CLI 方式创建，请升级 CLI 到最新版本。详情查看https://ask.dcloud.net.cn/article/36988

然后上DCloud官网查了下相关打包支持版本的问题。  
[https://ask.dcloud.net.cn/article/36988][https_ask.dcloud.net.cn_article_36988]  
重要内容贴出，具体可以去查看了解。

### 详细的过渡调整方案如下： ###

*  HBuilderX 2.6.9开始，manifest.json的默认值从非v3调整为v3，即不写"compilerVersion" : 3,，也是v3编译模式。如果需要降级为非v3，请在manifest可视化界面-App其他常用配置 中去掉v3编译器的勾选。
 *  HBuilderX 2.7开始，将移除非v3编译器，只保留v3编译模式。如果开发者使用老版HBuilderX，也仍然可使用非v3编译器。本地打包可以通过使用老版的sdk来继续使用非v3。然后云打包将于5月底不再支持非v3的打包。  
    不管HBuilderX新版怎么调整，开发者已经发布在线上的App不会受到影响。

## 第一种方法：升级HBuilderX ##

将`HBuilderX`升级到`2.8.3`，将工程中用到到其他插件也一一适配，废了几个小时的工夫，终于能运行起来了，云打包，提交测试，接下来，就是等测试反馈提测结果咯。  
结果不失所望，确实不是几个小时适配就能解决问题的。  
接下来就是改呗，不断适配，发现，不是简单的样式适配，就能解决问题的。之前开发的所有组件都有问题。加上项目组成员就两个人，之前一个得力的小伙伴抽调到其他项目组了，从目前的结果来分析，从项目开发的时间成本上来分析评估，升级这种方法，暂时走不下去了。这一天，算是折腾完了。接下去，好好折腾第二种方法。

### 附：大概说下我工程里都用到了哪些插件 ###

#### 1）路由插件 `uni-simple-router` ####

插件市场：[https://ext.dcloud.net.cn/plugin?id=578][https_ext.dcloud.net.cn_plugin_id_578]  
作者插件网址：[http://hhyang.cn][http_hhyang.cn]  
升级`router`插件版本到`1.5.5`（之前`1.5.1`，再之前用的版本不记得了，因为`HBbuiderX`的版本也做了两次升级。）

#### 2）网易易盾验证码插件 ####

插件市场：[https://ext.dcloud.net.cn/plugin?id=1617][https_ext.dcloud.net.cn_plugin_id_1617]  
易盾官方原生SDK:[https://support.dun.163.com/documents/15588062143475712?docId=15044294598372966][https_support.dun.163.com_documents_15588062143475712_docId_15044294598372966]4  
（因为刚接入的时候，还没有该插件，所以就自己动手扩展原生插件。  
在提测阶段，突然发现网易官方在`DCloud`的插件市场发布了这个易盾插件，索性研究了下，对比了，发现还是网易的`API`设计比我自己设计的更合理易用（PS:大厂还是大厂）。但是呢，还是发现了个问题，就是`iOS`部分有崩溃的问题，所以在自己的插件工程中，按照插件市场的`API`设计思路，快速适配了`iOS`的静态包。并且同时在插件市场，反馈了`iOS`插件存在的相关问题。）

#### 3）网易手机号一键登录插件 ####

这个就不多说了，经历和上面第二个差不多。目前用的官方的uniapp插件了。会抽时间写个，怎么修改授权页面样式和使用该注意的相关问题。

## 第二种方法：离线打包 ##

那么直接开始离线打包相关的内容吧。

# 二、Android离线打包（基于`SDK2.6.16`） #

## 1、资料准备 ##

### 1-1）开发工具 ###

`HBuilderX` 版本回退`2.6.16`版本  
使用`HBuilderX 2.6.16` 版（参考[https://ask.dcloud.net.cn/article/37302][https_ask.dcloud.net.cn_article_37302]下载历史版本）  
也可以直接从以下网盘中提取：  
百度网盘链接: [https://pan.baidu.com/s/1TZwqHpyNfwFXXtgIeQsOjA][https_pan.baidu.com_s_1TZwqHpyNfwFXXtgIeQsOjA]  
提取码: `w72y`

### 1-2）uniapp离线打包资源 ###

对应的`SDK2.6.16（Android-SDK@2.6.16.80137_20200426.zip）`  
目前`DCloud`官方网址没有找到对应的历史版本的下载地址。  
**(刚刚偶得DCloud历史版本SDK的下载链接，补上)**  
[http://download.dcloud.net.cn/Android-SDK@2.6.16.80137\_20200426.zip][http_download.dcloud.net.cn_Android-SDK_2.6.16.80137_20200426.zip]  
我已经上传到`CSDN`资源库了。  
[https://download.csdn.net/download/IDOshi201109/12689280][https_download.csdn.net_download_IDOshi201109_12689280]  
（PS:对应iOS的`2.6.16`版本的资源也上传了，[https://download.csdn.net/download/IDOshi201109/12689251][https_download.csdn.net_download_IDOshi201109_12689251]，后续会抽空写下iOS离线打包的文档）

附：`Android-SDK@2.6.16.80137_20200426.zip`解压后的文件夹截图  
![资源解压后截图][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0lET3NoaTIwMTEwOQ_size_16_color_FFFFFF_t_70_pic_center]

# 三、Android工程配置 #

上个步骤已经解压了下载的sdk压缩包。  
（省略了`Android Studio`的安装，上官网下载安装AS即可）  
用`Android Studio`打开示例工程（`HBuilder-Hello`）  
![AS1][]

工程打开后，会自动配置`gradle`等相关。由于有些依赖是联网下载的，所以build比较慢，经过大概二三十分钟后，终于build好了。build好之后的截图如下：  
![as2][]

如果你也遇到和我同样的`gradle build`失败的问题，请参考文章最后的gradle编译失败的处理。

# 四、简单配置安装 #

## 1、原来工程打包生成离线资源 ##

将我们自己的工程，编译生成本地离线打包资源。  
在`HBuilderX`中：

运行——>原生App-本地打包——>生成本场打包App资源

编译好之后资源生成路径为：

xxx项目根目录/unpackage/resources/__UNI__xxxx/www

截图如下：  
![hbuilderx1][]

## 2、配置离线工程`HBuilder-Hello` ##

### 2-1、将上个步骤中生成的本地打包资源，拷贝到`HBuilder-Hello`的工程里。 ###

`xxx项目根目录/unpackage/resources/__UNI__xxxx/www`中的 “\_\_UNI\_\_xxxx/”文件夹，到“`HBuilder-Hello/app/src/main/assets/apps/`”目录下。

### 2-2、删除 “`HBuilder-Hello/app/src/main/assets/apps/`”目录下原来的HelloH5文件夹。 ###

### 2-3、把示例中的`appid`替换成自己的`appid`：（`__UNI__xxxx`）。 ###

具体修改的文件为：`Android-SDK/HBuilder-Hello/app/src/main/assets/data`  
下的`dcloud_control.xml`：  
原来示例工程中的内容：

修改后的：

`HBuilder-Hello`工程项目截图如下：  
![AS21][]

# 五、总结： #

经过上面步骤的简单的配置，可以通过运行到手机或模拟器查看效果了。  
具体怎么用自己的证书打包，并且进行其他适配工作，请看第二篇文章。

# 附： #

## 附1、Android工程Gradle编译失败 ##

后面再补齐

## 附2、其他说明 ##

刚刚（2020年08月16日）看到了`DCloud`官方的回复，又恢复了对`2.6.16`版本的云打包。至于什么时候再次强制不支持，不好说。所以最后还是要面临现在的这个决择，要么继续之前旧的版本？要么跟着官方的`SDK`升级？  
反正就是不断折腾适配呗，这样才体现程序员的价值咯。

今天（2020年08月17日）特别试了下云打包，这就是官方说的，已经恢复对2.6.16版本的支持么？打出来的，样式错乱，不多说了。还是离线打包香。  
![1][]  
当前HBuilderX版本和云打包服务器对应的HBuilderX版本不一致，有可能出现兼容性问题  
当前版本：2.6.16，云打包服务器版本：2.8.3，详情请参考  
请选择继续打包还是升级HBuilderX

[https_ask.dcloud.net.cn_article_36988]: https://ask.dcloud.net.cn/article/36988
[https_ext.dcloud.net.cn_plugin_id_578]: https://ext.dcloud.net.cn/plugin?id=578
[http_hhyang.cn]: http://hhyang.cn
[https_ext.dcloud.net.cn_plugin_id_1617]: https://ext.dcloud.net.cn/plugin?id=1617
[https_support.dun.163.com_documents_15588062143475712_docId_15044294598372966]: https://support.dun.163.com/documents/15588062143475712?docId=15044294598372966
[https_ask.dcloud.net.cn_article_37302]: https://ask.dcloud.net.cn/article/37302
[https_pan.baidu.com_s_1TZwqHpyNfwFXXtgIeQsOjA]: https://pan.baidu.com/s/1TZwqHpyNfwFXXtgIeQsOjA
[http_download.dcloud.net.cn_Android-SDK_2.6.16.80137_20200426.zip]: http://download.dcloud.net.cn/Android-SDK@2.6.16.80137_20200426.zip
[https_download.csdn.net_download_IDOshi201109_12689280]: https://download.csdn.net/download/IDOshi201109/12689280
[https_download.csdn.net_download_IDOshi201109_12689251]: https://download.csdn.net/download/IDOshi201109/12689251
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0lET3NoaTIwMTEwOQ_size_16_color_FFFFFF_t_70_pic_center]: /images/20221124/a360f0422c914aaf971392218b7d74fd.png
[AS1]: /images/20221124/a5ee5cb2f10b40a690be1b888e258709.png
[as2]: /images/20221124/81fdbe7619e44207aed86c2f6c24462c.png
[hbuilderx1]: /images/20221124/6f11d8ff9ad944aa8f8d68ea9e5663a0.png
[AS21]: /images/20221124/c1912876cdcb492aa75b40ba0c610ef4.png
[1]: /images/20221124/fd8c9caa819f474e81ff5f9ae29e8c68.png