專案使用 CocoaPods(概念上類似 Java 的 Maven)管理常用第三方庫,少數特殊需求則單獨引入。以下整理幾個實務上相當好用的組件與工具。
(1)AFNetworking
目前比較主流的 iOS 網路請求組件,預設為非同步請求,透過 block 回呼處理回傳資料。要注意它對伺服器回傳的 ContentType 要求較嚴格,預設只接受 application/json,若後端回傳 text/html,可能需要額外加入對應支援,否則會拿不到資料。
檔案上傳建議使用第二種寫法:
[formData appendPartWithFormData:name]; [formData appendPartWithFileData:name fileName:fileName mimeType:mimeType];
第一種只需傳入表單名與檔案流,原始碼會依檔案流推斷檔名與型別後再呼叫第二種。但實測中,用第一種方式提交時後端可能判定為非檔案上傳而拿不到檔案流;若後端是依副檔名判斷型別,第一種同樣會失效。
(2)FMDB
對 sqlite 資料庫操作做了封裝,demo 寫得簡單明瞭,是 iOS 端操作關聯式資料庫的常見選擇。
(3)MBProgressHUD
用於顯示過渡提示,例如網路請求前顯示 loading、結束後隱藏。建議封裝在 BaseViewController 中,讓所有 ViewController 繼承即可使用。
(4)MJRefresh
專注於下拉刷新與上拉載入,內建常用動畫,用起來相當順手。同樣建議把呼叫方式封裝在 BaseViewController,日後要改刷新邏輯只需動一處。(舊版只支援基本刷新、沒有動畫,新版 API 變動較大,因此更要透過基類隔離差異。)
(5)SDWebImage
最常用的網路圖片載入庫,會依 URL 雜湊後快取到本地,二次載入直接讀快取。這裡分享一個實務問題:先載入小圖、再以小圖為占位圖載入大圖。
[imageView sd_setImageWithURL:[NSURL URLWithString:imageURLString]
placeholderImage:DefaultPostPic];
[imageView sd_setImageWithURL:[NSURL URLWithString:_bigImageURLStringArray[i]]
placeholderImage:imageView.image
options:SDWebImageDelayPlaceholder
completed:^(UIImage *image, NSError *error,
SDImageCacheType cacheType, NSURL *imageURL) {
}];
(6)RDVTabBarController
自訂 TabBar 組件,可方便設定底部選單的文字、圖示、點擊效果與小紅點提示。
(7)Toast
類似 Android 的 Toast 提示效果,封裝在 BaseViewController 中隨時呼叫。
(8)XMPPFramework
iOS 上唯一的 XMPP 類庫。作者在去年 8 月加入了 xep-0198(流管理,用於斷線重連)支援,但透過 pod 更新時抓不到最新版,推測是 0198 尚未完善、還不能作為正式版發布。
(9)TPKeyboardAvoiding
鍵盤彈出時自動計算高度並滾動畫面,避免輸入框被遮擋。
(10)AMR
用於即時通訊的語音處理。目前專案的錄音格式選用 m4a,方便 Web 端播放。
(11)TQRichTextView
富文本視圖控件,用於即時通訊的表情顯示與資源評論的富文本呈現。
(12)CSGrowingTextView
可自動撐高的輸入框,用作聊天與評論的輸入元件,支援多行輸入。
(13)MJExtension
用於 JSON 轉 Model,概念上類似 Java 的 Gson,轉換效率據說相當不錯。使用方式很簡單,只要前後端約定好欄位,JSON 就直接變成 Model。有經驗的 iOS 開發者會強調「Model 層的管理是專案的核心」,並推薦 Mantle;MJExtension 則更輕量、上手更快。
Xcode
iOS 開發的官方工具,也沒有其他選擇。有些設計確實不錯,例如 StoryBoard 的拖拽事件綁定;不太順手的地方則是沒有內建程式碼格式化,點擊方法可能跳到另一個類別中,左側目錄也不會自動跟著定位(需要 command + shift + j)。
SimPholders2
快速找到模擬器對應的沙盒目錄。啟動後右側頂部工具欄會出現一個類似關閉按鍵的按鈕,列出最近的幾個應用,點擊即進入該應用的沙盒。
VVDocumenter-Xcode
輸入 /// 即可生成註解模板,這種功能 Xcode 竟然沒內建,實在可惜。
其餘工具大致按需選用:SVN 可用 Cornerstone,Git 可用 SourceTree,sqlite 可用 SQLite Professional(免費版只能查看),也可以用 Firefox 的 sqlite 插件。
友盟提供 App 與營運的一站式解決方案。上一個行動專案用到了推送服務,這個專案還接入了分享與第三方登錄,我全程參與了相關整合。友盟的開發者文件算是齊全,遇到問題可以聯繫客服或到論壇找答案。
(1)關於推送
iOS 推送分為本地推送與遠程推送:前者由 App 自己在本地彈出訊息,後者即使 App 未啟動也能收到。我們專案全程使用友盟的遠程推送,涵蓋聊天訊息與使用者通知兩類。使用者聊天時,手機除了走即時通訊通道,也會呼叫後台接口觸發友盟推送;此外發帖、評論、關注、點讚等行為,都由後台統一調用友盟推送。
友盟推送支援單播、列播與廣播,其中廣播每天限 3 次(可申請提高),其餘不限次數。目前來看單播速度還算快。接入時需要在蘋果開發者帳號中建立兩份推送憑證並提交給友盟(友盟有詳細文件可參考),也可以在友盟後台把測試裝置的 deviceToken 加進去,直接從後台發推。要注意的是需要 64 位元 token,必須透過方法計算,直接從 Xcode 或 iTunes 複製的值不能用。
整體流程是:App 首次啟動時開啟推送服務 → 啟動時註冊友盟並把 deviceToken 提交到自己的後台 → 後台在需要時帶著 deviceToken 呼叫友盟推送接口 → 友盟再向蘋果 APNs 發起推送 → 對應裝置收到遠程通知。
(2)關於第三方登錄與分享
這部分都在友盟的社會化分享元件中,文件也比較完整。建議除非有特殊設計需求,否則直接沿用友盟的預設分享面板(我們專案因為要加入收藏功能,整塊 UI 與分享程式碼都得自訂)。
整合時要特別注意:QQ 與微信的登錄分享都要求裝置上已安裝對應 App,而 App Store 審核會關注這點,因此需要判斷是否安裝、把未安裝的圖標隱藏起來。友盟的 SDK 已經內建相關判斷方法。
第三方登錄需要到各平台註冊開發者帳號:微信(注意不是訂閱號)的第三方登錄需付費開通,可支援微信與朋友圈分享;QQ 開發者帳號支援 QQ 與 QQ 空間分享;新浪微博則需要微博開發者帳號。QQ 分享在開發階段需把測試帳號加為開發者帳號的好友才能測試,微博情況類似。
我們整合了 QQ、微信、新浪微博三個登錄管道,三者都能取得 screen_name 與平台唯一識別碼,其中 QQ 與微信是 openid,新浪是 userid。
第三方分享方面,文件支援圖片、影片、語音。若要分享 URL,需在各平台設定對應的分享位址:
[UMSocialData defaultData].extConfig.qqData.url = shareUrl; [UMSocialData defaultData].extConfig.qzoneData.url = shareUrl; [UMSocialData defaultData].extConfig.wechatSessionData.url = shareUrl; [UMSocialData defaultData].extConfig.wechatTimelineData.url = shareUrl;
另外,分享到 QQ 空間必須指定一張圖片,否則會失敗。建議把分享邏輯封裝到一個類別中——我們專案幾個詳情頁都有分享、評論、舉報、收藏、點讚等功能,最後是封裝在 BaseDetailViewController 裡,各頁面繼承並傳入資源類型,全程只維護一份程式碼。
IM 在網上有環信、融雲等第三方方案。我們選擇自建 XMPP 伺服器(tigase),去年也做過對應的 WebIM。前陣子看環信 WebIM 的 SDK,用的也是 strophe 這個 JS 庫,實作思路與我們類似。但自建 XMPP 確實會遇到不少問題,最惱人的就是丟訊息。若想快速上線 IM,建議直接用第三方方案。
行動端丟訊息的典型場景是這樣:A 給 B 發訊息,伺服器轉發時 B 網路不佳掉線,而伺服器並不知道 B 已離開(正常離線會主動通知伺服器),訊息就這樣消失了。
XMPP 針對此有兩個擴展協議:xep-0184(訊息回執)讓 B 收到後回一筆確認;xep-0198(流管理)則在斷線後快速重連,並在一段時間內收不到對應訊息時改寫入離線信箱。但網路環境複雜加上各種不確定因素,丟訊息仍無法完全避免。目前最可靠的做法是伺服器保存完整聊天記錄,由手機端依時間點去資料庫拉取,這樣就不會漏。
這次 IM 模組參考了先前開發者的建議做了調整。例如使用者返回首頁時主動斷開 XMPP 連接(iOS 進入背景後只有約 5 秒處理時間,特殊機制可延長至 10 分鐘,但記憶體吃緊時隨時可能被終止),進入 App 再重連;同時在 App 使用狀態下保持心跳檢測以確認連接存活。
考量 iOS 的特殊性,我們讓 XMPP 與遠程推送雙路並行:推送的自訂訊息體格式與 XMPP 訊息一致,處理邏輯共用。使用者發送聊天訊息時,同時呼叫我們的推送接口走友盟 push(可設定過期時間,避免延遲送達導致「聊天結束才收到通知」的尷尬)。這樣既解決了 App 未啟動時的通知接收,也補上了 XMPP 丟訊息的缺口。
AppDelegate 中有兩個相關方法:一個處理 App 使用中收到的推送(不會彈提示,直接交給業務處理),另一個處理非使用狀態收到的推送(會顯示提示,點擊後進入 App 取得該筆訊息)。要注意點擊推送啟動時 view 尚未載入完成,訊息不能立即處理,需延後到介面就緒。
Android 端因為是真背景執行,收到 XMPP 訊息或友盟推送後都能自行處理並彈出本地通知(缺點是 App 被殺掉就收不到了);iOS 端背景不可控,因此只能依賴遠程推送,進入 App 後再連 XMPP 拉全部離線訊息。多數情況下網路正常時還是能即時收到訊息。我們做的又不是 QQ 和微信,只要保證使用者看到的資料一致就够了。
根據測試回饋,這個版本的丟訊息情況比上一版有改善,具體還要持續觀察。
我們的 IM 也包含語音與圖片,採用 HTTP 方案(XMPP 雖支援二進制傳輸,但實務上少有人這樣用)。流程是先把附件上傳到附件伺服器取得位址,再封裝進訊息體;接收方解析時再從附件伺服器下載資源並載入本地。此外屏蔽、取消屏蔽等即時操作也都走 XMPP,讓雙方第一時間同步狀態。