
目錄:專案介紹 / 使用的第三方開源庫 / 工具與外掛 / 整合友盟 / 即時通訊 / 專案總結。
2014 年 12 月,我從網站開發組轉到行動開發組,兩年半的 Java 經驗歸零,Objective-C 從零開始。2015 年 1 月新專案啟動,年後因為人事變動,我從輔助開發變成「核心」開發。目前專案接近收尾,在此做個整理,一方面給同路人參考,另一方面也期待前輩指正。
這是一款社群類應用,涵蓋小組成員/文章、影片、評論、推薦搜尋、即時通訊、好友、第三方登入/分享與推播等常見能力,幾乎把主流 App 的功能都走過一遍。
https://github.ibireme.com/github/list/ios/ 整理了常用元件與 GitHub 統計,值得收藏。專案以 CocoaPods(相當於 Java 生態的 Maven)管理相依性,特殊元件另行引入。以下幾個是實際用下來感受最好的:
AFNetworking:目前最主流的網路請求庫,預設非同步並以 block 回傳結果。要注意它對 ContentType 的判斷較嚴格,預設只接受 application/json,若後端回傳 text/html,可能需要額外註冊支援,否則拿不到資料。檔案上傳建議用帶檔名與 MIME 的版本:
[formData appendPartWithFormData:name:]; [formData appendPartWithFileData:name:fileName:mimeType:];
第一種只需傳表單名與檔案串流,內部會自行推斷檔名與型別再轉呼第二種;但實測時後端會把第一種判定為非檔案上傳而讀不到串流,若後端依副檔名判型別也同樣會失敗。
FMDB:對 sqlite 操作的封裝,Demo 簡潔。
MBProgressHUD:顯示過場 loading 的標配,建議封裝進 BaseViewController,讓各頁繼承即可使用。
MJRefresh:李明傑老師的作品,我的 Objective-C 基礎就是靠他的影片半個週末打下來的。它提供常用的下拉/上拉刷新與動畫,同樣建議封裝到基類,日後調整只改一處。(舊版只支援基本刷新,新版變動較大且舊 API 已被放棄,封裝在基類正好方便遷移。)
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) { }];
RDVTabBarController:可自訂底部選單的文字、圖示、點擊效果與紅點提示。
Toast:類似 Android 的輕量提示,封裝進 BaseViewController 後各處都能呼叫。
XMPPFramework:iOS 上唯一的 XMPP 庫。作者在去年 8 月加入了 xep-0198(流量管理,用於斷線重連)支援,但透過 pod 更新時抓不到最新版,推測該擴充尚未成熟到可作為正式版。
TPKeyboardAvoiding:鍵盤彈出時自動計算高度並捲動畫面。
AMR:即時通訊的語音處理。我們的錄音格式選 m4a,方便 Web 端播放。
TQRichTextView:富文本檢視,用於聊天表情與資源評論的排版。
CSGrowingTextView:可多行輸入並自動撐高的文字框,聊天與評論輸入都靠它。
MJExtension:同為李明傑老師作品,負責 JSON 轉 Model,作用近似 Java 的 Gson。轉換效率據說很高,只要前後端欄位約定好,幾乎零設定就能跑。也有資深朋友推薦 Mantle,認為專案的核心在於 Model 層治理;不過 MJExtension 更輕量、上手更快。
Xcode 是唯一的選擇。它有幾個設計確實漂亮,例如 Storyboard 的拖曳式事件綁定;但也有惱人之處:沒有內建程式碼格式化,點擊方法可能跳到別的類別,左側檔案樹不會自動跟著游標定位(需要 cmd + shift + j)。
SimPholders2 能快速找到模擬器對應的沙盒目錄,工具列會列出最近的幾個應用,點一下即進入該 App 的沙盒。
VVDocumenter-Xcode 用 /// 產生註解模板——這種功能竟然要靠外掛補上。
其他工具:SVN 可用 Cornerstone、Git 可用 SourceTree、sqlite 可用 SQLite Professional(付費,免費版只能檢視)或 Firefox 的 sqlite 外掛。
友盟提供 App 與營運的一站式方案,公司上一個行動專案已用過它的推播,這次我親自參與了分享與第三方登入的整合。官方文件相對完整,遇到問題可找客服或論壇。
iOS 推播分為本地與遠程兩種:本地由 App 自己彈出訊息,遠程則在 App 未啟動時也能送達。我們全數採用友盟的遠程推播,涵蓋聊天訊息與各類通知——使用者在聊天時,手機除了走 XMPP,也會呼叫後端接口觸發友盟推播;發文、評論、關注、按讚等也都由後端發送。
友盟推播提供單播、列播與廣播,其中廣播每天限三次(可向友盟申請提高),其餘不限次數,目前單播速度令人滿意。使用前提是先在蘋果開發者帳號建立兩張推播憑證並提交給友盟。開發階段可在友盟後台填入測試裝置的 deviceToken 直接發推播測試,注意需要 64 位元 token,必須透過程式取得,直接從 Xcode 或 iTunes 拿到的不可用。
整體流程是:App 首次啟動時開啟推播服務並註冊友盟,同時把 deviceToken 回報自家後端;後端在需要時帶著 token 呼叫友盟接口,友盟再轉發蘋果推播服務,讓對應裝置收到遠程推播。
這塊都在友盟的社會化分享元件中,文件齊全。建議除非有特殊設計需求,否則直接沿用友盟的預設分享面板(我們因為要做收藏等自訂功能,整塊 UI 與分享程式碼都得自己寫)。特別要注意:QQ 與微信的登入/分享都要求裝置已安裝對應 App,而 App Store 審核會關注這點,因此必須判斷是否安裝並隱藏未安裝的圖示——友盟 SDK 已內建相關判斷(底層整合了 QQ 與微信 SDK)。
各平台都需另行註冊開發者帳號:微信開放平台帳號(不是公眾號)需付費才能開通第三方登入,可支援微信與朋友圈分享;QQ 開發者帳號可支援 QQ 與 QQ 空間;微博則需微博開發者帳號。開發階段還要把測試帳號加為開發者帳號的好友才能測試分享。實作中遇到「QQ 提示非最新版本」的問題,最终在友盟論壇找到解法。
登入方面整合了 QQ、微信、新浪微博三家,都能取得使用者 nickname 與平台唯一識別碼(QQ 與微信為 openid,新浪為 userid)。分享時若要帶連結,需為各平台設定分享網址:
[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 中,各頁繼承並傳入資源類型,只維護一份程式碼。
市面上有環信、融雲等第三方方案,但我們選擇自建 XMPP 伺服器(tigase),我先前也寫過相關文章並做過對應的 WebIM。看了環信 WebIM 的 SDK 後發現它同樣基於 strophe,實作思路與我們相近。不過自建 XMPP 的坑不少,最痛的就是掉訊息——若追求快速上線,第三方方案是更務實的選擇。
掉訊息的典型場景是:A 傳訊息給伺服器,伺服器轉發給 B,但 B 網路不佳斷線,而伺服器並不知道(正常離線會主動通知伺服器),訊息就消失了。XMPP 的 xep-0184(訊息回執)能緩解:要求對方回一則回執;xep-0198(流量管理)則負責快速重連並在時限內收不到訊息時轉存離線訊息。但網路環境複雜加上各種不確定因素,仍會漏。目前最可靠的做法是完整保存聊天記錄,由手機端依時間點向資料庫補拉。
這次也依前人的建議做了調整:使用者返回首頁時主動切斷 XMPP 連線(iOS 進入背景後只有約 5 秒處理時間,特殊機制最多可延長到 10 分鐘,且記憶體不足時隨時可能被終止),進入 App 再重連;使用狀態下則以心跳維持連線。
考量 iOS 平台特性,我們讓 XMPP 與遠程推播並行:推播的自訂訊息體與 XMPP 訊息體格式一致、處理邏輯共用。送訊息時同時呼叫自家推播接口觸發友盟 push(可設定過期時間,避免延遲送達已結束的對話)。這麼做一方面解決 App 未啟動時的收訊問題,另一方面彌補 XMPP 掉訊息的缺口。
AppDelegate 中有兩個推播回呼:App 使用中收到時不提示、直接處理;非使用狀態收到時會提示,點擊後進入 App 並取得該則訊息——注意此時 view 尚未載入,不能立刻處理。
Android 端是真背景執行,收到 XMPP 或友盟推播都能自行處理再彈本地通知(缺點是 App 被終止後就收不到);iOS 端背景不可控,因此走遠程推播,進入 App 後連上 XMPP 再補抓全部離線訊息。多數情況下網路良好時兩者都是即時送達。我們不是 QQ 也不是微信,只要確保使用者看到的資料一致即可。
從測試回饋來看,這個版本的掉訊息狀況比上一個 App 有改善,後續再持續觀察。
語音與圖片則採用 HTTP 傳輸(XMPP 雖支援二進位傳輸,但實務上少有人這樣做):先把附件上傳到附件伺服器取得網址,再封進訊息體;接收方解析後再下載並落地。封鎖、解除封鎖等狀態變更也一律走 XMPP,讓雙方即時同步。
專案不到半個月就要上線,我也成了主要負責人。前期 iOS 與 Android 各有一週多的準備與框架搭建,之後由我依頁面原型定義接口文件、安排開發計畫並協調進度。團隊經驗都不算多,框架與接口難免有瑕疵,隨著專案推進會越來越好。以下是我對 iOS 開發的整理:
續篇:〈Java 轉 iOS-第一個專案總結(2):遇到的問題與解法〉。