超详细！uni-app Android本地打包傻瓜式教程

前言

本教程将指导您完成uni-app项目的Android本地打包过程。通过本地打包，您可以更好地控制应用的打包过程，实现更多自定义配置。

一、申请应用标识

1.1 获取DCloud AppID

1. 登录DCloud开发者中心

2. 创建一个新应用

3. 点击创建后的项目

4. 创建证书，需要等一会儿时间，1 分钟左右，可能更快，（可以尝试刷新页面）

5. 创建完成，下载，后面使用

6. 新增平台，这块需要用到刚刚创建的证书

注意：这边开了 2 个窗口，左边的窗口在第 5 步，点击查看证书

7.创建平台完成

二、准备打包资源

2.1 生成本地打包资源

1. HBuilderX中操作，可以创建一个新项目，供测试
   • 项目右键 → 发行
   • 选择"原生App-本地打包"
   • 点击"生成本地打包App资源"

2. 检查生成的资源
   • 确认资源完整性
   • 检查配置文件

2.2 下载离线SDK

1. 访问Android离线SDK下载页面
2. 下载最新版本的离线SDK

3. 解压下载的SDK包

三、打包流程

3.1 导入Android项目

1. 打开Android Studio

2. 导入离线SDK示例项目

提示：如果遇到 gradle下载慢，可通过 一招解决Gradle下载慢：本地路径配置指南文章解决

3. 替换本地打包资源
   • 将HBuilderX生成的资源复制到项目中

3.3 更新应用配置,以下三处地方需要保持一致，appid 一样

1. 资源文件夹名

2. manifest.json 文件

3. dcloud_control.xml 文件

3.4 配置包名

3.5 配置应用信息

1. 配置 dcloud key

Android studio 里面配置,AndroidManifest.xml

2. 配置应用签名

3.6 打包发布

1. 配置打包信息

2. 执行Release打包

注意：如果打包报错, Error: Google Play requires that apps target API level 33 or higher. ExpiredTargetSdkVersion, 请看这篇文章 解决uniapp安卓打包targetSdkVersion报错

3. 获取生成的APK文件

四、常见问题

问题	解决方案
打包后无法安装	检查签名配置
应用闪退	确认AppID正确
资源缺失	重新生成打包资源

参考资料

• 一招解决Gradle下载慢：本地路径配置指南
• 解决--iapp安卓打包targetSdkVersion报错
• uni-app离线打包文档
• Android打包发布指南

---