蒲公英文档中心

iOS 应用安装失败原因排查

iOS 的内测应用在安装时,很多人都遇到过安装失败的情况,安装失败的原因比较多,下面我们将一些常见原因总结如下,方便开发者进行排查。

启动应用时,出现提示“未受信任的企业级开发者”

请回到 iOS 系统桌面,然后依次打开 设置 - 通用 - 描述文件与设备管理,然后,点击对应描述文件进入后,再点击按钮 信任即可。具体解决办法请见: 运行企业版应用

应用安装快结束后,图标变为暗色图标,或弹出”无法安装XXX“的提示

如果您是该应用的开发者,请检查应用的签名是否正确,这个问题出现的原因一般是由于应用的签名不正确导致的。一般来说,对于 Adhoc 签名方式重点检查当前设备 UDID 是否已经注册;对于 In-house 签名(即企业签名) 方式来说,需要重点检查证书是否被撤销。如果您不是这个应用的开发者,请联系开发者解决。

注意:有些开发者购买了第三方的苹果企业签名服务,很容易导致在使用一段时间后,签名用的证书被商家撤销导致 App 无法安装。推荐开发者可以购买更加稳定可靠的蒲公英超级签名服务

在网页中点击“安装”按钮后,没有弹出“是否安装”的提示,或者提示安装失败

这个问题出现的原因,一般是由于用户已经从苹果官方 App Store 上安装了相同的应用。解决办法是:先在您的设备中删除之前已经安装的应用,然后再从蒲公英安装即可。

安装应用时,出现提示“无法连接到 www.pgyer.com”

这个问题一般是由于用户的网络,或者手机缓存错误造成的,可以尝试如下两个方法来解决:

  • 重启手机,然后尝试重新安装。
  • 换一个网络环境,例如换一个 Wi-Fi 热点,或由 Wi-Fi 换成 3G/4G 等,然后重新安装。

其他一些可能导致应用无法安装的原因:

原因一:开发者在打包App时,导出 iOS App 的安装包文件(.ipa文件)时,选择了 App-Store 方式。

在导出 iOS 的 .ipa 文件时,有些开发者选择了 App-Store 方式,这种方式导出的 .ipa 文件,只适合于上传到苹果 App Store,并不能通过蒲公英来安装。如果是这种方式导出的 .ipa文件,传到蒲公英上时,蒲公英会显示“App-Store版”,这种版本是不能通过蒲公英安装的。

原因二:在导出 iOS App 的安装包文件(.ipa文件)时,选择了 Ad-hoc 方式,但是没有添加设备 UDID。

在导出 iOS 的安装包文件时,如果选择了 Ad-hoc 方式(一般用于苹果个人开发者账户),那么,如果要某台设备可以安装,则必须要将这台设备的 UDID 添加到导出安装包时所用的证书文件中(. mobileprovision文件),才可以在这台设备上安装。

使用 Ad-hoc 方式导出的安装包文件上传到蒲公英后,蒲公英会显示为“内测版”,同时会在应用管理中,显示出该安装包的证书中包含的 UDID 列表。开发者可以根据显示出的 UDID 列表,来排查某台设备的 UDID 有没有被添加到安装包的证书中。

原因三:在导出 iOS App 的安装包文件(.ipa文件)时,选择了 In-house 方式,但是证书已过期或被撤销。

在导出 iOS 的安装包文件时,如果选择了 In-house 方式(一般用于苹果企业开发者账户),此时,如果出现无法安装的情况,开发者可以检查一下自己的企业开发者证书是否已过期或是否被撤销。因为苹果对于企业开发者证书管理较为严格,所以开发者如果使用不当,可能会导致企业证书被苹果官方撤销,被撤销后的企业证书导出的安装包,也是无法正确安装的。

原因四:开发者在生成App安装包时,没有在 Xcode 中设置正确的 Architecture。

iOS 应用的 Architecture(架构),决定了这款 iOS 应用可以在哪些设备机型上安装。例如,如果某个应用在 Xcode 中只添加了 arm64 这一种 Architecture,那么最终打包后的安装包文件上传到蒲公英后,对于 iPad mini、iPhone5 等以下设备,都是无法安装的(因为这些设备都不是 arm64 架构)。换句话说,如果需要在某个设备上可以安装,App 就必须支持那个设备的 Architecture。

所以,正确的解决方法是,在生成 App 安装包时,尽可能让 App 支持更多的 Architecture。

具体操作方法是:在 Xcode - Build Settings - Architecture 中,增加 armv7armv7sarm64,以便所有设备都可以安装。然后,将 "Build active architecture only" 设置为 NO。对于各个 iOS 设备支持的 Architecture 类型。请点击这里查看

原因五:App 支持的 iOS 系统版本,和当前设备系统版本不符。

App 支持的 iOS 系统版本过低或者过高,都可能导致 App 无法安装成功。例如,如果某个 App 设置了只支持 iOS 11.0 以上的系统时,那么,如果在低于这个版本的系统上安装时,是无法安装成功的。

因此,解决的方法也很简单,我们应该尽量让 App 尽可能支持更宽泛的系统版本。

具体操作方式是:在 Xcode - General - Deployment Info - Deployment Target 中,给 App 设置一个尽量低的版本,例如 iOS 6.0。

原因六:设备上已经安装了这个App,且已经安装的 App 和要安装的 App 是用不同证书打包的。

这种情况下,也会造成 App 安装失败。解决的方式很简单,用户只需将设备上原来已经安装的 App 删除,再重新安装新的 App 即可。

原因七:Info.plist 文件中的LSRequiresIPhoneOS 没有设置,或者设置了 NO

对于 iOS 的 App 来说,如果Info.plist 文件中的LSRequiresIPhoneOS 没有设置,或者设置了 NO,那么由 Xcode 导出的安装包(.ipa 包),就不会包含 Payload 文件夹,而是被一个叫做 Applications 的文件夹代替。这样的安装包在安装时,会被 iOS 判定为无效的安装包,所以无法被正确安装。

解决方式也很简单,只需要将Info.plist 文件中的LSRequiresIPhoneOS 设置为 YES,然后重新打包即可。具体操作为:在 Xcode 中打开 Info.plist 文件,然后检查 LSRequiresIPhoneOS 是否已设置,如果没有设置,就添加一个,然后将 LSRequiresIPhoneOS 的类型设置为 Boolean,值设置为 YES

设置好以后,可以看到 Info.plist 文件中显示 Application requires iPhone environment 的值为 YES

另外,还可以使用蒲公英的 Mac OS 客户端 来打包上传 App,蒲公英的 Mac OS 客户端在打包安装包时,自动处理了这个问题。

原因八:网络出现中断或异常。

遇到这种情况,用户可检查自己手机的所连接的网络是否稳定、速度是否正常等。能否打开其他网站,或者更换一个 Wi-Fi,或者由 Wi-Fi 换成 3G/4G 等,然后重新安装。

用这样的方式尝试后,一般都可以解决问题。

尝试过以上方案,还是无法解决?

如果根据以上的方式进行排查后,依然无法解决问题,那么可以使用蒲公英的 Mac OS 客户端来查看安装日志。

蒲公英的 Mac OS 客户端中,提供了实时查看 App 安装日志的功能,开发者可以方便的根据 App 的安装日志,来准确的判断具体安装失败的原因,具体方法请见:查看iOS的安装日志