您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 10 Today Widget 實作教學:從建立擴展到與主 App 共享資料

編輯:iOS 開發綜合

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,否則系統會認為更新失敗並降低後續刷新頻率。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved