> 技术文档 > 超详细!uni-app Android本地打包傻瓜式教程_uniapp本地打包

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


前言

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

一、申请应用标识

1.1 获取DCloud AppID

  1. 登录DCloud开发者中心

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

  1. 创建一个新应用

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

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

  1. 点击创建后的项目

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

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

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

  1. 创建完成,下载,后面使用

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

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

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

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

注意:这边开了 2 个窗口,左边的窗口在第 5 步,点击查看证书
超详细!uni-app Android本地打包傻瓜式教程_uniapp本地打包

7.创建平台完成
超详细!uni-app Android本地打包傻瓜式教程_uniapp本地打包

二、准备打包资源

2.1 生成本地打包资源

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

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

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

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

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

2.2 下载离线SDK

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

超详细!uni-app Android本地打包傻瓜式教程_uniapp本地打包
3. 解压下载的SDK包

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

三、打包流程

3.1 导入Android项目

  1. 打开Android Studio

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

  1. 导入离线SDK示例项目

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

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

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

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

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

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

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

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

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

  1. 资源文件夹名

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

  1. manifest.json 文件

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

  1. dcloud_control.xml 文件

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

3.4 配置包名

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

3.5 配置应用信息

  1. 配置 dcloud key

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

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

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

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

Android studio 里面配置,AndroidManifest.xml

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

  1. 配置应用签名

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

3.6 打包发布

  1. 配置打包信息

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

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

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

  1. 执行Release打包

超详细!uni-app Android本地打包傻瓜式教程_uniapp本地打包
注意:如果打包报错, Error: Google Play requires that apps target API level 33 or higher. [ExpiredTargetSdkVersion], 请看这篇文章 解决uniapp安卓打包targetSdkVersion报错

  1. 获取生成的APK文件

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

四、常见问题

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

参考资料

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