
NSUserDefaults 是快速共享資訊的捷徑,適合存放體積小、需要頻繁讀取與計算的資料,例如使用者名稱、設定檔資訊等。使用時要注意:它應該承載相對靜態的內容,讓使用者不必去操心數值何時變動。
要讓裝置間共享資料,必須先設定 App Group,讓雙方透過共享容器互通,並確認 Watch 擴充與 iOS target 都完成了設定——本質上就是為兩端建立同一個 App Group 標識符。要移除時,用類似的方式即可。
接著用先前建立的 App Group 名稱取得 defaults,為特定的 key 設定物件。在 iPhone 上,使用者輸入文字並儲存,文字就寫入共享的 UserDefaults;在 Watch 端,從 App Group 取出 defaults 後即可更新腕錶上的顯示內容。
// on the iPhone app
let defaults = NSUserDefaults(suiteName: "group.com.natashatherobot.userdefaults")
let key = "userInput"
override func viewDidLoad() {
super.viewDidLoad()
textLabel.text = defaults?.stringForKey(key) ?? "Type Something..."
}
@IBAction func onSaveTap(sender: AnyObject) {
let sharedText = textField.text
textLabel.text = sharedText
defaults?.setObject(sharedText, forKey: key)
defaults?.synchronize()
}
// WatchKit class
class InterfaceController: WKInterfaceController {
@IBOutlet weak var textLabel: WKInterfaceLabel!
let defaults = NSUserDefaults(suiteName: "group.com.natashatherobot.userdefaults")
var userInput: String? {
defaults?.synchronize()
return defaults?.stringForKey("userInput")
}
}資料量更大時,NSFileCoordinator 是管理 App 與 Watch 擴充共享空間檔案的方式之一,既適合清單型內容,也能處理圖片檔。
下面的例子是一個簡單的待辦清單 App:在手機上新增任務,同步到 WatchKit 擴充後顯示在腕錶上。你的視圖控制器需要遵循 NSFilePresenter 協定,除了實作兩個必要方法外其餘都不算關鍵。FilePresenter 協定提供一個 item URL,也就是填 App Group 標識符的地方;透過這個 URL,你在對應目錄建立檔案,必要時也能用操作佇列控制多執行緒存取。
另外,presentedItemDidChange 這個代理方法會通知你是否某個物件發生了變動,讓你能更新 App 資料而不必靠使用者手動重新整理。
不過在當時,NSFileCoordinator 與 NSFilePresenter 之間存在一個 bug,導致它在擴充中不太好用,細節可參考 Natasha 的網站。
在待辦陣列中利用 FileCoordinator 寫入檔案時,可以透過讀寫檔案來打包與解包事項資料,再依檔案內容計算並產生表格。要留意的是:如果你實作了刪除功能,而 Watch 擴充與 iPhone App 都能修改同一份檔案,就會遇到執行緒同步的困擾。
// iPhone app
private func saveTodoItem(todoItem: String) {
// write item into the todo items array
if let presentedItemURL = presentedItemURL {
fileCoordinator.coordinateWritingItemAtURL(presentedItemURL, options: nil, error: nil) { [unowned self] (newURL) -> Void in
self.todoItems.insert(todoItem, atIndex: 0)
let dataToSave = NSKeyedArchiver.archivedDataWithRootObject(self.todoItems)
let success = dataToSave.writeToURL(newURL, atomically: true)
}
}
}
// in the Watch
// MARK: Populate Table From File Coordinator
private func fetchTodoItems() {
let fileCoordinator = NSFileCoordinator()
if let presentedItemURL = presentedItemURL {
fileCoordinator.coordinateReadingItemAtURL(presentedItemURL, options: nil, error: nil) { [unowned self] (newURL) -> Void in
if let savedData = NSData(contentsOfURL: newURL) {
self.todoItems = NSKeyedUnarchiver.unarchiveObjectWithData(savedData) as! [String]
self.populateTableWithTodoItems(self.todoItems)
}
}
}
}「If the code appears more than once, it probably belongs in a framework.」——WWDC 2014, Building Modern Frameworks
框架很適合承載業務邏輯、Core Data 與可重複使用的 UI 元件。就像 WWDC 所說,重複出現的程式碼該被抽成框架。在上面的 FileCoordinator 範例裡,取得與讀寫檔案的程式碼出現了兩次,正好可以抽進同一個 framework。
建立框架很簡單:新增 target、選擇 Cocoa Touch Framework、命名即可。它會自動被鏈進你的 iOS App,但别忘了也要在 WatchKit 擴充中手動加入鏈接。
關鍵的一點(對 Swift 尤其重要)是:把框架當成一個 API 來看待。它必須宣告為 public,因為這是 iOS App 與 WatchKit 擴充共用的介面。所以當你建立類別、屬性、方法時,記得加上 public 關鍵字,這樣兩端引入框架後才能存取這些成員。
import WatchKit
import MySharedData
class InterfaceController: WKInterfaceController {
@IBOutlet weak var favoriteThingsLabel: WKInterfaceLabel!
override func awakeWithContext(context: AnyObject?) {
super.awakeWithContext(context)
let myFavoriteThings = MySharedData().myFavoriteThings
let favoriteThingsString = ", ".join(myFavoriteThings)
favoriteThingsLabel.setText("My favorite things are \(favoriteThingsString)")
}
}當 UserDefaults 提供的安全性不足時,鑰匙圈共享能兼顧資料安全與跨擴充的共享能力。
WatchKit 當時有個大問題:沒有身份驗證機制。Apple 提供的 KeychainItemWrapper 範例 API 太舊、不支援 ARC,我推薦使用這個基於 ARC 且介面清晰的版本:https://gist.github.com/dhoerl/1170641
重點在於如何透過 access group 初始化 KeychainItemWrapper。概念與 App Group 類似——裝置之間存在共享空間。你需要在 iOS 與 WatchKit 擴充兩邊都設定鑰匙圈,並用同一個標識符建立同類型的 keychain 項目。以下範例展示的是:使用者填好帳號密碼後,WatchKit 擴充如何讀出這些資料。
// iPhone app
@IBAction func onSaveTap(sender: AnyObject) {
let username = usernameTextField.text
let password = passwordTextField.text
let keychainItem = KeychainItemWrapper(identifier: "SharingViaKeychain",
accessGroup: "W6GNU64U6Q.com.natashatherobot.SharingViaKeychain")
}
// WatchKit extension
let keychainItem = KeychainItemWrapper(identifier: "SharingViaKeychain",
accessGroup: "W6GNU64U6Q.com.natashatherobot.SharingViaKeychain")
let passwordData = keychainItem.objectForKey(kSecValueData) as! NSData
let password = NSString(data: passwordData, encoding: NSUTF8StringEncoding)
let username = keychainItem.objectForKey(kSecAttrAccount) as? String