您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 訊息 >> iOS 相關資訊

iOS 7 最佳實踐:用純程式碼打造一個天氣 App

編輯:iOS 相關資訊

本文譯自 Ray Wenderlich 的 ios-7-best-practices 系列(作者 sjpsega 翻譯整理),去除了與主題無關的寒暄段落。整個系列分成兩部分,目標是帶你動手做出一個真正能跑的天氣應用。

你會在過程中接觸到這幾項工具與技術:CocoaPods 管理第三方套件、純程式碼的手工版面配置、ReactiveCocoa 的函數式響應式編程,以及 OpenWeatherMap 提供的免費天氣 API。這篇教程的對象是已經具備基礎、但還沒碰過太多進階主題的中級開發者,也是踏入 Objective-C 函數式編程很好的起點。

一、建立專案

開啟 Xcode,執行 File / New / Project,選擇 Application / Empty Application,命名為 SimpleWeather,選一個目錄保存後點擊 Create。基礎專案完成後,先關掉 Xcode,避免它干擾下一步的套件安裝。

二、認識要用的四個庫

Mantle

由 GitHub 團隊開發,目的是消除 Objective-C 把 JSON 轉成 NSObject 子類時的大量樣板程式碼。它還能做型別轉換,把字串、整數、浮點數等原始資料自動轉成 NSDate、NSURL 甚至自訂類別。

LBBlurredImage

繼承自 UIImageView,只要一行程式碼就能替圖片加上高斯模糊效果。

TSMessages

用來顯示浮層式警告與通知。當錯誤不該打斷使用者操作時(例如網路斷線、API 回傳錯誤),浮層比 UIAlertView 這類強制中斷的做法友善得多。

ReactiveCocoa

同樣來自 GitHub 團隊,為 Objective-C 帶來近似 .NET Reactive Extensions 的函數式編程能力。第二部分會花大量篇幅在它身上。

三、設定 CocoaPods

先在命令列確認 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,確保一切正常。

小提示:你可能會看到一些警告。因為 Pods 是由不同開發者撰寫,對警告的態度各自不同,通常可以忽略,只要沒有編譯錯誤即可。

四、建立主視圖控制器

雖然這個 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 子類)。

七、用 Mantle 建立天氣模型

在 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 幫忙:

  • 日期:API 給的是 Unix 時間戳(從 1970 年 1 月 1 日起算的秒數,NSInteger),屬性卻是 NSDate。寫一個 +dateJSONTransformer,之後 sunrise 與 sunset 都能直接複用。
  • 天氣描述:weather 鍵的值是一個陣列,但我們只關心其中單一天氣狀況,因此需要 NSArray 與 NSString 之間的轉換。
  • 風速:API 用公尺/秒,App 採用英制,要換算成英哩/小時。

Mantle 的轉換器命名有點古怪但很好用:只要加上「屬性名 + JSONTransformer」的類方法,它就會自動被關聯到該屬性,本質是用 block 描述雙向轉換並回傳 MTLValueTransformer。

最後還有一個 API 設計上的不一致要處理:目前狀況的溫度在 main 節點下、最高溫叫 temp_max;每日預報的溫度則在 temp 節點下、最高溫叫 max。差異只在鍵名,因此在 WXDailyForecast.m 中改寫 +JSONKeyPathsByPropertyKey:先取得父類別的映射並複製成可變版本,改掉 max 與 min 的對應,再回傳新映射。

接下來呢?

第一部分到此完成:你用 CocoaPods 建好專案、建立控制器、以純程式碼完成整套視圖堆疊,並用 Mantle 把 JSON 映射與轉換成模型物件。App 還沒真正動起來,但地基已經穩固。

第二部分會補上真正的資料流:用 iOS 7 新增的 NSURLSession 下載資料,並用 ReactiveCocoa 把「位置查找 → 天氣抓取 → UI 更新」這條鏈路綁在一起。到那時你會體會到,響應式編程為何能讓這類多段非同步流程變得清爽可讀。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved