iOS 应用安装失败原因排查

UDID 和修改成realease

原因一:在导出 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
中,增加 armv7
、armv7s
、arm64
,以便所有设备都可以安装。然后,将 "Build active architecture only"
设置为 NO
。对于各个 iOS 设备支持的 Architecture 类型。请点击这里查看。
原因五:App 支持的 iOS 系统版本,和当前设备系统版本不符。
App 支持的 iOS 系统版本过低或者过高,都可能导致 App 无法安装成功。例如,如果某个 App 设置了只支持 iOS 7.0 以上的系统时,那么,如果在 iOS 6.1 系统上安装时,肯定是无法安装成功。
因此,解决的方法也很简单,我们应该尽量让 App 尽可能支持更宽泛的系统版本。
具体操作方式是:在 Xcode

  • General
  • Deployment Info
  • Deployment Target
    中,给 App 设置一个尽量低的版本,例如 iOS 5.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 等,然后重新安装。
    用这样的方式尝试后,一般都可以解决问题。
    原因九:iOS10中未添加权限
    iOS10 需要添加新权限管理,需要声明 Privacy - Microphone Usage Description( http://stackoverflow.com/questions/38498275/ios-10-changes-in-asking-permissions-of-camera-microphone-and-photo-library-c )
    尝试过以上方案,还是无法解决?
    如果根据以上的方式进行排查后,依然无法解决问题,那么可以使用蒲公英的 Mac OS 客户端来查看安装日志。
    蒲公英的 Mac OS 客户端中,提供了实时查看 App 安装日志的功能,开发者可以方便的根据 App 的安装日志,来准确的判断具体安装失败的原因,具体方法请见:查看iOS的安装日志

你可能感兴趣的:(iOS 应用安装失败原因排查)