iOS Widget 开发

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

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


    1
2

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

  • 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这个来的。

代码共享等等
  • 如果你要让主app里的文件,Widget 也能用,很简单。将文件的target membership 勾选widget工程就行了。


    target membership
  • 如果你要使用pod,在podfile里多加个target就行了

target 'WidgetDD' do

end

注意你的Configurations 和Link Binary(不过一般应该自动就设置好了)


Configurations

Link Binary
  • 如果你要做Widget 多语言,一样的,把多语言文件target membership勾一下,把主app里的多语言配置文件分享出来就可以了。

差不多就是这写这么多了,这东西记得尽量呈现功能比较简单的,交互性不强的东西哟,毕竟是一个小的扩展程序。(不知道漏了什么没有,漏了以后再加, 赫赫)。

你可能感兴趣的:(iOS Widget 开发)