本文譯自 Ray Wenderlich 的 ios-7-best-practices 系列(作者 sjpsega 翻譯整理),去除了與主題無關的寒暄段落。整個系列分成兩部分,目標是帶你動手做出一個真正能跑的天氣應用。
你會在過程中接觸到這幾項工具與技術:CocoaPods 管理第三方套件、純程式碼的手工版面配置、ReactiveCocoa 的函數式響應式編程,以及 OpenWeatherMap 提供的免費天氣 API。這篇教程的對象是已經具備基礎、但還沒碰過太多進階主題的中級開發者,也是踏入 Objective-C 函數式編程很好的起點。
開啟 Xcode,執行 File / New / Project,選擇 Application / Empty Application,命名為 SimpleWeather,選一個目錄保存後點擊 Create。基礎專案完成後,先關掉 Xcode,避免它干擾下一步的套件安裝。
由 GitHub 團隊開發,目的是消除 Objective-C 把 JSON 轉成 NSObject 子類時的大量樣板程式碼。它還能做型別轉換,把字串、整數、浮點數等原始資料自動轉成 NSDate、NSURL 甚至自訂類別。
繼承自 UIImageView,只要一行程式碼就能替圖片加上高斯模糊效果。
用來顯示浮層式警告與通知。當錯誤不該打斷使用者操作時(例如網路斷線、API 回傳錯誤),浮層比 UIAlertView 這類強制中斷的做法友善得多。
同樣來自 GitHub 團隊,為 Objective-C 帶來近似 .NET Reactive Extensions 的函數式編程能力。第二部分會花大量篇幅在它身上。
先在命令列確認 CocoaPods 已安裝:
which pod # 輸出範例 /usr/bin/pod
實際路徑會依你用 rbenv 或 RVM 管理 Ruby gems 的方式而異。若只是回到提示符號或顯示 pod not found,代表尚未安裝,需要先完成安裝步驟。
接著建立 Podfile,它負責告訴 CocoaPods 這個專案需要哪些開源庫:
platform :ios, '7.0' pod 'Mantle' pod 'LBBlurredImage' pod 'TSMessages' pod 'ReactiveCocoa'
這個檔案做了兩件事:宣告目標平台與版本,以及列出所有要安裝的第三方庫。然後執行安裝:
$ pod install Analyzing dependencies Downloading dependencies Installing HexColors (2.2.1) Installing LBBlurredImage (0.1.0) Installing Mantle (1.3.1) Installing ReactiveCocoa (2.1.7) Installing TSMessages (0.9.4) Generating Pods project Integrating client project [!] From now on use `SimpleWeather.xcworkspace`.
若你之前裝過 CocoaPods 而這裡報錯,可以參考官方關於修復 Specs Repository 的說明。
安裝完成後專案目錄會多出一堆檔案,但你只需要關心一個:SimpleWeather.xcworkspace。從現在起請改用 workspace 開啟專案,不要再用 .xcodeproj,否則找不到 Pods。
確認已選中 SimpleWeather 專案,然後 Build and Run,確保一切正常。
雖然這個 App 看起來元素眾多,實際上只靠一個 View Controller 就能完成。選擇 SimpleWeather,執行 File / New / File,挑 Cocoa Touch / Objective-C class,命名為 WXController,父類別設為 UIViewController。注意不要勾選 Targeted for iPad 與 With XIB for user interface。
打開 WXController.m,先塞一個紅色背景確認它真的被載入:
- (void)viewDidLoad {
[super viewDidLoad];
// 這行稍後會移除
self.view.backgroundColor = [UIColor redColor];
}
然後在 AppDelegate.m 引入兩個類別:
#import "WXController.h" #import <TSMessageView.h>
眼尖的人會注意到:WXController 用引號引入,TSMessage 卻用角括號。原因就在 Podfile — CocoaPods 建立了獨立的 TSMessage 專案並加入工作區,跨專案引用時使用角括號是慣例。
接著改寫啟動方法:
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
// 1. 把 WXController 設為根視圖控制器
self.window.rootViewController = [[WXController alloc] init];
self.window.backgroundColor = [UIColor whiteColor];
[self.window makeKeyAndVisible];
// 2. 指定 TSMessages 的預設宿主控制器
[TSMessage setDefaultViewController:self.window.rootViewController];
return YES;
}
註解 1:一般專案的根控制器會是 UINavigationController 或 UITabBarController,這裡因為只有單一畫面,直接放 WXController 實例。註解 2:設定預設控制器後,之後呼叫 TSMessages 就不必每次手動指定要顯示在哪個控制器上。
紅色背景襯著白色狀態列文字,幾乎看不見。iOS 7 讓 UIViewController 可以自行決定狀態列樣式,因此在 WXController 裡補上:
- (UIStatusBarStyle)preferredStatusBarStyle {
return UIStatusBarStyleLightContent;
}
接著下載專案素材圖並解壓,背景圖來自 Flickr 使用者 idleformat,天氣圖示來自 Dribbble 使用者 heeyeun。回到 Xcode,用 File / Add Files to “SimpleWeather”… 選入圖片,記得勾選 Copy items into destination group's folder。
在 WXController.h 宣告需要的協定,然後在 .m 頂部引入 LBBlurredImage 的標頭,並在私有介面中補上背景圖與 table view 的屬性。
App 的視覺結構大致如下,請特別注意 table view 是全透明的,資料會浮在模糊背景之上:
為了做出動態模糊,做法是依捲動程度改變模糊圖層的 alpha 值。在 viewDidLoad 中配置視圖階層時,依序完成:取得並保存螢幕高度(後續分頁顯示會用到)、建立靜態背景圖、用 LBBlurredImage 產生模糊圖並把 alpha 設為 0、最後建立 table view 並指定 delegate 與 dataSource,同時把 pagingEnabled 設為 YES。
接著實作 UITableView 的 delegate 與 dataSource。這個 table 有兩個 section:每小時預報與每日預報,所以 section 數為 2。預報 cell 不可選取,給它半透明黑底與白字。善用 #pragma mark 分段,能讓長檔案易讀很多。
仔細看會發現空白 cell 之間還留著分隔線。在 viewDidLoad 中補上版面框架與邊距設定:把 table header 高度設為整個螢幕(配合分頁捲動切換頁面)、建立 inset 變數讓所有標籤均勻分佈、用一組高度常數方便日後調整、最後依常數與 inset 組出各元件的 frame。
這段程式碼很長,但本質上只是在做「建立並擺放各種元件」的粗活:把目前的 view 設為 table header、逐一建立顯示氣象數據的標籤、加上天氣圖示的 image view。用手指輕推 table,應該會看到漂亮的回弹效果。
此時畫面顯示 Loading… 卻什麼都沒發生,該去接 API 了。我們使用 OpenWeatherMap,它提供即時、免費的天氣資料,輸出格式為 JSON。相較之下,多數天氣 API 要嘛仍用 XML 這類老格式,要嘛是收費服務,而且往往不便宜。
整體流程是四步:取得裝置位置 → 下載 JSON → 映射成 WXCondition 與 WXDailyForecast 物件 → 通知 UI 更新。
先建立四個類別:WXClient(NSObject 子類)、WXManager(NSObject 子類)、WXCondition(MTLModel 子類)、WXDailyForecast(WXCondition 子類)。
在 WXCondition.h 中宣告天氣相關屬性並遵循 MTLJSONSerializing 協定,這個協定決定了 JSON 如何映射到 Objective-C 屬性。由於要引用 Mantle,記得把 MTLModel.h 換成角括號形式的 import,否則編譯會失敗。
在 WXCondition.m 中實作三個關鍵部分:
1. 圖示映射表。建立一個靜態 NSDictionary,把 API 回傳的狀態代碼(例如 "01d")對應到圖檔名稱(例如 weather-clear.png),並宣告一個公開方法供外部取得。
2. JSON 鍵路徑映射。實作 +JSONKeyPathsByPropertyKey,字典的 key 是屬性名稱,value 是 JSON 路徑。這裡利用了 Objective-C 的 Key-Value Coding 與 Mantle 的 MTLJSONAdapter,可以輕鬆處理嵌套結構,例如 main 節點底下的溫度欄位。
3. 值轉換器。有幾個欄位型別對不上,需要 MTLValueTransformer 幫忙:
+dateJSONTransformer,之後 sunrise 與 sunset 都能直接複用。Mantle 的轉換器命名有點古怪但很好用:只要加上「屬性名 + JSONTransformer」的類方法,它就會自動被關聯到該屬性,本質是用 block 描述雙向轉換並回傳 MTLValueTransformer。
最後還有一個 API 設計上的不一致要處理:目前狀況的溫度在 main 節點下、最高溫叫 temp_max;每日預報的溫度則在 temp 節點下、最高溫叫 max。差異只在鍵名,因此在 WXDailyForecast.m 中改寫 +JSONKeyPathsByPropertyKey:先取得父類別的映射並複製成可變版本,改掉 max 與 min 的對應,再回傳新映射。
第一部分到此完成:你用 CocoaPods 建好專案、建立控制器、以純程式碼完成整套視圖堆疊,並用 Mantle 把 JSON 映射與轉換成模型物件。App 還沒真正動起來,但地基已經穩固。
第二部分會補上真正的資料流:用 iOS 7 新增的 NSURLSession 下載資料,並用 ReactiveCocoa 把「位置查找 → 天氣抓取 → UI 更新」這條鏈路綁在一起。到那時你會體會到,響應式編程為何能讓這類多段非同步流程變得清爽可讀。