uni-app x 打包安卓/iOS 安装包与测试二维码分发完整流程本文基于 HBuilderX 4.31 与 uni-app x 官方云打包方案编写覆盖 Android APK / AAB、iOS IPA 的完整打包流程以及测试环境二维码扫码下载的三种主流实现方案。目录一、环境准备二、项目基础配置三、Android 打包流程APK / AAB四、iOS 打包流程IPA五、测试环境二维码生成与扫码下载六、常见问题排查七、总结与建议一、环境准备1.1 必备工具工具版本要求说明HBuilderX4.31uni-app x 官方 IDEAAB 格式需 4.31JDK17生成 Android 签名证书时需要DCloud 账号-云打包必须登录开发者中心实名认证Apple 开发者账号99 美元/年iOS 打包必需个人/公司/企业均可1.2 账号准备DCloud 开发者账号https://dev.dcloud.net.cn 注册并完成实名认证云打包需要消耗打包次数。Apple 开发者账号https://developer.apple.com 申请个人账号 99 美元/年企业账号 299 美元/年。提示Android 打包不需要付费开发者账号证书可自行生成。二、项目基础配置打包前务必在manifest.json中确认以下配置2.1 基础配置{name:你的应用名称,appid:__UNI__XXXXXX,versionName:1.0.0,versionCode:100,description:应用描述}versionName用户可见的版本号如1.0.0versionCode内部版本号整数每次上架必须递增2.2 App 图标与启动图在 HBuilderX 中打开manifest.json→ 「App 图标配置」上传 1024×1024 图标自动生成各尺寸。启动图在「App 启动图配置」中设置。2.3 模块权限配置根据应用实际功能勾选所需模块如定位、相机、推送等避免勾选不必要的权限导致上架审核被拒。三、Android 打包流程APK / AAB3.1 生成签名证书Android 打包必须使用签名证书。有两种方式方式 A使用 DCloud 云证书推荐开发阶段云打包时直接选择「云证书」DCloud 服务器自动生成有效期 100 年。可在 DCloud 开发者中心 查看和下载。注意商业应用建议分离开发证书和发布证书发布证书由专人掌管。方式 B使用 keytool 自建证书推荐正式发布确保已安装 JDK执行以下命令keytool-genkey-aliasmyapp-keyalgRSA-keysize2048-validity36500-keystoremyapp.keystore参数说明-alias证书别名如myapp-keyalg RSA加密算法-keysize 2048密钥长度-validity 36500有效期 100 年-keystore生成的证书文件名执行后按提示填写密码、姓名、组织等信息牢记证书库密码和证书密码。3.2 云打包操作在 HBuilderX 中选中项目根目录点击菜单发行 → App-Android 云打包或快捷键Ctrl U在弹出的打包界面中配置配置项说明Android 包名反写域名格式如com.yourcompany.appname证书类型云证书 / 自选证书打包格式APK国内市场/ AABGoogle PlayAPK 渠道包可选华为、OPPO、VIVO、小米、荣耀、应用宝等广告联盟按需勾选不需要则全部取消点击「打包」等待云端编译完成通常 3-10 分钟打包完成后点击「打开所在目录」APK 文件位于项目目录/unpackage/release/3.3 自定义渠道可选如果默认渠道不够可在manifest.json源码视图中添加{__hbuilderx:{channel_list:[{id:lenovo,name:联想},{id:meizu,name:魅族}]}}保存后重新打开打包界面新渠道会出现在「APK 渠道包」列表中。3.4 本地离线打包进阶如需深度定制原生层或集成三方 SDK可走本地打包菜单发行 → 原生 App-本地打包 → 生成本地打包 App 资源资源生成在项目目录/unpackage/resources/使用 Android Studio 打开官方离线打包工程拷贝资源、配置签名、执行 Gradle 构建本地打包需要 Android Studio 环境适合有原生开发经验的团队。四、iOS 打包流程IPA4.1 证书与描述文件申请iOS 打包比 Android 复杂需要以下文件文件扩展名说明发布证书.p12包含公钥和私钥用于签名描述文件.mobileprovision绑定 App ID、证书、设备步骤一创建 App ID登录 Apple 开发者中心进入「Certificates, Identifiers Profiles」「Identifiers」→ 点击「」→ 选择「App IDs」填写 Bundle ID如com.yourcompany.appname勾选所需 CapabilitiesBundle ID 必须与manifest.json中的 iOS Bundle ID 一致。步骤二生成发布证书.p12方式 AMac 环境钥匙串访问打开「钥匙串访问」→ 「证书助理」→ 「从证书颁发机构请求证书」填写邮箱选择「存储到磁盘」生成.certSigningRequest文件回到 Apple 开发者中心「Certificates」→ 「」→ 选择「iOS Distribution (App Store and Ad Hoc)」上传 CSR 文件下载.cer证书双击.cer导入钥匙串右键导出为.p12文件设置密码方式 BWindows 环境Appuploader 等工具使用 Appuploader、HBuilderX 证书生成工具等第三方工具无需 Mac 即可生成.p12和描述文件。步骤三生成描述文件.mobileprovisionApple 开发者中心 → 「Profiles」→ 「」选择类型App Store正式上架用Ad Hoc测试分发用限注册设备Development开发调试用选择 App ID、关联证书、选择设备Ad Hoc/Development 需要生成并下载.mobileprovision文件4.2 云打包操作HBuilderX 选中项目 →发行 → App-iOS 云打包配置打包参数配置项说明Bundle ID与 Apple 开发者中心 App ID 一致支持设备至少勾选 iPhoneiPad 按需证书私钥密码.p12文件的密码私钥证书上传.p12文件证书 profile 文件上传.mobileprovision文件点击「打包」等待云端编译打包完成后下载.ipa文件位于项目目录/unpackage/release/4.3 本地离线打包进阶菜单发行 → 原生 App-本地打包 → 生成本地打包 App 资源使用 Xcode 打开官方离线打包工程修改control.xml中的appid配置 Signing Capabilities选择 Team 和 Bundle ID「Product → Archive」打包导出 IPA本地打包必须在 Mac 环境下进行。五、测试环境二维码生成与扫码下载打包完成后如何让测试人员方便地扫码下载安装包以下是三种主流方案。5.1 方案一DCloud 云打包历史版本 在线二维码生成最简单操作步骤登录 DCloud 开发者中心进入「应用管理」→ 选择你的应用 → 「云打包」在「打包历史」中找到刚打包成功的记录复制下载链接APK 或 IPA 的下载地址注意DCloud 云打包的下载链接有时效性通常 7 天不适合长期分发。使用在线二维码生成工具将下载链接转为二维码草料二维码微微二维码或使用 Pythonqrcode库本地生成# 本地生成二维码示例importqrcode urlhttps://你的安装包下载链接imgqrcode.make(url)img.save(test_qrcode.png)适用场景快速验证、小范围测试链接有效期内使用5.2 方案二第三方测试分发平台推荐团队使用国内主流平台平台网址特点蒲公英pgyer.com国内最常用支持 Android/iOS免费版有次数限制fir.imfir.im老牌分发平台界面简洁测试侠-支持崩溃分析、反馈收集以蒲公英为例的操作流程注册并登录蒲公英平台点击「发布应用」→ 上传打包好的 APK / IPA 文件填写应用信息名称、版本、更新说明上传完成后平台自动生成下载页面和二维码测试人员扫码 → 打开下载页 → 点击安装iOS 扫码安装的关键前提iOS 不能像 Android 那样直接扫码安装 IPA必须满足以下条件之一证书类型安装方式设备限制Development 证书扫码安装必须在描述文件中注册设备 UDIDAd Hoc 证书扫码安装必须在描述文件中注册设备 UDID最多 100 台/年Enterprise 企业证书扫码安装无设备数量限制但需信任企业证书App Store 证书不能直接安装必须通过 TestFlight 或 App Store企业证书安装步骤测试人员端扫码下载并安装 IPA打开「设置 → 通用 → VPN与设备管理」找到企业证书点击「信任」返回桌面打开 App注意苹果对企业证书管控严格禁止用于大规模分发违规可能导致证书被吊销。5.3 方案三自建下载页面完全可控适合有服务器资源、需要完全掌控分发流程的团队。实现步骤上传安装包到服务器或对象存储阿里云 OSS、腾讯云 COS、七牛云等创建下载页面HTML包含应用图标、名称、版本号Android 下载按钮直接链接 APKiOS 下载按钮需要特殊处理见下文生成二维码将下载页面 URL 转为二维码iOS 自建分发的特殊处理iOS 企业证书分发需要通过itms-services协议不能直接链接 IPA!-- iOS 安装按钮 --ahrefitms-services://?actiondownload-manifesturlhttps://你的域名/manifest.plist点击安装 iOS 版/a还需要创建manifest.plist文件?xml version1.0 encodingUTF-8?!DOCTYPEplistPUBLIC-//Apple//DTD PLIST 1.0//ENhttp://www.apple.com/DTDs/PropertyList-1.0.dtdplistversion1.0dictkeyitems/keyarraydictkeyassets/keyarraydictkeykind/keystringsoftware-package/stringkeyurl/keystringhttps://你的域名/yourapp.ipa/string/dict/arraykeymetadata/keydictkeybundle-identifier/keystringcom.yourcompany.appname/stringkeybundle-version/keystring1.0.0/stringkeykind/keystringsoftware/stringkeytitle/keystring你的应用名称/string/dict/dict/array/dict/plist重要iOS 分发要求服务器支持 HTTPS且证书有效。5.4 三种方案对比对比项方案一DCloud链接方案二第三方平台方案三自建上手难度极低低中成本免费免费/付费服务器成本链接有效期7天长期长期iOS 支持有限完善需自行配置下载统计无有自行实现品牌定制无有限完全自定义适用场景快速测试团队协作正式内测六、常见问题排查6.1 Android 相关Q云打包失败提示「证书错误」A检查证书库密码和证书密码是否正确证书别名是否存在于 keystore 中。可用以下命令查看证书信息keytool-list-v-keystoreyour.keystoreQ安装 APK 时提示「解析包错误」A可能是 APK 下载不完整或 Android 版本过低不兼容。检查manifest.json中的「最低支持版本」设置。Q上架应用市场提示签名不一致A应用市场要求同一应用的所有版本使用相同签名证书务必妥善保管.keystore文件丢失后无法更新。6.2 iOS 相关Q云打包失败提示「证书与描述文件不匹配」A确保.p12证书和.mobileprovision描述文件是同一 App ID、同一类型开发/发布。Q扫码安装后闪退无法打开A检查设备 UDID 是否已添加到描述文件中Development/Ad Hoc 证书。企业证书需在设置中信任证书。QTestFlight 如何使用A使用 App Store 证书打包 IPA上传到 App Store Connect添加测试人员 Apple ID通过 TestFlight 安装无需注册 UDID。6.3 二维码分发相关QiOS 扫码后提示「无法连接到服务器」A检查下载页面和manifest.plist是否为 HTTPSSSL 证书是否有效。Q二维码扫描后下载速度慢A建议使用 CDN 或对象存储加速安装包较大时尤其重要。Q如何防止安装包被恶意下载A第三方平台通常支持密码保护、下载次数限制自建方案可添加 Token 校验或 IP 白名单。七、总结与建议7.1 推荐工作流开发完成 → manifest.json 配置检查 → 云打包测试证书 → 上传蒲公英/自建平台 → 生成二维码 → 测试人员扫码安装 → 测试通过 → 云打包正式证书 → 上架应用市场7.2 最佳实践开发阶段Android 用云证书iOS 用 Development 证书 蒲公英分发测试阶段Android 用正式证书打包iOS 用 Ad Hoc 或企业证书分发发布阶段Android 各渠道分别打包iOS 用 App Store 证书上传证书管理建立证书台账记录证书类型、有效期、保管人到期前 30 天预警版本管理versionCode每次打包递增避免上架时版本号冲突7.3 成本参考项目费用DCloud 云打包免费有每日次数限制/ 付费套餐Apple 开发者账号99 美元/年个人/公司蒲公英专业版约 199 元/月起阿里云 OSS 存储按实际使用量约 0.12 元/GB/月文档版本v1.0更新日期2026-08-11适用版本HBuilderX 4.31 / uni-app x如有疑问或补充欢迎在评论区交流。