
AFNetworking 是 iOS 與 OS X 開發中廣受歡迎的網路庫。隨著系統 API 演進,AFNetworking 3.0 移除了對 NSURLConnection 的支援,全面轉向 NSURLSession。若專案仍使用舊版 API,建議及早完成遷移。
NSURLConnection 已被蘋果標記為舊有 API。雖然短期內仍可運作,但後續不會再獲得新功能。相對地,NSURLSession 是蘋果目前主要推動的網路架構,具備更好的維護性與擴充能力。
AFNetworking 3.0 全面採用 NSURLSession,能減少維護成本,也讓開發者更容易使用新版系統能力。
在 3.0 版本中,AFURLConnectionOperation、AFHTTPRequestOperation 與 AFHTTPRequestOperationManager 已被移除。原本使用這些類別的程式碼,需要改採 AFHTTPSessionManager。
此外,UIKit 相關的分類也進行了重構。圖片下載改由新的下載器管理,UIImageView、UIButton 與 UIWebView 的網路行為也轉向 NSURLSession。
若原本使用 AFHTTPRequestOperationManager,最直接的方式是改用 AFHTTPSessionManager。兩者在 securityPolicy、requestSerializer 與 responseSerializer 等設定上仍有共通概念,但請求回呼中的物件型別已改為 NSURLSessionTask。
這代表成功與失敗回呼中的參數,不再是以往的 operation 物件,而是 task 物件。開發者在修改時,應特別注意回呼簽章與型別宣告。
過去若需要建立單次請求,可直接建立 operation 並加入佇列。新架構下,則通常透過 session manager 建立 task,再啟動請求。雖然寫法略有不同,但整體邏輯仍然相近。
遷移時,建議先從最常使用的 GET 與 POST 流程著手,再逐步處理進度、快取、序列化與錯誤處理等細節。
AFNetworking 3.0 的升級,不只是版本更新,更是對 Apple 新網路架構的正式靠攏。及早遷移,不僅能減少未來維護風險,也能讓專案更容易與新系統能力整合。