系統版本一更新,開發者就得跟著調整,否則使用者升級後新功能不能用、舊功能又壞掉,體驗大打折扣。升級到 Xcode 8 之後整體對 Objective-C 的影響不大,但仍有幾個坑值得先記下來,免得耗時間在查錯方向。
iOS 10 開始,只要 App 存取相機、相簿、聯絡人、定位等受保護資源,而 Info.plist 中缺少對應的用途說明字串,App 會直接終止,而不是像以往那樣只是跳警告。解法是在 Info.plist 補上描述文字:


以下是各項資源的 key,用到哪個補哪個(Value 請寫清楚「為什麼需要這個權限」,Apple 審核會看):
NSBluetoothPeripheralUsageDescription NSCalendarsUsageDescription NSCameraUsageDescription NSContactsUsageDescription NSHealthShareUsageDescription NSHealthUpdateUsageDescription NSHomeKitUsageDescription NSLocationAlwaysUsageDescription NSLocationWhenInUseUsageDescription NSMicrophoneUsageDescription NSMotionUsageDescription NSPhotoLibraryUsageDescription NSRemindersUsageDescription NSSiriUsageDescription NSSpeechRecognitionUsageDescription NSVideoSubscriberAccountUsageDescription NSVoIPUsageDescription
補充一點:定位權限在 iOS 10 另有 NSLocationAlwaysAndWhenInUseUsageDescription,而 iOS 11 之後只寫 NSLocationAlwaysUsageDescription 會直接編譯失敗,若專案要往後相容,建議一次把新版 key 補齊。
這個坑最難查。症狀是第三方登入(例如友盟分享授權)回來之後沒有回調,log 裡只看到 PBItemCollectionServicer connection disconnected 這類訊息,完全摸不著頭緒。
原因是 iOS 9 起引入了新方法,iOS 10 之後舊版 application:openURL:sourceApplication:annotation: 的行為不再可靠,必須改用帶 options 參數的版本:
- (BOOL)application:(UIApplication *)app
openURL:(NSURL *)url
options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options {
// 在這裡解析 url 的 host / scheme,分派給各個第三方 SDK
return YES;
}
若需要同時支援舊系統,就把兩個版本都實作,並在舊方法中轉呼叫新方法。
升級後發現 App 介面語言跑掉了,解法是檢查 Target 的 Use Base Internationalization 設定:

取消勾選 Base Internationalization 之後重新 build,語言即可恢復正常。
無論用的是哪家服務(本文以極光推送為例,其他家同理),iOS 10 之後必須在 Target 的 Capabilities 中打開 Push Notifications 開關,並確認 App ID 已開通對應能力,否則 token 拿不到或註冊失敗。

另外,iOS 10 新增了 UserNotifications 框架,通知的呈現樣式與攔截時機都由它接手,舊的 didReceiveRemoteNotification: 仍可用,但要做自訂通知外觀或前進背景服務,就得改用 UNUserNotificationCenter 的代理方法。
升級後 Command + / 註解快捷鍵偶爾會失灵,重開 Xcode 或重啟機器多半就恢復(這個問題在 8.1 之後明顯改善)。若還是沒救,可以試試在終端機重建快取:
sudo /usr/libexec/xpccachectl
執行後必須重啟電腦才會生效。
把這份清單收好,升級大版本時先照順序自查:權限 key、openURL 回調、Base Internationalization、Push Capability。這四項差不多涵蓋了絕大多數「升級後就壞掉」的狀況,剩下的多是 Xcode 自身的小毛病,重開通常就好。