iOS 10 正式推出之後,Xcode 也隨之更新到 8.0。本來只是想給舊專案推一個小版本,代碼改完、Archive 打包也順利,偏偏在 iTunes Connect 後台怎麼都等不到「正在處理」的構建版本出現,實在令人頭疼。下面把常見原因與處理方式整理出來。
如果你的 App 是付費下載的,Apple 要求開發者先同意最新的付費應用協議(Paid Applications Agreement),否則新版本根本無法進入構建流程。免費 App 可以跳過這一步。
無論你用 Xcode 的 Organizer 上傳,還是透過 Application Loader 手動上傳,只要登入 iTunes Connect 之後看不到「待提交版本」,而且構建版本列表裡一直沒有那個可以勾選的藍色圓圈,就不要再乾等下去了。這種情況通常代表 IPA 包本身有問題——哪怕上傳環節提示一切正常。回頭翻一翻之前的構建記錄,會發現那些版本狀態全都異常。
在 Xcode 8 環境下,App 必須完成隱私用途說明(Privacy Usage Description)的適配,否則打包出的二進位會被判為無效。做法是在 Info.plist 中補上對應的 Key 與說明文字,例如:
<key>NSAppleMusicUsageDescription</key> <string>App 需要您的同意,才能存取媒體資料庫</string> <key>NSBluetoothPeripheralUsageDescription</key> <string>App 需要您的同意,才能使用藍牙</string> <key>NSCalendarsUsageDescription</key> <string>App 需要您的同意,才能存取日曆</string> <key>NSCameraUsageDescription</key> <string>App 需要您的同意,才能使用相機</string> <key>NSHealthShareUsageDescription</key> <string>App 需要您的同意,才能存取健康分享資料</string> <key>NSHealthUpdateUsageDescription</key> <string>App 需要您的同意,才能更新健康資料</string> <key>NSLocationAlwaysUsageDescription</key> <string>App 需要您的同意,才能持續使用您的位置資訊</string> <key>NSLocationWhenInUseUsageDescription</key> <string>App 需要您的同意,才能在使用期間存取您的位置</string> <key>NSMicrophoneUsageDescription</key> <string>App 需要您的同意,才能使用麥克風</string> <key>NSMotionUsageDescription</key> <string>App 需要您的同意,才能存取運動與健身資料</string> <key>NSPhotoLibraryUsageDescription</key> <string>App 需要您的同意,才能存取相簿</string> <key>NSRemindersUsageDescription</key> <string>App 需要您的同意,才能存取提醒事項</string>
補齊之後重新 Archive、上傳,構建版本通常就能正常出現了。要注意的是,說明文字不能留空,空白字串同樣會導致包被判為無效。