# App 云打包

云打包由 DCloud 云端完成,无需本地原生开发环境,是 App 最常用的发行方式。

# 打包步骤

  1. 打开 发行 菜单,选择 App-Android/iOS-云打包,也可以在命令面板中执行同名命令;
  2. 在弹窗中填写包名、证书、渠道等信息,确认后提交打包;
  3. 打包日志会输出到 云端打包 输出通道;证书密码等敏感信息在日志中会被脱敏;
  4. 需要查看进度时,执行 App-Android/iOS-查看云打包状态。

云打包需要联网并登录 DCloud 账号;免费额度与收费规则以 DCloud 官方说明为准。

# Android 打包配置

配置项 说明
包名 Android 应用包名,打包时必填
证书类型 可选自有证书、公共证书、DCloud 老版证书、云端证书;正式发行建议使用自有证书
证书别名 / 证书文件 / 证书密码 使用自有证书时填写
渠道包 可选 Google、应用宝、360、华为、小米、OPPO、vivo 等渠道,多个渠道用英文逗号分隔
AAB 渠道包 可选 Google;用于上架 Google Play
防重签 可绑定 AppID、包名、签名,防止安装包被二次签名

# iOS 打包配置

配置项 说明
App ID(Bundle ID) iOS 应用标识,打包时必填,需与证书匹配
支持的设备 可选 iPhone、iPad,可多选
证书 / profile 使用自定义证书时提供 p12 证书与 profile 文件;也可使用云端证书
iOS 渠道包 可选真机、模拟器等,仅 macOS 生效

# 打包选项

  • 安心打包:仅 uni-app 项目可选,打包过程不上传证书到云端,更安全;
  • SourceMap:生成 SourceMap,便于线上错误定位;
  • 代码混淆:启用代码混淆,提升安全性;
  • iOS 符号表(dSYM):生成符号表文件,用于解析线上崩溃堆栈;
  • 广告配置:可集成开屏广告、激励视频广告,以及国内/海外广告 SDK;
  • 打包预校验:uni-app x 项目支持编译前预校验,提前发现配置问题。

打包过程中遇到 warning 时可选择忽略并继续。

# 查看打包状态

云打包为异步任务,提交后可以通过以下命令管理:

命令 说明
App-Android/iOS-查看云打包状态 查询当前账号的打包任务状态
查询单个异步云打包任务 查询指定任务,成功后自动下载产物
取消云打包 取消未完成的打包任务

# 常见问题

  • 云打包失败:先查看 云端打包 输出通道中的日志;常见原因是证书、包名配置错误或账号登录状态失效。
  • iOS 证书报错:检查 Bundle ID 与证书是否匹配、证书是否过期,profile 文件是否包含对应设备。
  • 打包后安装失败:确认设备系统版本满足 App 的最低版本要求;Android 需确认签名一致。

更多问题见 常见问题。