iOS應用安裝失敗原因排查

SuperDanny發表於2017-12-13

本文結合蒲公英以及FIR兩家應用託管平臺的博文進行整理

前言

iOS 的內測應用在安裝時,很多人都遇到過安裝失敗的情況,安裝失敗的原因比較多,下面將一些常見原因總結如下,方便開發者進行排查。

在 iOS 9 中啟動應用時,出現提示“未受信任的企業級開發者”

這樣問題是因為在 iOS 9 以後的版本中,蘋果對企業簽名的應用做了更嚴格了限制。具體解決辦法請見: 企業級證書打包下載安裝之後無法使用問題

在 iOS 9 中點選“安裝”按鈕後,沒有彈出“是否安裝”的提示

這個問題是因為 iOS 9 的一個 Bug 導致的。出現這個問題的前提,一般是由於使用者已經從蘋果官方 App Store 上安裝了相同的應用。

【解決辦法】

先在裝置中刪除之前已經安裝的應用,然後再從託管平臺安裝即可。

為什麼在 iOS 9 中,點選“安裝”按鈕後,沒有任何反應,桌面也沒有出現應用圖示,但是狀態列上的網路圖示在轉

這是由於 iOS 9 中的一個 Bug 造成的。雖然看上去沒有反應,其實應用已經在後臺開始下載並安裝了,狀態列上的網路圖示在轉就是一個證明。這個時候,只要多等待一會兒就好了,應用安裝完成之後會在桌面上顯示出來的。

應用安裝過程中提示"無法下載應用程式"

原因一:在匯出 iOS App 的安裝包檔案( .ipa 檔案)時,選擇了 App-Store 方式。

在匯出 iOS 的.ipa檔案時,有些開發者選擇了App-Store方式,這種方式匯出的.ipa檔案,只適合於上傳到蘋果App Store,並不能通過託管平臺來安裝。如果是這種方式匯出的 .ipa檔案,傳到託管平臺上是不能通過安裝的。

原因二:在匯出 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。

原因六:開發者上傳的是一個破解的 ipa 安裝包,或者是一個使用破解 Xcode 方式打包生成的 ipa 安裝包,或者是通過 iTunes 生成的 ipa 安裝包。

通過任何非 Xcode(或 Xcode 的命令列工具)生成的安裝包,都是沒有辦法正確在裝置上安裝的(越獄裝置除外)。

常見的不正確的打包 ipa 的方式有: 通過 iTunes 匯出安裝包檔案通過 iTools 匯出安裝包檔案等等。這種型別的 App 上傳到託管平臺後,會顯示未簽名的標籤提示。

【正確的方法】

使用一個正常的蘋果開發者證書,通過未破解的 Xcode 打包生成 ipa 安裝包。

原因七:裝置上已經安裝了這個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

原因九:網路出現中斷或異常。

遇到這種情況,使用者可檢查自己手機的所連線的網路是否穩定、速度是否正常等。可以嘗試一下其他網站,或者更換一個 Wi-Fi,或者由 Wi-Fi 換成 3G/4G 等,然後重新安裝。


【託管平臺】: 託管平臺是指將APP釋出於第三方平臺上面,供使用者安裝測試。常見的託管平臺有蒲公英以及FIR

【App-Store】: App-Store版,用於釋出到蘋果商店

【Ad-hoc】: 內測版,用於內部指定裝置使用

【In-house】: 企業版,可在任何裝置上安裝,但不能濫用


再一次感謝您花費時間閱讀這篇文章!

微博: @Danny_呂昌輝
部落格: SuperDanny

相關文章