如今在蘋果開發者網站上已經能下載 Xcode 8 的 GM 版本,而 iOS 10 的正式推送也近在眼前。對仍在維護線上項目的團隊來說,適配工作幾乎沒有拖延的餘地。Xcode 8 從 Beta 一路迭代到 GM,體驗上確實比早期版本穩定了不少,但坑依然存在。下面把我在實際項目中踩過的問題按模塊梳理一遍,供大家提前避開。
用 Xcode 8 打開工程,最先撲面而來的變化就是簽名界面多出了「Automatically manage signing」勾選項,這是蘋果這一代推出的自動證書管理機制,官方建議直接開啟。

實際使用中可能遇到幾類報錯:

處理方式很簡單:打開 Xcode 的 Preferences,在 Accounts 中添加你的蘋果開發者賬號即可。

登錄開發者官網,把測試機的 UDID 添加到 Devices 列表,然後重新下載一份描述文件。
賬號配置妥當後,Xcode 會自動完成證書申請與描述文件生成,耐心等待即可。

等待結束後的界面如下:

補充一句:Beta 2 時期這個自動管理功能基本不可用,直到 GM 版本才終於恢复正常,如果你的團隊還停留在早期 Beta,建議直接升到 GM。
用 Xcode 8 打開老工程的 xib,會彈出一個提示框:

直接點擊 Choose Device 繼續。接下來你會發現界面上的約束和 frame 有些錯位,只需要重新更新一下 frame 就能恢復:

需要注意的是,按上述步驟保存之後,再用 Xcode 7 打開同一個 xib 就會報錯:

如果實在需要雙向兼容,可以手動刪除 xib 中的這一行:
<capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
並把 <document> 標簽的 toolsVersion 以及 <plugIn> 標簽的 version 改回舊值。不過並不推薦這麼折騰——就像當年從 Xcode 5 邁向 Xcode 6 一樣,界面文件格式一旦升級就很難回頭。與其在兼容上耗時間,不如趁早帶著團隊整體升上來。
換用 Xcode 8 之後,部分舊代碼會直接編譯失敗,這裡說一個我實際碰到的例子。
新的 SDK 對 nullability 註解要求更嚴格,NSError 前面的 nullable 必須去掉,否則報錯:
- (void)webView:(UIWebView *)webView didFailLoadWithError:(NSError *)error {
[self hideHud];
}
這是因為蘋果為了排查 XcodeGhost 事件,把第三方插件整體屏蔽了,依賴插件的注釋快捷鍵自然也跟著失效。
解法:打開終端執行
sudo /usr/libexec/xpccachectl
命令執行完後必須重啟系統才會生效。
好消息是 Xcode 8 已經內置了注釋功能,入口在菜單裡:

如果習慣用快捷鍵,可以在 Key Bindings 裡自行綁定:

Xcode 8 基本上關閉了第三方源碼編輯插件的能力,細節可以參考 Xcode 8 Source Editor 的相關說明。
iOS 10 收緊了隱私訪問策略,凡是要讀取用戶數據的功能,都必須在 info.plist 中補上用途說明,否則 App 一調用就 crash。添加時注意 key 的末尾不要多打空格。

常用對照如下:
麥克風:Privacy - Microphone Usage Description
相機:Privacy - Camera Usage Description
相冊:Privacy - Photo Library Usage Description
通訊錄:Privacy - Contacts Usage Description
藍牙:Privacy - Bluetooth Peripheral Usage Description
語音識別:Privacy - Speech Recognition Usage Description
日歷:Privacy - Calendars Usage Description
定位(使用期間):Privacy - Location When In Use Usage Description
定位(始終):Privacy - Location Always Usage Description
定位部分的文案建議寫清楚用途,例如「我們需要通過您的地理位置信息獲取您周邊的相關數據」,否則提審時容易被拒。
iOS 10 調整了系統字體,有同行發現原本兩個漢字的寬度是 24pt,現在同樣兩個字要 27pt 才擺得下。凡是寫死寬度的按鈕、Label 都可能出現截斷或換行。如果你有更好的批量適配思路,歡迎一起交流。
Target 的 Capabilities 裡,Push Notifications 這個開關千萬記得打開。無論你用的是極光還是其他第三方推送服務,這一步都是前置條件。

打開之後推送通道基本就通了。另外極光也推出了對應 iOS 10 的新版本 SDK,可以順手升級。
需要特別提醒的是,蘋果這次對通知體系做了大改,處理通知的代理方法完全換了一套。iOS 10 之後,通知的接收與處理不再走 application:didReceiveRemoteNotification:,而是交給 UserNotifications 框架的統一代理,本地通知和遠程通知共用同一套邏輯:
// 應用在前台收到通知
- (void)userNotificationCenter:(UNUserNotificationCenter *)center
willPresentNotification:(UNNotification *)notification
withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler {
NSLog(@"========%@", notification);
}
// 用戶點擊通知進入應用
- (void)userNotificationCenter:(UNUserNotificationCenter *)center
didReceiveNotificationResponse:(UNNotificationResponse *)response
withCompletionHandler:(void (^)())completionHandler {
NSLog(@"response:%@", response);
}
後續我會專門写一篇文章細講通知框架的用法。
升級 Xcode 8 之後新建工程,控制台會刷出一大堆看不懂的系統日誌,例如:
subsystem: com.apple.UIKit, category: HIDEventFiltered, enable_level: 0, persist_level: 0, default_ttl: 0, info_ttl: 0, debug_ttl: 0, generate_symptoms: 0, enable_oversize: 1,
屏蔽方式:Edit Scheme → Run → Arguments,在 Environment Variables 中添加
OS_ACTIVITY_MODE = Disable

如果添加之後仍然照舊打印,把那一行的勾選框取消再重新勾上就能生效。
需要注意的副作用是:加上這個環境變量後,真機調試時系統日誌也一併被屏蔽了。更穩妥的做法是自己封裝一層日誌宏,把輸出可控地握在手裡:
#ifdef DEBUG
#define DDLOG(...) printf(" %s\n", [[NSString stringWithFormat:__VA_ARGS__] UTF8String]);
#define DDLOG_CURRENT_METHOD NSLog(@"%@-%@", NSStringFromClass([self class]), NSStringFromSelector(_cmd))
#else
#define DDLOG(...) ;
#define DDLOG_CURRENT_METHOD ;
#endif
以上就是我在 iOS 10 與 Xcode 8 適配過程中整理的重點,希望能幫大家少走幾段彎路。