Apple Watch 在四月底正式開賣,Watch App 的開發也隨之成為 iOS 圈子的熱門話題。作者投入將近三個月的時間做 WatchKit 開發,每天逛官方論壇看其他開發者丟出的問題,自己也累積了一堆親手摸索出來的經驗。以下是這段時間的整理。
蘋果公布的資料其實已經足夠動工,但真機遲遲未到位,Handoff、語音輸入,甚至發表會上那個類似 Emoji 的大表情到底長什麼樣,全都只能想像。加上手上專案多半圍繞 iOS 8 的新特性打轉——從 Today Widget、Handoff 到 iPhone 6 的適配調查——一轉眼又到了新一屆 WWDC。
以下四份資料,我認為是開發 Watch App 前至少要讀過幾遍的:
在 iPhone 上主程式是大哥,所有擴充都得讓路;但在手表上,誰是主角取決於 App 的定位。以閱讀屬性為主的應用(例如新聞),主程式在手表面前其實吃重有限,真正能創造價值的是順手的 Notification 體驗,以及一眼就能看完的 Glance。

手上這個專案啟動時有六個頁面,使用者左右滑動切換,做法是透過 MainInterfaceController 重新載入根控制器:
[WKInterfaceController reloadRootControllersWithNames:_controllersArrays contexts:_contextsArray];
頁面之間傳值最關鍵的紐帶就是 context。我在這裡一次帶入六個 controller 的 Interface Builder identifier,以及事先組好的六份 context。
由於 Watch App 的啟動途徑不只一種,我寫了一個統一入口 [self showController],在裡面決定要開哪一個頁面,並用列舉標示來源:
typedef enum {
WKOpenForNormal, // 一般開啟
WKOpenForComment, // 進入評論頁
WKOpenForFavorite, // 進入收藏頁
WKOpenForGlance // 來自 Glance
} WKOpenType;
使用者點擊 Glance 進入內容時,Glance 與主 App 是靠 Handoff 溝通的,因此在入口控制器的 - (void)handleUserActivity:(NSDictionary *)userInfo; 裡把 WKOpenType 設為 WKOpenForGlance 即可。
如果來源是通知,則改用下面這個方法,依使用者點擊的動作型別分辨:
- (void)handleActionWithIdentifier:(NSString *)identifier forRemoteNotification:(NSDictionary *)remoteNotification;
比較棘手的是:使用者從 Glance 進來、離開該頁之後,畫面仍 Should 回到那六頁。我的解法是發通知——在離開頁的 - (void)didDeactivate; 裡 post 一個通知,讓主控制器重新載入六個 Page。Notification 的處理思路與 Glance 相同。
專案裡大量使用下面這個方法,因此兩端聯合除錯變成必要工序。蘋果在某個 Xcode beta 的 release note 中介紹了做法:
+ (BOOL)openParentApplication:(NSDictionary *)userInfo reply:(void(^)(NSDictionary *replyInfo, NSError *error)) reply;
三個步驟做完,兩端的斷點都能正常停下。
一開始我把資料請求寫在 Extension 裡,試了一陣子發現優化空間不大,還產生大量重複程式碼。複用專案既有程式碼才是最好的選擇,特別是那些用 CocoaPods 管理的第三方庫;但公司專案已經相當成熟,部分第三方庫無法直接搬過來,另外抽公共框架又因為專案太大、時間不夠而作罷。最後決定把資料請求全部放回主程式,用 openParentApplication 溝通,並把所有需要「問」主程式的邏輯集中到一個類別裡,讓老程式碼繼續發揮價值。
資料策略大致是這樣:為了不拖慢 Watch App 的啟動,先由主程式在背景把資料抓回來存好,Watch 每次直接取用;另外處理冷啟動——使用者裝了 App 但從未在 iPhone 上開過,直接開手表端時仍要有內容可看。代價只是第一次啟動慢一點,後續啟動就快很多。做法是:
- (void)application:(UIApplication *)application performFetchWithCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler;
做到這裡,我和同事的感覺是:iPhone 變成了伺服器,Watch 則是終端。雙方先講好協議,再透過 openParent 溝通。舉例來說,想知道使用者是否已登入(未登入會少掉部分功能),就問一下 isLogin:
// Watch 端
[WKInterfaceController openParentApplication:@{@"type":@"isLogin"} reply:^(NSDictionary *replyInfo, NSError *error) {
}];
// iPhone 端
- (void)application:(UIApplication *)application handleWatchKitExtensionRequest:(NSDictionary *)userInfo reply:(void (^)(NSDictionary *))reply {
NSString *type = userInfo[@"type"];
NSDictionary *para = userInfo[@"para"];
NSDictionary *replyInfo;
if ([type isEqualToString:@"isLogin"]) {
// ... 判斷登入狀態
replyInfo = @{@"whetherLogin": whetherLogin};
} else if ([type isEqualToString:@"isFavorite"]) {
// ... 判斷收藏狀態
}
reply(replyInfo);
}
務必注意:每一種分支都要呼叫 reply(replyInfo);,否則這個方法會以失敗告終。
專案裡 Watch 端要顯示不少圖片,這部分同樣異步向主程式索取,經典選擇仍是 SDWebImage,把 data 抓回來再交給 Watch。
補充:最後我們發現用 App Group 傳資料更有效率,因此部分請求改走 App Group。
SDK 剛發布時,我以為 WKInterfaceGroup 可以點擊——畢竟手表上沒有圖層概念,複雜版面只能用各種 Group 堆疊。為了做出設計稿的樣子,我放一個 Group、背景設圖片,其他控制項疊在上面,問題看似解決,只差 Group 能不能點。結果 Xcode 6.2 正式版徹底斷了這個念頭,最後只能用 WKInterfaceTable 硬做:每一頁只放一行。
WKInterfaceTable 與 UITableView 用法略有差異,整體卻更省事。首先定義一個 Row 類別當作 cell,在裡面排版;不同呈現方式就定義不同的 Row。
- (void)setUpUI {
[self.newsRowTabel setNumberOfRows:1 withRowType:@"RowForOneNews"];
for (int i = 0; i < self.newsRowTabel.numberOfRows; i++) {
JRWKNewsRow *newsRow = [self.newsRowTabel rowControllerAtIndex:i];
[newsRow.newsCategory setText:[NSString stringWithFormat:@"第%ld張", _index + 1]];
// ...
}
}
RowType 唯一標識一個 Row 類別,這裡只設一行,其間逐一設定 Row 內各控制項的內容。
- (void)table:(WKInterfaceTable *)table didSelectRowAtIndex:(NSInteger)rowIndex {
NSDictionary *contextDic = @{@"PicName": _picName, @"index": @(_index)};
[self presentControllerWithName:WKNEWSDETAILCONTROLLERIDENTIFIER context:contextDic];
}
若某一行不需要回應點擊,在 Storyboard 中把 selectable 取消勾選即可。

Controller 切換的 API 幾乎都帶 context 參數,也就是說傳什麼由我們決定。剛開始寫的時候我傳的是一個很大的字典,啟動慢得難以接受;後來改成寫一個模型管理類,控制器之間只傳 index,啟動速度立刻改善。
Handoff 出現在 iOS 8 之後,幾乎是為 Apple Watch 量身打造的。WKInterfaceController 也提供了相關方法,實測比 iPhone 端更簡單。Glance 進入主 App 時,同樣靠 Handoff 把資訊交給主 App 處理。主要兩個 API:
- (void)updateUserActivity:(NSString *)type userInfo:(NSDictionary *)userInfo webpageURL:(NSURL *)webpageURL; - (void)invalidateUserActivity;
第二個方法當初是論壇上有開發者問「WatchKit 為什麼沒有干掉 Activity 這件事」,蘋果後來補上了。但實測效果有限:專案裡幾乎每頁都要 Handoff,一旦 invalidate,iPhone 左下角的 App 圖示就會出現異常甚至完全不顯示。除非確定要清除,否則不要轻易動它。
總之,Handoff 是 Watch 與 iPhone 溝通的絕佳管道,蘋果也一直鼓勵開發者採用新 SDK 的能力。但也別妄想(至少現在不行)透過手表上一顆按鈕,把 iPhone 的宿主 App 叫到前台來。
1. 兩種通知的設計理念正好相反。動態通知希望使用者把內容全部看完,不要點進 App(實際上通知本身也不能點);Glance 則相反,蘋果期待使用者點擊 Glance 進入 App 繼續深讀。
2. WKTextInputMode 的選擇。一開始我選 WKTextInputModeAllowAnimatedEmoji,後來發現它回傳的是動態大表情的 data,難以對應到 iPhone 端的 emoji,於是改成 WKTextInputModeAllowEmoji;WKTextInputModePlain 則只顯示推薦的文字回覆選項。
typedef NS_ENUM(NSInteger, WKTextInputMode) {
WKTextInputModePlain, // 純文字(語音輸入 + 建議)
WKTextInputModeAllowEmoji, // 文字 + 靜態表情
WKTextInputModeAllowAnimatedEmoji // 文字 + 動態表情(GIF data)
};
3. - (void)becomeCurrentPage; 用在分頁式版面。若希望第三頁啟動時先出現,需在 awake 中標記並呼叫此方法。注意它不會直接跳到表盤上,而是從第一頁翻到第二頁、再到第三頁。
4. 推薦工具 Bezel。它能把手錶 App 的模擬畫面映射到真實手錶外框,表帶樣式有 38mm 與 42mm 多種,替換只要把樣式拖進去即可。實際用過才知道,手錶本身自帶黑邊,當初刻意留的左右邊距完全是多餘的。

目前手表上的 push 是隨手機一起出現的,兩台裝置同步顯示,除非有外力介入(例如手錶關閉了抬手喚醒通知)。先前文章提過用 category 區分推送型別:若沒有設定對應的 Storyboard,手表上只會出現系統預設的簡短通知。
蘋果的立場是讓使用者在通知裡就把該讀的都讀完,即使要加按鈕,也應該是簡單操作。以行事曆 App 為例,一則 push 配 done、delete,加上系統的 cancel 就足夠了。
我試著在動態通知裡申請一張圖片資源,結果系統直接改顯示靜態通知。可見 Notification Controller 裡能做的事相當有限,開發時要審慎評估。另外,Xcode 自動產生的 Payload 很重要,可以定義多個 payload 搭配不同 category 與不同 Storyboard 做模擬。
我依然認為 Glance 是手表上最重要的存在——至少在第三方獨立 App 上架之前,它應該是使用頻率最高的功能。因此 Glance 的內容不能太少也不能太多,必須精簡扼要,只放最關鍵的資訊。若你的 App 不是以天氣為主,硬塞溫度資訊就不合適,系統自家的天氣與地圖已經做得很好,Glance 應該突顯自家 App 獨有的價值。
Glance 的版面也很講究,盡量照 Xcode 提供的 Upper 與 Lower 模板排版。它不能放任何可操作元件(例如按鈕),因為 Glance 只有一頁、不能滾動,本質上更像一張渲染出來的圖片。

與 Notification 類似,Glance Controller 能做的事有限,而且眾多 Glance 是並排呈現的,使用者一路掃過去,必須掃到就立刻有內容。比較好的解法是提前把資料抓回來,用的時候直接取,App Group 就是其中一種手段。
Glance 與主 App 的溝通依賴 Handoff:使用者點了 Glance 之後,主 App 該做什麼,取決於傳過來的 userinfo。
[self updateUserActivity:XXXXX userInfo:userInfo webpageURL:nil];
在入口控制器實作接收方法,決定啟動哪一頁、呈現什麼內容,可以放在 willActivate;但記得,請求資料一定要放在 awake,不要放在 willActivate。
-(void)handleUserActivity:(NSDictionary *)userInfo {
wkOpenType = JRWKOpenForGlancedemo;
if (userInfo) {
NSString *sourceString = [userInfo objectForKey:@"Source"];
NSString *picName = [userInfo objectForKey:@"PicName"];
if ([sourceString isEqualToString:@"Glance"]) {
_glancePicName = picName;
}
}
}
switch (wkOpenType) {
case JRWKOpenForGlancedemo: // 導到 glance 頁
break;
case JRWKOpenForNotificationdemo: // 導到通知頁
break;
default:
[self showPageBaseddemoController]; // 預設啟動
break;
}
Demo 已整理好放在作者的 GitHub 上(AppleWatchDemo)。

WatchKit 本身的 API 其實不多,真正折磨人的是在全新平台上遇到的各種問題與 bug。隨著真機到來,開發不再摸黑,這都是好消息。第三方獨立應用何時開放、WatchKit 會長成什麼樣子都還是未知數,但我個人依然看好手錶的未來——畢竟蘋果正領著整個穿戴裝置的頭。
作者簡介:劉瑞,中國科學技術大學蘇州研究院在讀碩士,喜歡科技產品,也喜歡製作開箱與體驗影片,大三起自學 iOS 開發。