在多個 iOS 專案同時開發時,若每個 App 都要重複整合個推 SDK,維護成本會快速上升。透過私有 Pods 與適當的 AppDelegate 解耦,可以把固定流程封裝起來,讓各專案只需要專注於自己的業務邏輯。
當公司內有多個 App 都需要處理推送訊息時,常見做法是每個專案各自複製一份個推設定、通知註冊與回調處理。但這些內容大多相同,真正不同的通常只是 App 的業務判斷。私有 Pods 可以把共同部分集中管理,降低重複設定與出錯機率。
這個方案通常會搭配 CocoaPods 私有倉庫、基類 AppDelegate,以及方法注入工具。以下以 XAspect 為例,說明如何把個推相關邏輯從各專案的 AppDelegate 中抽離。
封裝完成後,專案中的 AppDelegate 可以繼承自訂的 jiaAppDelegate,並只需要設定個推的 AppId、AppKey 與 AppSecret。訊息接收則透過兩個自訂方法處理:一個接收個推通知,一個接收蘋果遠程通知。
例如,在 didFinishLaunchingWithOptions 中建立 jiaGTConfigManager 單例,填入個推設定,再建立根視圖控制器。真正需要處理訊息的地方,則實作 gtNotification 與 receiveRemoteNotification。
自訂基類的目的,是讓所有專案的 AppDelegate 都繼承同一個父類。這樣 XAspect 就能針對這個基類注入方法,而不必修改每個專案的 AppDelegate。基類本身可以先保持簡單,只保留 UIWindow 與系統生命週期方法。
個推需要 AppId、AppKey、AppSecret 等設定。建立一個單例類別集中管理這些值,可以讓初始化時不必在 AppDelegate 中寫死太多細節,也方便日後切換環境。
由於 XAspect 無法直接針對 Delegate 協定做完整宣告,因此建立 Category 引入 GeTuiSdk.h,讓後續注入與回調處理能共用同一個型別。
這是封裝的關鍵。透過 AspectPatch 攔截 application:didFinishLaunchingWithOptions:、裝置註冊成功、註冊失敗、使用者通知設定與遠程通知接收等方法。個推初始化、APNs 註冊、通知中心註冊與訊息轉發,都集中在此。
當 GeTuiSdkDidReceivePayload 被呼叫時,會先透過 GeTuiSdk retrivePayloadById 取得 payload,再把它組成字典,透過 NSNotificationCenter 發送 jiaGeTuiNotification。AppDelegate 收到通知後,可呼叫自己的 gtNotification 方法處理業務。
蘋果遠程通知也採用類似方式。收到 didReceiveRemoteNotification 後,會解析 payload 與 aps.alert.body,再發送 jiaReceiveRemoteNotification。這樣各專案只需要實作自己的處理方法,不需要知道個推回調細節。
封裝完成後,可建立 podspec 並推送到私有倉庫。podspec 中需要設定 source_files、frameworks、libraries、requires_arc,以及個推靜態庫的 vendored_library。若私有 Pod 依賴其他自製 Pod,也可透過 dependency 指定。
檢驗與推送時,可使用 pod lib lint 與 pod repo push。若包含靜態庫,通常需要加上 --use-libraries 參數,並在 sources 中同時指定公開倉庫與私有倉庫。
這種做法的好處是降低新專案接入成本。開發者只要引入私有 Pod、設定個推參數,並實作兩個訊息方法即可。若日後要加入友盟、融雲或其他 SDK,也可以沿用相同基類與注入模式。
XAspect 這類注入工具功能強大,但也會增加維護難度。團隊應清楚記錄注入點、方法名稱與依賴關係,避免多人修改時產生衝突。個推 SDK 版本更新時,也要重新驗證 device token、通知權限與 iOS 新版本的行為變化。
整體而言,私有 Pods 封裝個推 SDK 的核心價值,是把重複且穩定的流程沉澱成基礎建設,讓每個 App 能把時間花在真正差異化的業務功能上。