iOS Widget 开发1

162 阅读3分钟

「这是我参与2022首次更文挑战的第11天,活动详情查看:2022首次更文挑战」。

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

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

image.png

image.png

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

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

image.png

下面实现相应的方法
- (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里各加上:

image.png

image.png

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

数据共享

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

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

image.png

这时候你就可以共享数据了。两种方式:
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"];