iOS 8開(kāi)始, 蘋(píng)果公司推出了today widget. 用來(lái)方便用戶查看各個(gè)app的個(gè)性消息.
目錄
- 創(chuàng)建一個(gè)widget
- 如何去掉today widget的storyboard 的綁定
- widget 布局
- widget喚醒拉起app
- widget和宿主程序間數(shù)據(jù)訪問(wèn)
- 更改widget顯示的名稱
- 設(shè)置widget的展開(kāi)/折疊
- widget也需要配置AppId 和配置文件
- 修改AppID支持App group
- widget工程使用宿主工程中的類文件
- widget工程使用宿主工程中的第三方庫(kù)
- 需要注意的問(wèn)題
創(chuàng)建一個(gè)widget
在需要添加widget功能的工程中, 點(diǎn)擊"file - new - target", 如下圖:
創(chuàng)建后, 工程列表如下圖:
去掉today widget的storyboard 的綁定
我個(gè)人習(xí)慣使用代碼編寫(xiě), 去掉默認(rèn)的storyboard.
點(diǎn)擊widget中的info.plist , 將NSExtension節(jié)點(diǎn)的NSExtensionMainStoryboard子節(jié)點(diǎn)刪除, 添加NSExtensionPrincipalClass子節(jié)點(diǎn), value設(shè)置為類文件名, 例如本案例中的TodayViewController. 修改后如圖:
widget 布局
因?yàn)閣idget容器本來(lái)就存在邊框(大概是8), 計(jì)算容器的寬度, 然后在容器中布局, 需要用屏幕寬度減去 8*2, 如下布局:
- (void)viewDidLoad {
[super viewDidLoad];
self.view.backgroundColor = [UIColor clearColor];
int num = 4;
CGFloat sw = self.view.bounds.size.width -8*2; //容器貌似有兩個(gè)邊距.
CGFloat y = 20;
CGFloat margin = 20;
CGFloat btnW = (sw - margin*(num+1))/num;
for (int i=0; i<num; i++) {
CGFloat x = margin + i*(margin+btnW);
UIButton *btn = [[UIButton alloc] initWithFrame:CGRectMake(x, y, btnW, btnW)];
int tag = i;
UIColor *bgColor = [UIColor redColor];
if (tag == 3) {
bgColor = [UIColor yellowColor];
}
else if(tag == 2){
bgColor = [UIColor blueColor];
}
else if(tag == 1){
bgColor = [UIColor orangeColor];
}
[btn setBackgroundColor:bgColor];
btn.layer.cornerRadius = 8;
btn.tag = i;
[self.view addSubview:btn];
[btn addTarget:self action:@selector(openURLContainingAPP:) forControlEvents:UIControlEventTouchUpInside];
}
}
//去掉默認(rèn)的縮進(jìn)
-(UIEdgeInsets)widgetMarginInsetsForProposedMarginInsets:(UIEdgeInsets)defaultMarginInsets {
return UIEdgeInsetsZero;
}
widget喚醒拉起app
widget控制器中
- (void)openURLContainingAPP:(UIButton *)sender{
//通過(guò)extensionContext借助host app調(diào)起app
[self.extensionContext openURL:[NSURL URLWithString:[NSString stringWithFormat:@"mywidgettest://%@?tag=%ld",kWidgetBiaozhi, (long)sender.tag]] completionHandler:^(BOOL success) {
NSLog(@"open url result:%d",success);
}];
}
appDelegate中
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString *,id> *)options {
NSString *urlStr = url.absoluteString;
if ([urlStr rangeOfString:kWidgetBiaozhi].length>0) {
NSRange range = [urlStr rangeOfString:@"tag="];
int tag = 0;
if (range.length>0) {
tag = [[urlStr substringFromIndex:(range.location+range.length)] intValue];
NSLog(@"tag:%d",tag);
}
UIColor *bgColor = [UIColor redColor];
if (tag == 3) {
bgColor = [UIColor yellowColor];
}
else if(tag == 2){
bgColor = [UIColor blueColor];
}
else if(tag == 1){
bgColor = [UIColor orangeColor];
}
UIView *v = [[UIView alloc] initWithFrame:CGRectMake(0, 0, [UIScreen mainScreen].bounds.size.width, 400)];
v.backgroundColor = bgColor;
[[[[UIApplication sharedApplication] delegate] window] addSubview:v];
}
return YES;
}
widget和宿主程序間數(shù)據(jù)訪問(wèn)
因?yàn)閣idget和程序 是兩個(gè)完全獨(dú)立的進(jìn)程，所以它們之間不能直接通信. 通過(guò)App Groups提供的同一group內(nèi)app共同讀寫(xiě)區(qū)域淫痰，可以用NSUserDefaults和NSFileManager兩種方式實(shí)現(xiàn)extension和containing app之間的數(shù)據(jù)共享。
首先, 需要將程序 和widget 都加入app groups中. (注意是兩個(gè)都要加入). 如圖:
加入組后, 通過(guò)NSUserDefaults方法可以實(shí)現(xiàn)數(shù)據(jù)共享與訪問(wèn):
//保存數(shù)據(jù)
- (void)saveDataByNSUserDefaults{
NSUserDefaults *shared = [[NSUserDefaults alloc] initWithSuiteName:@"group.com.mywidgettest"];
[shared setObject:@"無(wú)聊大法好" forKey:@"widget"];
[shared synchronize];
}
//讀取數(shù)據(jù)
- (NSString *)readDataFromNSUserDefaults{
NSUserDefaults *shared = [[NSUserDefaults alloc] initWithSuiteName:@"group.com.mywidgettest"];
NSString *value = [shared valueForKey:@"widget"];
return value;
}
更改widget顯示的名稱
設(shè)置widget的展開(kāi)/折疊
WidgetViewController 遵守NCWidgetProviding協(xié)議, iOS 10開(kāi)始, NCWidgetProviding提供了widget展開(kāi)/折疊的能力, 如圖:
注意:
折疊狀態(tài)下: 高度固定為110, 即使設(shè)置折疊狀態(tài)的高度, 也不會(huì)起作用
展開(kāi)狀態(tài)下: 如果設(shè)置高度小于110片橡，那么default = 110
展開(kāi)狀態(tài)下: 如果設(shè)置高度大于最大的616较雕，那么default = 616
(5s,6s是110~528, plus是110~616)
/*設(shè)置extensionContext.widgetLargestAvailableDisplayMode*/
- (void)viewDidLoad {
[super viewDidLoad];
//如果需要折疊, 需要設(shè)置extensionContext.widgetLargestAvailableDisplayMode
//iOS 10才可以設(shè)置
if (@available(iOS 10.0, *)) {
self.extensionContext.widgetLargestAvailableDisplayMode = NCWidgetDisplayModeExpanded;
} else {
// Fallback on earlier versions
}
}
/*實(shí)現(xiàn)NCWidgetProviding協(xié)議的-(void)widgetActiveDisplayModeDidChange:(NCWidgetDisplayMode)activeDisplayMode withMaximumSize:(CGSize)maxSize方法*/
// iOS10 新增的方法
// 用來(lái)設(shè)置Widget是展開(kāi)還是折疊狀態(tài)的方法，可以設(shè)置相關(guān)的preferredContentSizes屬性修改大小
-(void)widgetActiveDisplayModeDidChange:(NCWidgetDisplayMode)activeDisplayMode withMaximumSize:(CGSize)maxSize{
if (@available(iOS 10.0, *)) {
if (activeDisplayMode == NCWidgetDisplayModeCompact) {
self.preferredContentSize = CGSizeMake([UIScreen mainScreen].bounds.size.width, 100);
} else {
self.preferredContentSize = CGSizeMake([UIScreen mainScreen].bounds.size.width, 150);
}
} else {
// Fallback on earlier versions
}
}
widget也需要配置AppId 和配置文件
由于widget是一個(gè)獨(dú)立的target, 它擁有區(qū)別于宿主程序的bundle id, 所以它也需要單獨(dú)配置AppID和描述文件.
修改AppID支持App group
增加App group 數(shù)據(jù)共享, 需要修改AppID支持App group.
第一步先在 Identifiers 中的 APPGroup節(jié)點(diǎn), 添加一個(gè)APPGroup的id, 然后宿主程序和widget的appid都需要增加對(duì)APPGroup的支持, 點(diǎn)擊edit按鈕, 將之前增加的APPGroupID添加到列表即可.
widget工程使用宿主工程中的類文件
如果在widget中直接使用宿主工程中的類文件, 會(huì)出現(xiàn)以下報(bào)錯(cuò):(以widget使用宿主程序中的 MyTools工具類為例)
Undefined symbols for architecture arm64: "_OBJC_CLASS_$_MyTools", referenced from: objc-class-ref in TodayViewController.o ld: symbol(s) not found for architecture arm64 clang: error: linker command failed with exit code 1 (use -v to see invocation)
通過(guò)將MyTools.m文件添加到 widget的Build Phases 列表中, 或者將MyTools.m文件的Target Membersship框中勾選widget選項(xiàng), 都可以實(shí)現(xiàn)widget工程使用宿主工程中的類文件, 這兩個(gè)操作是互通的. (添加列表會(huì)自動(dòng)勾選, 添加勾選也會(huì)自動(dòng)添加到列表)
widget工程使用宿主工程中的第三方庫(kù)
如果需要在widget工程中使用宿主工程中的第三方庫(kù)(.frameword 或.a文件), 需要將這些第三方庫(kù)的Target Membersship框中勾選widget選項(xiàng), 這樣就可以在widget中使用這些第三方庫(kù)了.
這時(shí)候你可能會(huì)遇到這樣一種報(bào)錯(cuò):
ld: '/Users/.../IDMPlib/libIDMPCMCC.a(bio_lib.o)' does not contain bitcode. You must rebuild it with bitcode enabled (Xcode setting ENABLE_BITCODE), obtain an updated library from the vendor, or disable bitcode for this target. for architecture arm64 clang: error: linker command failed with exit code 1 (use -v to see invocation)
重點(diǎn)是does not contain bitcode. You must rebuild it with bitcode enabled
build setting中搜索 'bitcode' 將工程和widget都設(shè)置為NO
需要注意的問(wèn)題
1. 我使用xcode 9創(chuàng)建的工程, 在ios 11上運(yùn)行沒(méi)問(wèn)題, 但是在ios 10上卻不能添加widget .(today widget頁(yè)面點(diǎn)擊編輯按鈕,看不到這個(gè)app的待選項(xiàng)).
問(wèn)題愿意: xcode 9新建的widget 默認(rèn)支持系統(tǒng)是ios 11, 需要我們更改這個(gè)支持的版本. 和主工程選擇支持版本一樣:
2. 運(yùn)行報(bào)錯(cuò):Safe Area Layout Guide Before iOS 9.0 MainInterface.storyboard
解決方法, 取消storyboard的 Use Safe Area Layout Guide選項(xiàng).
