前言
本教程将指导您完成uni-app项目的Android本地打包过程。通过本地打包，您可以更好地控制应用的打包过程，实现更多自定义配置。
一、申请应用标识
1.1 获取DCloud AppID
- 创建一个新应用
- 点击创建后的项目
- 创建证书，需要等一会儿时间，1 分钟左右，可能更快，（可以尝试刷新页面）
- 创建完成，下载，后面使用
- 新增平台，这块需要用到刚刚创建的证书
注意：这边开了 2 个窗口，左边的窗口在第 5 步，点击查看证书
7.创建平台完成
二、准备打包资源
2.1 生成本地打包资源
- HBuilderX中操作，可以创建一个新项目，供测试
- 项目右键 → 发行
- 选择"原生App-本地打包"
- 点击"生成本地打包App资源"
- 检查生成的资源
- 确认资源完整性
- 检查配置文件
2.2 下载离线SDK
- 访问Android离线SDK下载页面
- 下载最新版本的离线SDK
3. 解压下载的SDK包
三、打包流程
3.1 导入Android项目
- 打开Android Studio
- 导入离线SDK示例项目
提示：如果遇到 gradle下载慢，可通过 一招解决Gradle下载慢：本地路径配置指南文章解决
- 替换本地打包资源
- 将HBuilderX生成的资源复制到项目中
3.3 更新应用配置,以下三处地方需要保持一致，appid 一样
- 资源文件夹名
- manifest.json 文件
- dcloud_control.xml 文件
3.4 配置包名
3.5 配置应用信息
- 配置 dcloud key
Android studio 里面配置,AndroidManifest.xml
- 配置应用签名
3.6 打包发布
- 配置打包信息
- 执行Release打包
注意：如果打包报错, Error: Google Play requires that apps target API level 33 or higher. [ExpiredTargetSdkVersion], 请看这篇文章 解决uniapp安卓打包targetSdkVersion报错
- 获取生成的APK文件
四、常见问题
| 问题 | 解决方案 |
|---|---|
| 打包后无法安装 | 检查签名配置 |
| 应用闪退 | 确认AppID正确 |
| 资源缺失 | 重新生成打包资源 |