uniapp 离线打包指南（Android）

最新推荐文章于 2025-12-31 18:55:24 发布

原创最新推荐文章于 2025-12-31 18:55:24 发布 · 501 阅读

9 ·

CC 4.0 BY-SA版权

文章标签：

#uni-app #android

离线打包指南（Android）

本文档将完成从准备到生成的完整离线打包流程。

阶段一：准备工作

1.1 获取应用证书与离线打包Key

此步骤在DCloud开发者后台完成。

创建/查看证书：
- 进入对应项目，在“证书管理”中创建新证书或查看现有证书。
- 记录关键信息：证书创建后，进入详情页，记录 SHA1 和 SHA256。
- 记录关键信息：查看证书密码，进入详情页，记录别名和 证书密码，后续会用到。
生成离线打包Key：
- 在“个平台信息”中，新增平台信息，输入证书详情中对应的内容 SHA1 和 SHA256。
- 提交后，创建离线Key，复制生成的 离线打包Key 字符串并保存。
提示：建议将证书别名、证书密码、离线打包Key这三个信息保存在文本文件中，以防丢失。

1.2 配置 HBuilderX 并生成本地资源

此步骤在 HBuilderX 中完成。

修改 Manifest 配置：
- 用 HBuilderX 打开 uni-app 项目。
- 打开 manifest.on文件，切换到“源码视图”，确认AppID与DCloud 开发者后台是否一致。
提示：如果不一致，全局搜索，更改所有不一致的地方即可。
生成本地打包资源：
- 点击顶部菜单 发行-> 原生App-本地打包-> 生成本地打包App资源。
- 打包成功后，控制台会输出资源所在目录的路径。

1.3 下载离线 SDK

从 DCloud 官网下载离线SDK，必须与当前 HBuilderX 版本号一致。
⚠️ 严重警告：SDK 与 HBuilderX 版本不一致是导致应用启动白屏、闪退的常见原因，请务必确保版本匹配。

阶段二：Android Studio 工程配置

2.1 导入并初始化项目

解压下载的离线 SDK。
打开 Android Studio，选择 File-> Open，导入 SDK 中的 HBuilder-Integrate-AS目录。
等待 Gradle 同步完成。

2.2 放置应用资源

在 Android Studio 的 Project 视图中，找到路径：simpleDemo/src/main/assets/apps/。
在该目录下，删除原本的_UNI_A文件夹，更换为打包生成的文件夹。
将 阶段一 中生成的本地打包资源（包含 www目录的文件）全部复制到刚创建的 AppID 文件夹内。

2.3 配置核心参数

配置离线Key：
- 打开 simpleDemo/src/main/AndroidManifest.xml。
- 找到名为 dcloud_appkey的 meta-data标签，将其 android:value的值替换为在后台复制的 离线打包Key。
配置应用ID和名称：
- 在 simpleDemo/src/main/assets/data/dcloud_control.xml，修改appid为打包软件的appid。
- 打开 simpleDemo/build.gradle文件，修改为开发平台的应用的包名（如 com.company.appname）。
- 修改应用名称、图标、启动背景图片等。

2.4 配置签名证书

将从开发者后台下载的证书文件（如 demo.keystore）放置到项目目录中（例如 simpleDemo/下）。
打开 simpleDemo/build.gradle文件。

在 android-> signingConfigs部分，找到 config配置项，修改如下：

signingConfigs {
    config {
        keyAlias "证书别名"
        keyPassword "证书密码"
        storeFile file("demo.keystore") // 这里写证书文件名
        storePassword "证书密码"
    }
}

在这里插入图片描述

阶段三：构建与打包

在 Android Studio 中，确保所有配置已保存。
点击菜单栏 Build-> Generate Signed Bundle / APK。
在弹出的窗口中，选择 APK，点击 Next。
由于已在 build.gradle中配置了签名信息，此时 Android Studio 可能会自动填充信息。如果未自动填充，请手动选择密钥库文件并输入密码。
- 若密钥没有问题，use an existion key 会自动填充。
- 选择打包地址及方式，进行打包。
等待建完成，右下角点击locate可直接打开apk所在文件夹。

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

参与评论您还未登录，请先登录后发表或查看评论