
本文由 CocoaChina 翻譯組成員 YueWang 翻譯,原文〈WatchKit FAQ〉出自 raywenderlich 作者 Soheil Azarpour,歡迎大家一起指教。
Ray 的提醒:這篇文章是 Spring Swift Fling 慶祝活動的一部分,希望讀者讀得開心。
寫下這篇文章時,開發者接觸 WatchKit 大約才三個月。正因為大家在慢慢摸熟這套新技術,一大堆問題自然跟著冒出來。
在這份 WatchKit FAQ 中,我們整理了社群、Twitter、電子郵件與 Stack Overflow 上被重複提問最多的疑問,並會在問題持續湧現時定期更新。
有些問題目前並沒有標準答案,我們只能綜合開發者的經驗、觀點,加上一點合理的推測。跟你一樣,我們也在摸索中前進,而 WatchKit 這項技術本身仍在快速演進,答案也會跟著改變。
關於 WatchKit 哪些地方好用、哪些地方難用,歡迎留言分享你的想法,也歡迎提出更多問題,我們會依據回饋持續修訂這份 FAQ。
WatchKit 是 Apple 為 Apple Watch 打造混合式應用程式的框架,與 Xcode 6.2 一同釋出。
它最特別的地方,是把你的 App 拆成兩個各自獨立的部分:

Apple Watch 這端只裝了 storyboard 與 asset catalog 這類介面資源。它能接收使用者輸入,但基本上不執行任何程式碼——與其說是電腦,不如說是一個極度精簡的瘦客戶端。
iPhone 這端則扛下所有程式邏輯,並以「擴充功能」的形式執行,運作方式跟 Today 或 Action 擴充功能很類似。
更棒的是,Apple Watch 與 iPhone 之間的通訊完全由系統自動處理,一切都發生在背景裡。你照著原本的習慣寫程式,WatchKit 會代你搞定所有無線傳輸。就你撰寫的程式碼來看,view 與 outlet 是本地關聯的,即使它們實際上分屬兩台完全分離的裝置。非常巧妙。
想深入了解,可以參考我們的〈WatchKit: Initial Impressions〉一文。
當然可以。Objective-C、Swift 或兩者混用都沒問題。Apple 提供了兩個 WatchKit 範例工程:
WatchKit Catalog: Using WatchKit Interface Elements——全部以 Objective-C 撰寫。
Lister: A Productivity App——Objective-C 與 Swift 雙語版本。
此外,我們的 WatchKit 教學、WatchKit 影片系列,以及《WatchKit by Tutorials》一書都完全以 Swift 寫成;Apple 官方也提供了 Objective-C 與 Swift 兩種版本的 WatchKit Framework 文件。
不行,目前不支援自訂錶面。

每次只能配對一支。iPhone 與 Apple Watch 之間是一對一的關係。
不行。目前 Apple Watch 只能與 iPhone 配對。
不行。WatchKit 只允許「系統」去啟動配對的 iPhone App,而且全程在背景執行,反方向的呼叫目前並不支援。
不行。沒有任何公開 API 能讓你從 WatchKit 擴充功能撥號。原因是配對的 iPhone App 並不會被切到前景,系統會靜靜忽略來自該 App 的所有撥號或 openURL: 請求。
不行。目前沒有任何 API 能存取 Apple Watch 上的硬體感測器。
Short-Look 通知由系統全權提供,就像你在 iPhone 上看到的橫幅通知,開發者完全無法控制。它只會顯示 App 的圖示、名稱與標題。通知送達時使用者立刻看到 Short-Look;若使用者舉起手腕並停留一會兒,它就會轉換成 Long-Look。
Long-Look 通知則分為兩種:
靜態通知:由通知 payload 自動填滿一個固定標籤。你可以在 Watch App 的 storyboard 中建立靜態通知場景,但除了改一改 sash 與標題顏色,基本上無從自訂。
動態通知:需要你 subclass InterfaceController,它由 storyboard 具現化,讓你完全自訂介面。要留意的是,動態通知介面並不保證會出現——例如手錶電量過低時,系統可能改顯示成本較低的靜態介面來省電。

我該怎麼用模擬器測試 Glance 或通知?
每一個 Glance 與通知都需要專屬的 build scheme 才能在模擬器中跑起來。選好對應的 scheme,然後建置、執行即可。
可以堆疊介面元素嗎?
原本不行,元素沒辦法重疊擺放,但有變通做法。例如使用 WKInterfaceGroup,把它的背景圖片設為你想墊底的那個元件模樣,再在這個群組裡依序放進標題、按鈕等等。
可以調整介面元素的 CALayer 屬性嗎?
不行。WatchKit 的介面元素並非繼承自 UIView 或 CALayer,因此目前沒有可用的 CALayer 屬性。
WatchKit 裡的類別可以 subclass 嗎?
沒什麼能阻止你這麼做,但你很可能會發現它行不通。WKInterfaceController 與 WKUserNotificationInterfaceController 這類類別確實可以 subclass 並在 storyboard 中使用;然而 storyboard 不允許你更換任何介面元素的類別。此外,你無法動態建立介面元素再像子視圖那樣插入或移除,只能對 storyboard 中既有的元素做顯示與隱藏。
分頁式與階層式界面控制器可以混用嗎?
可以,但有條件限制。若 App 採用 hierarchical interface,你可以模態呈現一個 page-based 介面;若任一頁面本身是 hierarchical,那就只會顯示根界面控制器,而且你不能往它的堆疊上 push 任何東西。反過來說,若 App 採用 page-based 介面,你也可以模態呈現 hierarchical 介面,但同樣只會顯示根控制器,也不能往下堆疊。
Apple Watch 上有 UIActivityIndicatorView 或 UIAlertController 的對應物件嗎?
沒有,但你可以模態呈現一個自訂的 WKInterfaceController 來取代 UIAlertController。至於活動指示器,可以用一連串圖片做出動畫,或者乾脆只顯示一個文字標籤。參考 Apple 的 Lister 範例:在 Watch App 的 glance 裡就用了 360 張圖片,組成一個完整的圓圈動畫。

我可以用 Core Graphics 動態產生圖片並放進 Watch App 嗎?能快取在 Apple Watch 上嗎?
都可以。但凡是使用 Core Graphics 的合成作業,都必須作為擴充功能的一部分在 iPhone 端完成。一旦你把繪製結果轉成 UIImage 實例,就能用 WKInterfaceDevice 的 addCachedImage(_:name:) 方法把它快取到手錶上。
我能在 Apple Watch 上使用自訂視圖,或自訂公開 API 之外的介面元素嗎?
不行。WatchKit 只支援有限的原生介面元素,超出公開 API 的範圍就無法繼承或自訂。可用的元素包含:WKInterfaceLabel、WKInterfaceButton、WKInterfaceImage、WKInterfaceGroup、WKInterfaceSeparator、WKInterfaceTable、WKInterfaceSwitch、WKInterfaceMap、WKInterfaceSlider 與 WKInterfaceTimer。
Apple Watch 是怎麼跟 iPhone 溝通的?
Apple Watch 透過 Bluetooth LE 與 Wi-Fi 和配對的 iPhone 互動。對使用者與開發者來說,底層的實作方式是完全不透明的。

開啟飛航模式後,Apple Watch 還能用嗎?
能。事實上,你可以開啟飛航模式之後再把 Bluetooth 與 Wi-Fi 打開,配對與互動都不受影響,Apple Watch 照樣使用。
如果 Apple Watch 連不上配對的 iPhone,我的 App 會怎麼樣?
簡單說:App 不會執行;若正在執行中,則會被掛起。
此時 WatchKit 擴充功能會呼叫目前 interface controller 的 didDeactivate(),你可以把握機會做必要的清理。手錶狀態列會出現一個紅色 iPhone 圖示代表連線中斷,畫面仍停留在螢幕上但無法互動。使用者只能選擇修復連線,或者離開 App。
Watch App 怎麼跟配對的 iPhone App 溝通?
有幾種常見做法。最受歡迎的一種是:Watch App 在一個共享容器中寫入或更新資料,並負責通知 iPhone App,之後 iPhone App 自行從共享容器拉取變更。
另一種是直接透過字典把資料傳給 iPhone App,但這類通訊只能由 Watch App 主動發起。WatchKit 擴充功能只提供一個 API:呼叫 WKInterfaceController 的類別方法 openParentApplication(userInfo:reply:),如下:
// Notify companion iPhone app of some changes in the shared container.
let kSharedContainerDidUpdate = "com.rayWenderlich.shared-container.didUpdate"
let requestInfo: [NSObject: AnyObject] = [kSharedContainerDidUpdate: true]
WKInterfaceController.openParentApplication(requestInfo) { (replyInfo: [NSObject : AnyObject]!, error: NSError!) -> Void in
// Handle the reply from the companion iPhone app...
}
在 userInfo 字典裡,你只需傳一個旗標或少量資料給配對的 iPhone App。要接收這類通訊,iPhone App 必須在它的 app delegate 中實作 application(_:handleWatchKitExtensionRequest:reply:):
func application(application: UIApplication!, handleWatchKitExtensionRequest userInfo: [NSObject : AnyObject]!, reply: (([NSObject : AnyObject]!) -> Void)!) {
let kSharedContainerDidUpdate = "com.rayWenderlich.shared-container.didUpdate"
if let isUpdate = userInfo[kSharedContainerDidUpdate] as? Bool {
// Process request, then call reply block
reply(...)
}
}
若配對的 iPhone App 被掛起或終止,系統會在背景把它喚起。依溝通目的而定,iPhone App 可以在 reply block 中回傳資訊,讓 Watch App 做出相應處理。
iPhone App 如何反向跟它的 Watch App 溝通?
沒有任何方式能讓 iPhone App 主動對擴充功能發起通訊。除了往共享容器寫資料,或者回應 Watch App 的請求之外,iPhone App 可以借助 Darwin Notification Center(Core Foundation 框架的 API)通知 WatchKit 擴充功能某個事件已發生。
如果你打算採用 Darwin Notification Center,有幾件事務必牢記:
每個 App 只有一個 Darwin Notification Center。
所有 Darwin 通知都是系統層級的。
要能送出通知,主執行緒的 run loop 必須運行在常用模式下,例如 kCFRunLoopDefaultMode。
Watch App 與 iPhone App 都必須在前台執行,才能處理 Darwin 通知的送出與接收。
你無法透過 Darwin 通知傳遞物件,它只能攜帶一個名稱與一個 userInfo 字典。
Darwin 通知不具持久性,而是即時投遞。因此,若觀察者被掛起、終止或放到背景,通知就會就此消失。
如果我沒實作靜態或動態通知介面會怎樣?
即使你沒有 Watch App,系統仍會在錶面上為你的 iPhone App 顯示通知。只是預設的通知介面毫無自訂風格可言;而且若通知帶有互動操作,系統會在錶面上把這些操作隱藏起來。
setImage(_:) 與 setImageNamed(_:) 有什麼不同?
如果你要顯示的圖片已經快取在手錶上,或已放進 Watch App bundle 的 asset catalog,請用 setImageNamed(_:)。若圖片尚未快取,則用 setImage(_:),它會透過無線傳輸把圖片資料送到 Apple Watch。
圖片會在以下任一條件成立時於手錶端完成快取:
它與 Watch App target 綁在一起,也就是屬於該 target 的 asset catalog。
事先透過 WKInterfaceDevice 的 addCachedImage(_:name:) 或 addCachedImageWithData(_:name:) 明確快取。
Watch App 可以用 iCloud 嗎?
可以。Apple 的範例工程《Lister: A Productivity App》就示範了 iCloud 在這個情境下的實際用法。
我要怎麼在 Watch App 裡加上動畫?
Apple Watch 上只有一種播放動畫的方式:image sequences。想讓內容動起來,你必須事先準備好一整批圖片,然後像翻頁書一樣反覆循環播放。GIF 動畫的時代回來了。

在 WKInterfaceImage 物件中依序呈現一組靜態圖片,就能做出自訂動畫:
@IBOutlet weak var image: WKInterfaceImage? ... image?.setImageNamed(image1) // Load the initial image using the required format image?.startAnimating() // Starts animating ... image?.stopAnimating() // Optional. Stops animating.
如果只想播放其中一段,可以用這個寫法:
image?.startAnimatingWithImagesInRange(range, duration: 2, repeatCount: 1)
我可以透過程式碼為 Apple Watch 產生動畫嗎?
可以,只是形式和你想像的可能不同——如前面所述,目前沒有 Core Animation 或類似框架可用。你能做的是用 Core Graphics 把動畫的每一幀渲染到離屏上下文中,轉成 UIImage 實例,最後在 Apple Watch 上得到一組可播放的圖片序列。
下面的程式片段示範如何用 Core Graphics 逐幀產生圖像,做出移動的圓圈動畫(程式碼出自 Jack Wu 的《WatchKit by Tutorials》):
// Create an offscreen context
UIGraphicsBeginImageContextWithOptions(size, opaque, scale)
let context = UIGraphicsGetCurrentContext()
for centerX in 0..<100 {
// Draw a circle at centerX.
// Create a snapshot.
let image = UIGraphicsGetImageFromCurrentImageContext()
// Write the image as a file
let data = UIImagePNGRepresentation(image)
let file = "path/image_\(centerX).png"
data.writeToFile(file, atomically: true)
}
// End the context.
UIGraphicsEndImageContext()
實際效果可參考下方動圖:

Apple Watch 上的最大動畫 frame rate 是多少?
你無法在 Apple Watch 上手動設定 frame rate,只能設定動畫長度,剩下的交給系統決定。
若圖片序列需要無線傳輸(也就是尚未快取),frame rate 可達 10fps;若圖片已透過快取或 WatchKit App bundle 的 asset catalog 存在於錶上,則可達 30fps。
我該如何同時執行並除錯 iPhone App 與 Apple Watch App?
先建置並執行 Watch App,這會啟動 Apple Watch 模擬器、運行 Watch App,並接上除錯器。
接著在 iOS 模擬器上點擊 iPhone App 的圖示將它啟動。
回到 Xcode,從上方選單選擇 Debug → Attach To Process,再挑選對應的 iPhone App。Xcode 的 Debug Navigator 會多出一個新的 process,iPhone App 與除錯器就此連上。
WatchKit 擴充功能要做單元測試怎麼辦?
做法和你替 iPhone、iPad App 寫測試時一樣:為工程的 WatchKit extension 加一個新的單元測試 target 即可。差別在於,你不能把 Watch App 指定為 Host Application。

對 iPhone App target 而言,iPhone App 會顯示為 Host Application。

但對 WatchKit Extension target 來說,是沒有 Host Application 的。
因此你必須手動把每個要測試的檔案明確加入 WatchKit extension 的單元測試 target。

從 WatchKit 擴充功能中,把你要測試的檔案逐一加入單元測試 target。
該怎麼在 WatchKit 擴充功能與它的 containing iOS App 之間共享資料?
你需要使用 App Groups:它指向本機檔案系統中的一個容器,擴充功能與 containing iPhone App 都能存取。你可以定義多個 App Groups,讓不同擴充功能各自取用。
啟用 App Groups 之後,可任選下列任一做法:
直接讀寫共享容器。透過 NSFileManager 取得共享容器的 URL:
let kMyAppGroupName = "com.rayWenderlich.mywatchapp.container" var sharedContainerURL: NSURL? = NSFileManager.defaultManager(). containerURLForSecurityApplicationGroupIdentifier(kMyAppGroupName)
使用共享的 NSUserDefaults。要在共享容器中建立預設值儲存區,請用 NSUserDefaults(suiteName:) 初始化一個新實例,並傳入 App Group 的識別碼:
let kMyAppGroupName = "com.rayWenderlich.mywatchapp.container" let sharedUserDefaults = NSUserDefaults(suiteName: kMyAppGroupName)
特別注意:共享容器可能被多個 process 同時存取,因此讀寫時必須仔細協調,否則資料可能損毀。官方建議使用 NSFilePresenter 與 NSFileCoordinator 來協調讀寫。但我們還要補一句:不建議在 App 擴充功能裡使用檔案協調 API,因為它們會造成死鎖。
問題根源出在 App 擴充功能的生命週期。App 擴充功能只有三種狀態:running、suspended 與 terminated。如果一個使用檔案協調 API 的擴充功能在寫入途中被掛起,它就永遠沒機會釋放所有權,其他 process 於是死鎖。
相較之下,iPhone 或 iPad App 進入背景時會透過 app delegate 收到通知,可以趁機移除 file presenters,等 App 回到前台再加回來。
另一個可行方向是採用原子性的安全寫入,例如 NSData 的 writeToURL(_:atomically:)。SQLite 與 Core Data 也能讓多個 process 安全共享同一容器中的資料,即使其中之一在交易處理中被掛起也不成問題。
想了解更多,請參閱 Technical Note TN2408: Accessing Shared Data from an App Extension and its Containing App。
怎麼讓 Watch App 與 iPhone App 共用一個 Core Data 資料庫?
要共用 Core Data 的永久儲存檔,本質上和共享一般資料的做法一樣。以下程式片段示範具體實作:
let kMyAppGroupName = "com.rayWenderlich.mywatchapp.container"
var sharedContainerURL: NSURL? = NSFileManager.defaultManager().
containerURLForSecurityApplicationGroupIdentifier(kMyAppGroupName)
if let sharedContainerURL = sharedContainerURL {
let storeURL = sharedContainerURL.URLByAppendingPathComponent("MyCoreData.sqlite")
var coordinator: NSPersistentStoreCoordinator? =
NSPersistentStoreCoordinator(managedObjectModel: self.managedObjectModel)
coordinator?.addPersistentStoreWithType(NSSQLiteStoreType,
configuration: nil,
URL: storeURL,
options: nil,
error: nil)
}
我可以為 Apple Watch 做遊戲嗎?哪種類型的遊戲適合?
現在斷言哪種遊戲會成功、使用者是否願意在錶面上玩遊戲,都還太早。但有一點無疑:你需要換個角度思考 Apple Watch。還記得 iPhone 與 iPad 上的遊戲,和使用者對筆電遊戲的心理期待有多不同嗎?Apple Watch 同樣需要一條獨一無二的思路。
我們已經知道能做的事很有限:沒有存取硬體的 API、不支援手勢辨識、也不允許使用者在螢幕上自由繪製。請記住,你手上只有那些原生介面元素。
但也別讓這些限制澆熄你的想像力——把它們當成基本規則就好。

該怎麼透過 Apple Watch App 賺錢?
現在談這個仍有點言之過早。可以先記住一件事:它不支援 iAd。考量到螢幕極小、使用者與 Watch App 互動的時間有限,畫面廣告很可能只會招人反感,而無論用哪種形式呈現,收益都不太划算。
同樣地,WatchKit 擴充功能是包在 App bundle 裡的,你無法停用,也攔不住使用者安裝,因此它不能當作「用 IAP 解鎖功能」的差異化籌碼。
不過,還是存在幾條讓 WatchKit 擴充功能变现的思路:
如果你在 App Store 上同時有免費版與付費版,那就只在付費版中實作 WatchKit 擴充功能。
如果你的 App 使用 IAP,可以在擴充功能中只呈現有限資訊,讓使用者透過 IAP 解鎖更多功能。
這顯然不是一份窮盡所有可能的清單,但有件事很明確:你必須像打造 Watch App 本身一樣發揮創意,才能讓它真正帶來收益。
有什麼理由讓開發者相信,單靠為 App Store 開發 Watch App 就能維生?
Apple Watch 確實是一個充滿機會的全新平台,但它大概不會重現 App Store 初次登場時的那段黃金年代。
值得留意的是:Apple Watch 是個完全不同的命題。以它的美學價值與價格標籤來看,它比較接近一則可以與 iPhone 對話的訊息,而非基礎配備。
話雖如此,WatchKit 擴充功能反而更容易讓 App 脫穎而出——就像當初原生 iPad App 比單純縮放的 iPhone App 更成功一樣。一款構思周密、設計精良,並與 iPhone App 相互搭配的 Apple Watch App,確實能帶動銷售。
如果這裡沒提到你想問的(我知道你有!),歡迎在下方留言告訴我們。我們會挑出最常被問到、最有意思,甚至最棘手的那些問題補進來。
原文連結:
https://www.raywenderlich.com/94672/watchkit-faq