
XMNetworking 是團隊開源的網絡庫,基於 AFNetworking 3.0 封裝,以 XMCenter 為中心管理 XMRequest。它適合普通請求、上傳、下載、批量與鏈式請求,並可透過 XMEngine 隔離底層依賴,方便日後替換或自定義底層網絡邏輯。
XMNetworking 的設計目標是簡單易用,同時覆蓋大多數網絡請求場景。它支援 RESTful Server API,可配置公共 Server URL、Header、Parameter,也可透過 Block 注入自定義響應處理邏輯,例如模型轉換、業務錯誤碼判斷與網絡緩存。
此外,它支援批量請求、鏈式請求、取消未完成請求、自動重試失敗請求,並整合 AFNetworking 的安全策略與網絡可連接性檢查。
iOS 7.0 以上,Xcode 7.3 或更高版本。
在 Podfile 中加入 XMNetworking,再執行 pod install 或 pod update。

注意:XMNetworking 已包含 AFNetworking 3.1.0 源碼,工程中的 Podfile 不要再添加 AFNetworking,否則會衝突。
Carthage 是去中心化依賴管理工具,會自動編譯依賴庫並以 framework 形式提供。

安裝完成後,在 Cartfile 中加入對應內容。

然後執行 carthage update --platform ios,將生成的 XMNetworking.framework 拖入工程。同樣不要重複生成 AFNetworking.framework。
下載 XMNetworking 子文件夾的所有內容,將源文件拖放進工程即可。
若使用 CocoaPods 或 Carthage 安裝,可按 framework 方式導入。

若手動下載源碼安裝,則直接導入對應頭文件。

可調用 XMCenter 的 setupConfig 類方法,透過 XMConfig 設定公共網絡資訊。

可配置的項目包括 generalServer、generalParameters、generalHeaders、generalUserInfo、callbackQueue 與 consoleLog。若請求對象沒有指定 server、parameters 或 headers,且允許使用全局配置,就會自動套用 XMCenter 的公共設定。
也可隨時修改全局 header 與 parameter。

XMRequest 支援 GET、POST、HEAD、DELETE、PUT、PATCH 等常見 HTTP 方法。

設置 URL 時,可以透過 server 與 api,也可以直接設置 url。當 server、api、url 同時存在時,url 優先級較高。

POST 請求的使用方式與 GET 類似。

上傳請求可透過 XMCenter 發起,並在進度回調中取得上傳狀態。

下載請求同樣支援進度回調與完成處理。

XMRequest 提供 requestSerializerType 與 responseSerializerType,可設定請求參數與響應結果的序列化方式。

開發中常見需求是:請求成功後,仍需要驗證業務錯誤碼或轉換模型。此時可用 XMCenter 的 setResponseProcessBlock 注入自定義處理邏輯。若 error 被賦值,則後續會走 failure block。
批量請求適合多個互相獨立但業務相關的請求。只有全部成功才會執行 success,任一失敗則執行 failure。

鏈式請求適合前後依賴的場景,下一個請求是否發送取決於上一個請求結果。

發送請求後會返回 identifier,可用來取消未完成的請求。

也可查詢當前網絡可連接性。

在 App 內加入 SSL 證書校驗,有助於降低中間人攻擊風險。可透過 XMEngine 暴露的 sessionManager 調整 securityPolicy。

XMNetworking 的核心文件非常精簡,主要包括 XMConst.h、XMRequest、XMCenter 與 XMEngine。

後續可支援斷點下載、網絡層緩存、tvOS/watchOS/macOS 兼容性、更強大的模型轉換,以及可擴展插件機制。
XMNetworking 使用 MIT 許可證,適合在 iOS 專案中作為輕量網絡層使用。