iOS 应用安装失败排查

在 iOS 设备上安装蒲公英分发的应用时，可能会遇到 无法安装、无法验证、安装失败 等提示。本文整理常见原因和处理方式。

提示“无法安装”“无法验证”或图标变暗

这种情况大多由应用签名不正确导致，常见原因包括：

• 证书过期：签名证书过期后应用无法安装；
• 配置文件错误：Provisioning Profile 与 Bundle Identifier 或证书不匹配；
• UDID 未添加：Ad-Hoc 分发时，设备 UDID 未加入配置文件。

您可以先尝试以下操作：

1. 检查设备上是否已安装同一应用，若有，卸载后重试；
2. 仍无法解决时，请联系邀请您安装的开发者处理签名问题。

未受信任的企业级开发者

对于企业级分发的应用，首次安装后需要手动信任证书：

1. 回到桌面，依次打开 设置 > 通用 > VPN 与设备管理；
2. 点击对应描述文件进入，点击 信任。

未启用开发者模式

iOS 16 及以上版本安装 Ad-Hoc 应用前必须启用开发者模式：

1. 打开 设置 > 隐私与安全性；
2. 向下滚动找到 开发者模式 并点击进入；
3. 打开开关，按提示输入设备密码并重启设备。

启用后即可正常安装和运行 Ad-Hoc 分发的应用。

系统版本不兼容

请确认应用声明的最低 iOS 版本，若设备系统版本过低，需要先升级系统。

网络不稳定

安装过程中需要下载安装包，请确保设备连接到稳定的 Wi-Fi 网络，避免因网络中断导致下载失败。

存储空间不足

请确认设备剩余空间足以容纳应用，如不足请先清理文件或卸载不必要的应用。

与旧版本冲突

设备上已安装旧版本时，可能因签名或包名冲突导致新版本安装失败，建议卸载旧版本后重试。

机型兼容性

部分应用依赖的框架或功能仅在较新机型上可用，请确认目标设备是否在应用支持范围内。