上一篇說明了如何在 iOS 8.0 到 9.3 上實作 widget,但 iOS 10 已經登場,不做適配實在說不過去。這篇就來談談 iOS 10 上 Today Widget 會遇到的那些坑。
裝上 iOS 10 beta 之後可以明顯感受到蘋果對 widget 的重視程度:主打快速瀏覽,讓使用者不必進入 App 就能掌握重點。
現在從鎖屏頁面的通知中心、下拉通知欄的第一頁,甚至左滑主畫面都能抵達 widget。透過右上角的「展開/折疊」按鈕,可以切換顯示全部內容或部分內容;在 iPhone 6s 上,長按 App 圖示的 3D Touch 選單中也會出現 widget 的摺疊狀態。

NSExtensionContext 新增了 widgetLargestAvailableDisplayMode 屬性,用來確認 widget 目前處於展開或折疊狀態。因此先在 viewWillAppear 中把模式設為展開:
程式碼 1
- (void)viewWillAppear:(BOOL)animated { [super viewWillAppear:animated]; self.extensionContext.widgetLargestAvailableDisplayMode = NCWidgetDisplayModeExpanded; }
接著處理切換行為。NCWidgetProviding 協議新增了 widgetActiveDisplayModeDidChange 方法,直接看程式碼:
程式碼 2
// If implemented, called when the active display mode changes. // The widget may wish to change its preferredContentSize to better accommodate the new display mode. - (void)widgetActiveDisplayModeDidChange:(NCWidgetDisplayMode)activeDisplayMode withMaximumSize:(CGSize)maxSize { if (activeDisplayMode == NCWidgetDisplayModeCompact) { self.preferredContentSize = CGSizeMake([UIScreen mainScreen].bounds.size.width, 110); } else { self.preferredContentSize = CGSizeMake([UIScreen mainScreen].bounds.size.width, 300); } }
這個問題出在 preferredContentSize 的設定時機:在確認 widget 模式之前就先設了這個值,系統會依錯誤的高度呈現。筆者的處理方式是把高度設定集中到 widgetActiveDisplayModeDidChange 裡,如程式碼 2 所示。實際專案的判斷邏輯比這複雜得多,此處為簡化只保留示例。
這個現象的前提通常是:展開與折疊對應的高度不同,但點了按鈕之後只看到右上角內容改變,高度卻沒變。原因同樣是切換模式後沒有同步更新 preferredContentSize。回到程式碼 2,在模式改變後設定對應高度即可解決。
問題在於:widgetLargestAvailableDisplayMode 與 NCWidgetDisplayMode 都是 iOS 10 才有的產物,用 Xcode 7.3 打包根本編不過,但又不能永遠停在 Xcode 8 beta。這時可以改用 KVC 繞過編譯期檢查:
程式碼 3(對應程式碼 1)
- (void)viewWillAppear:(BOOL)animated { [super viewWillAppear:animated]; [self.extensionContext setValue:@"1" forKey:@"widgetLargestAvailableDisplayMode"]; }
程式碼 4(對應程式碼 2)
- (void)widgetActiveDisplayModeDidChange:(NSInteger)activeDisplayMode withMaximumSize:(CGSize)maxSize { if (activeDisplayMode == 0) { self.preferredContentSize = CGSizeMake([UIScreen mainScreen].bounds.size.width, 110); } else { self.preferredContentSize = CGSizeMake([UIScreen mainScreen].bounds.size.width, 300); } }
//通知主線程刷新 dispatch_async(dispatch_get_main_queue(), ^{ //...........; });
以上就是筆者在適配 widget 過程中遇到的問題與解法,希望可以幫助正在處理相同狀況的朋友。整體來說,iOS 10 的 widget 適配重點集中在兩件事:模式狀態的掌握,以及 preferredContentSize 的設定時機。有疑問歡迎留言交流。