升級系統或換 Xcode 版本時,最常做的第一件事就是查 API 差異文檔。蘋果官方的 What's New in iOS 系列提供了逐版本的完整對比,本文把常用入口和框架變化整理出來,方便隨時翻查。
官方匯總入口:What's New in iOS,以及各版本的 iOS x.x to iOS y.y API Differences。
iOS 9.3 到 iOS 10.0 的框架變化
iOS 10 是一次比較大的更新,Objective-C 與 Swift 兩側都新增了一批框架。標註「(新增)」的即為該版本引入。
Objective-C 側新增框架
- CallKit(新增)——VoIP 通話接入系統來電界面
- Intents(新增)、IntentsUI(新增)——SiriKit 相關,讓 App 能被 Siri 調用
- Messages(新增)——iMessage 應用擴展
- Speech(新增)——語音識別轉文字
- UserNotifications(新增)、UserNotificationsUI(新增)——統一的通知體系與自定義通知界面
- VideoSubscriberAccount(新增)——付費電視帳號登錄
其餘框架(Accelerate、AudioToolbox、AVFoundation、CloudKit、Contacts、CoreBluetooth、CoreData、CoreLocation、CoreSpotlight、Foundation、GameKit、HealthKit、HomeKit、MapKit、Metal、Photos、QuartzCore、ReplayKit、SafariServices、SceneKit、SpriteKit、UIKit、WebKit 等)延續原有版本,接口上有增補。
Swift 側的變化
Swift 側同樣新增了 CallKit、Intents、IntentsUI、Messages、Speech、UserNotifications、UserNotificationsUI、VideoSubscriberAccount 等框架,同時:
- iAd(新增)與 iAdJS(移除)——iAd 相關命名空間在此版本被調整
- Twitter(移除)
- 新增了 Darwin、Dispatch、GSS、libkern、MachO、ObjectiveC、OpenAL、os、simd、Swift 等一批底層與系統模塊,讓 Swift 能更直接地訪問 C 層能力
- HealthKitUI、ContactsUI、MediaAccessibility、MediaToolbox、MultipeerConnectivity、PhotosUI、Social、StoreKit 等延續支持
歷史版本差異文檔索引
更早的版本對比文檔可以按需查閱:
- iOS 9.2 to iOS 9.3 API Differences
- iOS 9.1 to iOS 9.2 API Differences
- iOS 9.0 to iOS 9.1 API Differences
- iOS 8.3 to iOS 9.0 API Differences
- iOS 8.2 to iOS 8.3 API Differences
- iOS 8.1 to iOS 8.2 API Differences
- iOS 8.0 to iOS 8.1 API Differences
- iOS 7.1 to iOS 8.0 API Differences
使用建議:排查編譯報錯時,先確認是哪個接口被標記為 deprecated 或 renamed,再回到對應版本的 API Differences 中查替換方案,通常比直接搜索更快也更準確。另外,Xcode 內建的 API 文檔面板配合可用性標註(NS_AVAILABLE_IOS / @available),足以應付日常的大多數判斷。