最近在研究iOS的一些扩展,在找资料的过程中,发现说的大多不够详尽,抱着学习总结的目的,想把自己研究学习的过程记录一下,有说的不对的地方欢迎大家批评指正,互相学习。
Widget主要作用是显示一些重要的及时性信息,或者提供一些重要常用功能入口。而且由于插件不允许键盘输入,所以用户需要能使用containing app来配置插件行为。
我是在已有的项目上添加的widget扩展,File->New->Target->Today Extension->命名为“WidgetTest”
我选择纯代码编程,所以呢,毅然决然的删去了MainInterface.storyboard,在info.plist中可以看到有一项NSExtension,删去其中NSExtensionMainSoryboard,新增NSExtensionPrincipalClass,键值对应的是Widget中的自定义视图控制器(默认是TodayViewController)。
你一定迫不及待想看看运行出来是什么样子了吧,在TodayViewController.m中布局你想写的
一、显示
UILabel *displayLbl = [[UILabel alloc] initWithFrame:CGRectMake(30, 50, 200, 30)];
displayLbl.text = @"我就是Widget啦";
displayLbl.textColor = [UIColor whiteColor];
[self.view addSubview:displayLbl];
运行后就可以看到了,可以将target直接选成widget,在iOS10上这么写没问题,但在之前的版本,可能要在上段代码后面追加下面一句,高度自定义
self.preferredContentSize = CGSizeMake(self.view.bounds.size.width, 100);
widget1.png
二、跳转
接下来说怎么从widget跳转到containing APP中去
UIButton *openApp = [UIButton buttonWithType:0];
openApp.frame = CGRectMake(10, 10, 100, 30);
[openApp setTitle:@"打开应用" forState:UIControlStateNormal];
[openApp setTitleColor:[UIColor whiteColor] forState:UIControlStateNormal];
[self.view addSubview:openApp];
[openApp addTarget:self action:@selector(openMyApplication) forControlEvents:UIControlEventTouchUpInside];
- (void)openMyApplication {
NSURL *url = [NSURL URLWithString:@"WidgetDemoOpenViewController://"];
[self.extensionContext openURL:url completionHandler:^(BOOL success) {
}];}
现在说明跳转链接中的@"WidgetDemoOpenViewController://"是怎么来的?
由于Widget里面是没有UIApplication类的,所以很多相关方法都不能用。可以在主应用里添加URL Schemes
屏幕快照 2017-01-04 18.26.09.png三、containing App和widget的数据共享
widget的bundleid一般命名为containing App的bundleid.widget
登录开发者账号,在Identifiers里创建一个具有AppGroups功能的App ID,还要配备对应的develop和distribution的provisioning profile,然后更新一下本机的证书和签名
屏幕快照 2017-01-18 11.37.31.png
然后在containing App和widget两个target的Capabilities里,有个App Groups选项,打开这个选项,勾选上App Groups ID,要确保下面的三个小对勾都是正常的
屏幕快照 2017-01-18 11.52.03.png
当这步完成以后就可以共享数据了,可以通过NSUserDefaults、NSFileManager
NSUserDefaults
存:
NSUserDefaults *shared = [[NSUserDefaults alloc]initWithSuiteName:@"group.widget.**"];
[shared setBool:_isDebugServer forKey:kWidgetIsDebugServer];
[shared synchronize];
取:
NSUserDefaults *shared = [[NSUserDefaults alloc]initWithSuiteName:@"group.widget.**"];
BOOL isDebugServer = [shared boolForKey:kWidgetIsDebugServer];
NSFileManager
存:
NSURL *containerURL = [[NSFileManager defaultManager] containerURLForSecuri
tyApplicationGroupIdentifier:@"group.widget.**"];
containerURL = [containerURL URLByAppendingPathComponent:@"Library/Caches/
widget"];
NSString *value = @"my name";
BOOL result = [value writeToURL:containerURL atomically:YES encoding:NSUTF8StringEncoding error:nil];
取:
NSURL *containerURL = [[NSFileManager defaultManager] containerURLForSecuri
tyApplicationGroupIdentifier:@"group.widget.**"];
containerURL = [containerURL URLByAppendingPathComponent:@"Library/Caches/
widget"];
NSString *value = [NSString stringWithContentsOfURL:containerURL encoding:
NSUTF8StringEncoding error:nil];
四、网络请求
开始想共用containing App里的网络请求和解析模块,由于containing App引入了很多别的类,牵涉太广,所以很难共用,Widget所需的数据内容本身就不会很多,一般一个接口就可以解决,所以用NSURLConnection发送网络请求就好了,请求回来的数据想解析成对应的模型,可以自己写对应的映射,我用了一个比较便捷的工具JSONExport(github上有很多,如:https://github.com/Ahmed-Ali/JSONExport.git)
NSString *requestUrl = [NSString stringWithFormat:@"%@Commons/Widget",isDebugServer?kApiTestURLString:kApiOnlineURLString];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:requestUrl]];
[request setHTTPMethod:@"GET"];
NSURLResponse *response = nil;
NSData *data = [NSURLConnection sendSynchronousRequest:request returningResponse:&response error:NULL];
if (data) {
result = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingMutableContainers error:NULL];
if ([result isKindOfClass:[NSDictionary class]]) {
HBWidgetEntity *widgetEntity = [[HBWidgetEntity alloc] initWithDictionary:[result mutableCopy]];
self.widgetEntity = widgetEntity;
}
}
到这里就得到显示用的数据模型了
五、遇到的坑
containing App最低适配到iOS7.0,widget最低适配到iOS8.0,由于项目使用的是脚本打包,脚本里指定Target是7.0,所以上传App Store时一直报错“The value for the key ‘MinimumOSVersion’ in bundle *** is invalid.The minimum value is 8.0”
屏幕快照 2017-01-12 09.51.48.png
可在脚本里编译的时候不指定Target,或直接通过Product里的archive打包就没有这个问题了。
网友评论