Uniapp Android 本地离线打包（详细流程）

一、简介

  • App 离线 SDK 暂时不支持 Kotlin，未来不清楚。

  • uniapp 提供了 云打包 与 本地打包 两种方案，云打包 需要排队且还有次数限制，本地打包 则就没有这些限制，而且会 本地打包 对开发 原生插件 有很大的帮助。

    image.png

  • 细节：需要 Android Studio 打包的时候，记得先通过工具栏的 Build -> 先 Clean Project -> 再 Rebuild Project -> 最后在打包或运行，生成基座或者测试离线包都适用这套流程。

二、准备工作

  • 按照官方文档中的 开发环境 下载好开发工具与 SDK 工程即可：Android 离线打包选了方式二：导入工程 方式，官方文档地址。

    注意：HBuilder X 3.5.0 及以上版本新增库 breakpad-build-release.aar

    注意：HBuilder X 3.8.7 及以上版本新增库 install-apk-release.aar，上架谷歌应用市场不能包含此库，更多参考文档

    我下载这个版本包好像没有 install-apk-release.aar，那就不用管，大多数的配置官方提供的工程中就已经配置好了，这边只把需要修改的罗列一下，当然最好通过本文结合官方文档来对照走步骤更好。

    在这里插入图片描述

    在这里插入图片描述

  • 下载的 Android 工程目录结构介绍，找到 HBuilder-Integrate-AS 离线打包工程，可以拷贝出来使用 Android Studio 打开该工程。

    image.png

    image.png

  • 打开工程后，先按 Android 老项目新人如何快速入手跑起来 这篇文章快速的配置一下基础环境。

  • 如果跑出下面这样的结果，非报错都先不要管，警告随他先。

    在这里插入图片描述

  • 如果需要重新编译项目可以在这里进行，或者使用 Build 工具栏里面刷新按钮也是一个效果。

    在这里插入图片描述

三、创建 Uniapp 测试项目

  • 使用 HBuilderX 或 Cli 创建一个测试项目 demo，然后运行到测试机或者模拟器。附：Uniapp 运行到 Android 真机或模拟器。

    1、确认当前模拟器或者真机支持的 cpu 类型，然后进行勾选，这里就是配置要打包的 apk 需要支持哪些cpu 类型的手机，全要支持可以全支持。附：adb 查看安卓手机、模拟器、apk包所支持的 CPU 类型（armeabi、armeabi-v7a、arm64-v8a …）

    反正就是勾的越多，打的包越大，你可以测试时用哪个勾哪个，等发包了在根据需要支持的手机市场进行勾选。

    在这里插入图片描述

    2、测试项目正常运行后，则进行本地打包，获得编译后的源码。

    image.png

    3、看控制台，等待编译完成，去给出的目录找到编译后的源码。

    image.png

    4、替换离线打包工程中的源码

    image.png

    image.png

    5、修改 dcloud_control.xml 文件里面的 appid，其实离线资源文件夹名称就是 appid，可以核对下免得出错。

    在这里插入图片描述

    在这里插入图片描述

四、离线工程的调整

  • 代码导入后，需要进行一些离线打包工程上的细节调整。

  • 包名替换，例如 com.dzm.test

    image.png

  • [可选]compileSdkVersion 修改，compileSdkVersion 30 是 Android 项目中的一个配置项，定义了 编译时使用的 Android API 级别（即 Android SDK 版本），表示你正在使用 API 级别 30（对应 Android 11，即 Android 11）。

    在这里插入图片描述

  • 版本号修改，跟 HBuilderX -》manifest.json 中的版本号保持一致。

    image.png

  • 签名配置，也就是证书相关信息

    1、打开 Uniapp 开发者后台，登录一下。

    image.png

    image.png

    2、点击应用名称进入，找到 Android 云端证书，创建一个，稍微等待一下，需要刷新一下网页就能看到创建好的证书信息了，然后下载证书，放到 HBuilder-Integrate-AS 离线打包工程根目录。

    image.png

    image.png

    image.png

    3、复制证书的绝对路径，并替换配置中的证书路径

    image.png

    image.png

    在这里插入图片描述

    4、配置证书别名、密码

    image.png

    在这里插入图片描述

    在这里插入图片描述

    5、配置打包的 apk 需要支持的 cpu 类型

    ndk {
    abiFilters 'x86', 'armeabi-v7a', 'arm64-v8a'
}
    • 1
    • 2
    • 3

    在这里插入图片描述

  • 申请 Appkey，如果没有则需要申请一下，有则可以直接拷贝，需要前往 Uniapp 开发者后台：

    在这里插入图片描述

    在这里插入图片描述

    点击 新增 后，需要填的资料中 包名 按上面的一样，版本可以根据情况来，创建 正式 与 测试 两个切换使用，Android 应用签名SHA1值 与 Android 应用签名SHA256 值在上面的 证书详情 中有，拷贝贴过来即可。其他根据需要可填可不填。

    在这里插入图片描述

    在这里插入图片描述

    然后创建一个 AppKey 并拷贝：

    在这里插入图片描述

    在这里插入图片描述

    将 AppKey 配置到离线工程中：

    在这里插入图片描述

    这个文件顶部的包名也要改一下，保持同步：

    在这里插入图片描述

  • 配置图标，不同分辨率可以按官方文档上的，多建几个文件夹配置。

    在这里插入图片描述

    在这里插入图片描述

  • 配置应用名称，需要保持一致

    在这里插入图片描述

五、离线工程试跑

六、离线自定义基座打包

注：本文转载自blog.csdn.net的卡尔特斯的文章"https://blog.csdn.net/zz00008888/article/details/143777363"。版权归原作者所有，此博客不拥有其著作权，亦不承担相应法律责任。如有侵权，请联系我们删除。
复制链接
相关推荐
发表评论

评论记录：

未查询到任何数据！