iOS Widget 开发

2018-08-13 本文已影响114人水煮杰尼龟

现在看起来，Widget扩展应用貌似渐渐的火了起来。不过确实有这个东西，也挺方便的，比如查看应用展示的简略信息，不用进入应用，也可以快捷的操作一些app的功能等。
按照官方介绍：Today视图中的App扩展称为小部件。窗口小部件使用户可以快速访问当前重要的信息。例如，用户打开“今日”视图以检查当前股票价格或天气状况，查看今天的计划，或执行快速任务，例如将项目标记为已完成。用户倾向于经常打开Today视图，并且他们希望他们感兴趣的信息能够立即可用。如果用户已启用此功能，则“今日”窗口小部件可以显示在iOS设备的锁定屏幕上。他们通过转到设置>触摸ID和密码>通知视图在“允许锁定时访问”区域中执行此操作。
那么接下来我们就一步步来做一下这个东西

首先在你的工程里选择·File>New>Target> Today Extension 创建一个扩展程序。创建完成你的工程里就会多这么一个文件夹，多了一个target.

1

这个时候你运行工程就会看到它了。

Widget的UI，默认是SB的。如果你要代码的话，删除Info.Plist->NSExtension里NSExtensionMainStoryboard字段,添加NSExtensionPrincipalClass字段并设为TodayViewController即可。

3

下面实现相应的方法

- (void)viewDidLoad {
    [super viewDidLoad];
    // Do any additional setup after loading the view from its nib.
    //设置这个才有展开按钮
    if (@available(iOS 10.0, *)) {
        self.extensionContext.widgetLargestAvailableDisplayMode=NCWidgetDisplayModeExpanded;
    }
}
//折叠，收起高度设置 min 110, max 528
-(void)widgetActiveDisplayModeDidChange:(NCWidgetDisplayMode)activeDisplayMode withMaximumSize:(CGSize)maxSize
API_AVAILABLE(ios(10.0)){
    if (activeDisplayMode == NCWidgetDisplayModeCompact) {
        self.preferredContentSize = CGSizeMake([UIScreen mainScreen].bounds.size.width, 110);
    } else {
        self.preferredContentSize = CGSizeMake([UIScreen mainScreen].bounds.size.width, 528);
    }
}
//通过openURL的方式启动Containing APP,可以在appdelegate里做一些回调处理。
- (void)openURLContainingAPP
{
    //scheme为app的scheme
    [self.extensionContext openURL:[NSURL URLWithString:@"WidgetTest://"]
                 completionHandler:^(BOOL success) {
                     NSLog(@"open url result:%d",success);
                 }];
}

跳转app里的话，记得app的URL Types和扩展程序的Info.Plist里各加上：

4.png

5.png

以上基本上就是Widget的简单操作了。
然后我们来看一下Widget和App的交互。

数据共享

由于拓展与宿主应用是两个完全独立的App，并且iOS应用基于沙盒的形式限制，所以一般的共享数据方法都是实现不了数据共享，这里就需要使用App Groups。（上架的话也需要自己appid 和app group的哟）

在你的拓展与宿主应用里分别都把App Groups打开，设置一个group的名称，这里要保证宿主APP和扩展APP的groupName要是相同的，一般都是group+bundle id的。

App Groups

这时候你就可以共享数据了。两种方式：

NSUserDefault

//写
NSUserDefaults *userDefaults = [[NSUserDefaults alloc] initWithSuiteName:@"你的App Group"];
[userDefaults setObject:self.textField.text forKey:@"widget"];
[userDefaults synchronize];
//读
NSUserDefaults *userDefaults = [[NSUserDefaults alloc] initWithSuiteName:@"你的App Group"];
NSString *str = [userDefaults objectForKey:@"widget"];

NSFileManager

//写
NSError *err = nil;
NSURL *url = [[NSFileManager defaultManager] containerURLForSecurityApplicationGroupIdentifier:@"你的App Group"];
url = [url URLByAppendingPathComponent:@"Library/Caches/ widget"];
NSString *str = @"hahahaha";
BOOL result = [str writeToURL:url atomically:YES encoding:NSUTF8StringEncoding error:&err];
if (!result)
{
    NSLog(@"%@",err);
}
else
{
    NSLog(@"save:%@ success.",str);
}
//读
NSError *err = nil;
NSURL *url = [[NSFileManager defaultManager] containerURLForSecurityApplicationGroupIdentifier:@"你的App Group"];
url = [url URLByAppendingPathComponent:@"Library/Caches/ widget"];
NSString *str = [NSString stringWithContentsOfURL:url encoding: NSUTF8StringEncoding error:&err];

这样你就可以在app和widget里共享数据了。

通知通信

再来说一下另外一种交互。比如Widget上点击了按钮，app内实时变化。这种情况就不是数据共享可以搞定的了。这里你需要用到CFNotificationCenter。（NSNotificationCenter，KVO，Delegate不要试了没用）代码如下：

static ViewController *vc = nil;

// 发送通知
- (void)postNotificaiton
{
    CFStringRef keys[1];
    keys[0] = CFSTR("wiwi");
    CFStringRef values[1];
    values[0] = CFSTR("90");
    CFDictionaryRef dic = CFDictionaryCreate(NULL, (void*)keys,(void*)values, 1, &kCFTypeDictionaryKeyCallBacks, &kCFTypeDictionaryValueCallBacks);
    CFNotificationCenterRef notification = CFNotificationCenterGetDarwinNotifyCenter ();
    CFNotificationCenterPostNotification(notification, CFSTR("widgetNoti"), NULL, dic, YES);
    
}
// 添加监听
- (void)addObserver
{
    //适当的地方赋值就行
    vc=self
    CFNotificationCenterRef notification = CFNotificationCenterGetDarwinNotifyCenter ();
    CFNotificationCenterAddObserver(notification, (__bridge const void *)(self), observerMethod, CFSTR("widgetNoti"), NULL, CFNotificationSuspensionBehaviorDeliverImmediately);
}

void observerMethod (CFNotificationCenterRef center, void *observer, CFStringRef name, const void *object, CFDictionaryRef userInfo)
{
    NSDictionary  *nsdic = (__bridge_transfer  NSDictionary*)userInfo;
    //拿到传的值后调控制器的方法做刷新
    [vc method:nsdic];
}
// 移除监听
- (void)removeObserver
{
    CFNotificationCenterRef notification = CFNotificationCenterGetDarwinNotifyCenter ();
    CFNotificationCenterRemoveObserver(notification, (__bridge const void *)(self), CFSTR("widgetNoti"), NULL);
}

看起来很流畅，结果确实值根本传不过来，尴尬了。看一下官方文档说的就是If center is a Darwin notification center, this value is ignored.。
但是这也问题不大，能收到通知就行，可以通过App Group来拿数据。当然你也可以用第三方库来做，MMWormhole ，也是基于CFNotificationCenter这个来的。