‌UniApp 安卓打包完整步骤(小白向)


一、环境准备
  1. 安装 HBuilderX

    • 下载最新版 HBuilderX 并安装(官方 IDE,支持一键打包)‌16
    • 确保已安装 Node.js(用于依赖管理)‌26
  2. 配置 Android 开发环境

    • 安装 ‌**Java JDK 17+**‌(建议选择稳定版)‌78
    • 安装 ‌Android Studio ‌(用于本地打包)‌26
      • 安装时勾选 Android SDK、Gradle 等组件‌37

二、申请应用标识与证书
  1. 创建 DCloud 应用

  2. 生成证书

    • 在 DCloud 后台生成 ‌Android 云端证书‌(自动生成包名、证书密码、别名等)‌56
    • 下载证书文件(.keystore)保存至项目目录‌58

三、生成本地打包资源
  1. 在 HBuilderX 中操作

    • 右键项目 → ‌发行 ‌ → ‌原生 App 本地打包 ‌ → ‌生成本地打包资源‌‌13
    • 生成后的资源文件位于 unpackage/resources 目录‌35
  2. 下载离线 SDK

    • 从 DCloud 官网下载 ‌Android 离线 SDK‌(需与 HBuilderX 版本一致)‌36
    • 解压 SDK 至本地目录(如 HBuilder-Integrate-AS)‌38

四、配置 Android 项目
  1. 替换资源文件

    • 将生成的本地打包资源(__UNI__XXXXX 文件夹)复制到 SDK 的 assets/apps 目录‌38
  2. 修改关键配置

    • ‌**dcloud_control.xml**‌:替换 AppID 为 DCloud 后台申请的 ID‌35
    • ‌**AndroidManifest.xml**‌:修改应用名称、权限配置‌36
    • ‌**build.gradle** ‌:
      • 填写 applicationId(包名,需与证书一致)‌36
      • 设置 versionCodeversionName(与 HBuilderX 项目版本一致)‌35

五、生成 APK 安装包
  1. Android Studio 打包操作

    • 打开离线 SDK 项目 → ‌Build ‌ → ‌Generate Signed Bundle/APK‌‌57
    • 选择之前下载的 .keystore 证书文件,输入密码和别名‌57
    • 选择 ‌APK ‌ → ‌Release‌ 模式生成安装包‌57
  2. 处理常见问题

    • Gradle 同步失败‌:检查 Android SDK 路径是否正确,或手动下载 Gradle 版本‌37
    • 白屏问题‌:确保 HBuilderX 版本 ≤ 3.99,高版本需配置隐私弹窗‌46

六、测试与发布
  1. 真机调试

    • 手机开启 USB 调试模式 → 运行到 Android 基座 → 查看实时日志‌48
  2. 应用上架

    • 在应用市场注册开发者账号(如华为、小米)
    • 上传 APK 并填写应用描述、截图等信息‌24

注意事项

  • 证书安全 ‌:勿泄露 .keystore 文件及密码‌56
  • 版本一致‌:HBuilderX、离线 SDK、Gradle 版本需匹配‌36
  • 隐私合规‌:配置原生隐私弹窗,避免应用商店审核失败‌46

通过以上步骤,可完成从零到 APK 的完整打包流程‌13。

相关推荐
MaCa .BaKa4 天前
39-居住证管理系统(小程序)
java·vue.js·spring boot·mysql·小程序·maven·uniapp
佛系菜狗5 天前
【菜狗work前端】小程序加if判断时不及时刷新 vs Web
微信小程序·uniapp·web
HumoChen9916 天前
GZip+Base64压缩字符串在ios上解压报错问题解决(安卓、PC模拟器正常)
android·小程序·uniapp·base64·gzip
Anthony_sun22 天前
UniAppx 跳转Android 系统通讯录
android·uniapp
MaCa .BaKa23 天前
36-校园反诈系统(小程序)
java·spring boot·mysql·小程序·vue·maven·uniapp
假客套23 天前
2025 后端自学UNIAPP【项目实战:旅游项目】2、安装下载引用前端UI框架:uview-plus
uniapp·项目实战
米奇妙妙wuu1 个月前
uniapp中使用<cover-view>标签
前端·uniapp·html5
专注前端不学习一天浑身难受1 个月前
基于uniapp 实现画板签字
前端·uniapp
小程序照片合成2 个月前
uniapp微信小程序开发工具本地获取指定页面二维码
微信小程序·小程序·uniapp·二维码