云打包前必须填对的三个关键配置项是appid、dcloud_appkey、android包名和ios bundle id；三者须与uni-app后台、苹果/安卓平台注册信息完全一致，否则导致安装失败或闪退。
云打包前必须填对的三个关键配置项
uni-app 的内测分发，第一步不是上传、不是扫码，而是确保 HBuilderX 里那几个藏得挺深的配置项填得完全正确——填错一个，打包出来的 .apk 或 .ipa 就可能安装失败、闪退、甚至根本打不开。这不是玄学，是 DCloud 云端编译时校验签名和权限的硬门槛。
-
appid：必须和 uni-app 后台「我的应用」中该项目的 AppID 完全一致，大小写、下划线都不能差；它决定了你的包能不能被 DCloud 服务识别并注入运行时环境 -
dcloud_appkey：iOS 云打包强制要求，要从后台「各平台信息 → iOS」里复制，不是你随便写的字符串；漏填或粘贴错一位，Xcode 工程生成阶段就会中断，日志里只报appkey invalid -
Android 包名（package name）和iOS Bundle ID：必须和你在苹果开发者中心 / 华为/小米等平台注册的证书、描述文件里声明的一致；比如你在 Apple Developer 里配的是com.mycompany.myapp，HBuilderX 里就不能写成com.mycompany.myapp.dev
蒲公英上传后 iOS 安装失败的典型原因
安卓用户扫完二维码点几下就装上了，iOS 用户却卡在「无法验证开发者」或「未受信任的企业级开发者」——这几乎 100% 不是蒲公英的问题，而是证书链没走通。蒲公英只是个分发管道，它不参与签名，也不改描述文件。
- 用 Ad-Hoc 打包但没把测试机
UDID加进描述文件？设备列表一超限，安装直接白屏 - 用了企业签名（In-House），但企业证书已过期或被苹果吊销？打开设置 → 通用 → 设备管理 → 点击对应开发者名称，会显示「此证书已过期」
- 蒲公英页面启用了「强制 HTTPS 下载」，而你的企业证书不支持 ATS（App Transport Security）？iOS 15+ 会静默拦截，连错误提示都不给
- 上传的是 Debug 版
.ipa，但描述文件是 Release 类型？Xcode 编译时不会报错，但蒲公英分发后安装必失败
安卓安装提示「禁止安装未知来源应用」怎么绕过又合规
这不是 bug，是 Android 8.0+ 的系统级限制。强行关掉「未知来源」开关既不安全，也不可持续——尤其面对几十个测试人员时。真正省事的做法，是让安装行为本身「看起来像官方渠道」。
- 用蒲公英生成的下载页，本身就是 HTTPS 域名（如
https://www.pgyer.com/xxx），符合 Android 对「可信网页」的判定逻辑 - 避免直接提供
.apk文件链接；用户点击蒲公英页面上的「安装」按钮，系统会认为这是由可信网页触发的安装，自动临时豁免部分限制 - 如果仍被拦截，在 HBuilderX 打包时勾选「使用 V2 签名方案」——这是 Android 7.0+ 强制要求，旧版 V1 签名在新系统上会被直接拒绝安装
- 别信网上那些「一键开启未知来源」的 adb 命令，测试机一旦重启就失效，且部分厂商（如华为 EMUI）已彻底禁用该接口
测试人员扫码后页面空白或加载不出安装按钮
蒲公英页面打不开、没下载按钮、一直转圈——90% 是前端资源加载被拦截或缓存异常，和你的代码无关，但和你发链接的方式强相关。
- 别用微信「外部浏览器打开」后再扫码，微信内置浏览器对蒲公英 JS SDK 支持不稳定；让测试人员用 Safari（iOS）或 Chrome（Android）直接访问链接
- 蒲公英链接带参数如
?channel=weixin，某些企业微信/钉钉会自动过滤 query 参数，导致跳转后丢失版本标识，页面降级为空白；建议用无参短链 + 版本说明文字替代 - 上传包时没填「版本更新说明」，蒲公英默认不展示安装按钮（尤其 iOS）；哪怕只写「内测版 v1.0.0」，也能触发 UI 渲染
- 检查是否误开了蒲公英的「仅限指定域名访问」功能，而测试人员是从微信群直接点开的——域名白名单里没加
weixin.qq.com，页面就真的一片空白
appid，都必须重新云打包——不能复用上次的安装包。很多人以为“只是换个签名”，结果分发出去的包在新设备上跑不起来，查半天才发现是云端缓存的老工程。
