Today Extension 讓使用者在下拉通知中心時快速取得資訊,是 iOS 10 中值得投入的輕量入口。本文依序說明四個環節:如何為既有工程加上 widget、如何繪製 UI、如何從 widget 跳回 App、以及如何與宿主 App 共享資料。

圖 1 Today 中的 widget 外觀
一、為既有工程新增 Today Extension
在 Xcode 中選擇 File → New → Target,加入 Application Extension 下的 Today Extension。建立完成後,工程目錄會多出一個獨立的 target。

圖 2 新增 Today 的 target

圖 3 加入 Today 之後的工程目錄
到這一步直接執行,就能在下拉通知中心看到一個預設樣式的 widget,非常省事。
二、繪製 UI

圖 4 刪除預設的 MainInterface 並修改 Info.plist
如果習慣純程式碼佈局,可以刪掉預設產生的 MainInterface.storyboard,並依圖 4 調整 Info.plist 中對應的設定(把 NSExtensionMainStoryboard 換成 NSExtensionPrincipalClass)。習慣 storyboard 的人跳過這步即可。

圖 5 設定 widget 展示視圖的大小
接著設定 widget 的預期尺寸,背景色與具體內容依需求自行繪製。

圖 6 讓 widget 視圖貼齊左側邊界
執行後會發現一個惱人的問題:內容左側會留出約 30pt 的空白。這是系統預設的內距,解法是遵守 NCWidgetProviding 協議並實作 widgetMarginInsetsForProposedMarginInsets:,把左邊距改為 0:
- (UIEdgeInsets)widgetMarginInsetsForProposedMarginInsets:(UIEdgeInsets)defaultMarginInsets {
return UIEdgeInsetsMake(defaultMarginInsets.top, 0, defaultMarginInsets.bottom, defaultMarginInsets.right);
}
三、從 widget 跳回 App
Extension 與宿主 App 是兩個獨立進程,彼此不能直接通訊,也不能像 App 內部那樣直接跳頁面。標準做法是透過 extensionContext 的 openURL:,由系統代為開啟 App,並在 App 側用 URL Scheme 路由到目標頁面。
- (void)openURLContainingAPP {
[self.extensionContext openURL:[NSURL URLWithString:@"appextension://xxx"] completionHandler:^(BOOL success) {
NSLog(@"open url result:%d", success);
}];
}
四、與宿主 App 共享資料

圖 7 添加 App Groups
先在主 App 與 Extension 兩個 target 的 Capabilities 中同時開啟 App Groups 並加入同一個 group identifier,之後就有兩種共享方式。
方式一:NSUserDefaults
保存:
- (void)saveDataByNSUserDefaults {
NSUserDefaults *shared = [[NSUserDefaults alloc] initWithSuiteName:@"group.com.xxx"];
[shared setObject:@"asdfasdf" forKey:@"widget"];
[shared synchronize];
}
讀取:
- (NSString *)readDataFromNSUserDefaults {
NSUserDefaults *shared = [[NSUserDefaults alloc] initWithSuiteName:@"group.com.xxx"];
return [shared valueForKey:@"widget"];
}
方式二:NSFileManager
保存:
- (BOOL)saveDataByNSFileManager {
NSError *err = nil;
NSURL *containerURL = [[NSFileManager defaultManager] containerURLForSecurityApplicationGroupIdentifier:@"group.com.xxx"];
containerURL = [containerURL URLByAppendingPathComponent:@"Library/Caches/widget"];
NSString *value = @"asdfasdfasf";
BOOL result = [value writeToURL:containerURL atomically:YES encoding:NSUTF8StringEncoding error:&err];
if (!result) {
NSLog(@"%@", err);
} else {
NSLog(@"save value:%@ success.", value);
}
return result;
}
讀取:
- (NSString *)readDataByNSFileManager {
NSError *err = nil;
NSURL *containerURL = [[NSFileManager defaultManager] containerURLForSecurityApplicationGroupIdentifier:@"group.com.xxx"];
containerURL = [containerURL URLByAppendingPathComponent:@"Library/Caches/widget"];
return [NSString stringWithContentsOfURL:containerURL encoding:NSUTF8StringEncoding error:&err];
}
幾點實務提醒
第一,NSUserDefaults 適合存少量輕量設定,若要放快取檔案或圖片,走共享容器路徑更合適。
第二,widget 的記憶體上限遠低於主 App(實測大約十幾 MB 等級),一旦超標系統會直接終止擴展,因此不要在 widget 裡載入大圖或做重運算。
第三,widget 的內容更新交給 NCWidgetProviding 的 widgetPerformUpdateWithCompletionHandler:,完成後記得呼叫 completion handler 並回傳 NCUpdateResultNewData,否則系統會認為更新失敗並降低後續刷新頻率。