ios实现3D touch 和widget功能

释放双眼,带上耳机,听听看~!

3D touch

1.1 info.plist静态配置

 

UIApplicationShortcutItems:数组中的元素就是我们的那些快捷选项标签。
UIApplicationShortcutItemTitle:标签标题(必填)
UIApplicationShortcutItemType:标签的唯一标识 (必填)
UIApplicationShortcutItemIconType:使用系统图标的类型,如搜索、定位、home等(可选)
UIApplicationShortcutItemIcon File:使用项目中的图片作为标签图标 (可选)
UIApplicationShortcutItemSubtitle:标签副标题 (可选)
UIApplicationShortcutItemUserInfo:字典信息,如传值使用 (可选)

1.2 代码配置

UIApplicationShortcutIcon可以为系统的图标,如相机、分享、添加等。也可以用iconWithTemplateImageName:设置自定义图标。
UIApplicationShortcutItem中的Type属性用于区分相应的点击事件。
注意:3D touch相应API在iOS9以后才支持,需要做相应判断,否则程序会崩溃。

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
#ifdef NSFoundationVersionNumber_iOS_8_x_Max
[self set3DTouch:application];
#endif
return YES;
}
#ifdef NSFoundationVersionNumber_iOS_8_x_Max
-(void)set3DTouch:(UIApplication *)application{
UIApplicationShortcutIcon *icon1 = [UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypeCompose];
UIApplicationShortcutItem *item1 = [[UIApplicationShortcutItem alloc] initWithType:@"newType" localizedTitle:@"新增功能" localizedSubtitle:nil icon:icon1 userInfo:nil];
application.shortcutItems = @[item1];
}
#endif

app通过图标的3D touch功能进入时,系统会调入如下方法:

-(void)application:(UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void (^)(BOOL))completionHandler

通过type去区分不同的事件。还可以通过UIApplicationShortcutItem的userInfo属性设置更多种情况。

-(void)application:(UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void (^)(BOOL))completionHandler{
if ([shortcutItem.type isEqualToString:@"newType"]) {
UIAlertController *alert = [UIAlertController alertControllerWithTitle:@"3d touch" message:@"通过图标的3D touch功能进入" preferredStyle:UIAlertControllerStyleAlert];
UIAlertAction *action = [UIAlertAction actionWithTitle:@"back" style:UIAlertActionStyleCancel handler:nil];
[alert addAction:action];
[self.window.rootViewController presentViewController:alert animated:YES completion:nil];
}
}
注意:应用上线之后系统会给应用自动生成一个分享功能,然后测试的时候是不会显示这个分享的。

贴上效果图:

widget

2.1 添加target

file->new->target->Todat Extension

 

 

创建成功之后工程会出现如下文件,然后你就可以在MainInterface.storyboard中绘制界面了。

 

2.2 展开和收缩效果设置

-(void)widgetActiveDisplayModeDidChange:(NCWidgetDisplayMode)activeDisplayMode withMaximumSize:(CGSize)maxSize

实现NCWidgetProviding的代理方法,该方法iOS 10之后才正常,需要做版本判断,ios10之前直接通过preferredContentSize属性设置widget尺寸。iOS 10之后关闭状态下的widget高度是固定的,展开时设置高度才有效。
NCWidgetDisplayModeCompact,// 关闭
NCWidgetDisplayModeExpanded //展开
设置以上两种状态下widget的尺寸
可以在viewDidLoad中设置widget的初始状态(iOS 10以上才支持)

#ifdef NSFoundationVersionNumber_iOS_9_x_Max
self.extensionContext.widgetLargestAvailableDisplayMode = NCWidgetDisplayModeExpanded;
#endif
#ifdef NSFoundationVersionNumber_iOS_9_x_Max
-(void)widgetActiveDisplayModeDidChange:(NCWidgetDisplayMode)activeDisplayMode withMaximumSize:(CGSize)maxSize{
switch (activeDisplayMode) {
case NCWidgetDisplayModeCompact:
self.preferredContentSize = CGSizeMake(maxSize.width,300);
//ios10以后,widget的关闭时高度为固定值,设置没效果。
break;
case NCWidgetDisplayModeExpanded:
self.preferredContentSize = CGSizeMake(maxSize.width,400);
break;
default:
break;
}
}
#endif

2.3 设置widget的显示内容

– (void)viewDidLoad
-(void)viewWillAppear:(BOOL)animated
– (void)widgetPerformUpdateWithCompletionHandler:(void (^)(NCUpdateResult))completionHandler

内容主要在viewDidLoad和viewWillAppear两个方法中设置,每次显示的时候都会调用viewWillAppear,所以在viewWillAppear中展示新内容,可以实时刷新数据(其实有很大一个延时)。
实测:如果widget消失超过三到四秒,viewDidLoad方法将会从新调用,widgetPerformUpdateWithCompletionHandler伴随着也将会调用。
以下是官方文档的说明,

想要在抓取快照前更新插件的状态,那要确保遵照 NCWidgetProviding 协议。当你的插件接收widgetPerformUpdateWithCompletionHandler: 调用时使用最近的内容更新插件视图,并调用completion handler(完成处理程序),使用以下常量来描述更新结果。

不过在后续的测试过程中发现,即使completionHandler传入NCUpdateResultNoData,wedget中的内容依旧会刷新,所以在开发过程中,把widgetPerformUpdateWithCompletionHandler看成viewDidLoad就行。

- (void)widgetPerformUpdateWithCompletionHandler:(void (^)(NCUpdateResult))completionHandler {
NSDateFormatter *formatter = [[NSDateFormatter alloc] init];
formatter.dateFormat = @"yyyy-MM-dd hh-mm-ss";
NSString *dateStr = [formatter stringFromDate:[NSDate date]];
[self.button setTintColor:[UIColor grayColor]];
[self.button setTitle:dateStr forState:UIControlStateNormal];
completionHandler(NCUpdateResultNewData);
}

另外,在widget中也可以做一些网络请求,用法和主程序中的一致。不过需要注意多target下资源文件添加问题,widget中用到的类需要添加到widget那个target中。

-(void)viewWillAppear:(BOOL)animated{
NSDateFormatter *formatter = [[NSDateFormatter alloc] init];
formatter.dateFormat = @"yyyy-MM-dd hh-mm-ss";
NSString *dateStr = [formatter stringFromDate:[NSDate date]];
[self.button setTintColor:[UIColor grayColor]];
[self.button setTitle:dateStr forState:UIControlStateNormal];
//网络请求图片
dispatch_async(dispatch_get_global_queue(0, 0), ^{
NSData *imageDate = [NSData dataWithContentsOfURL:[NSURL URLWithString:@"http://a1.jikexueyuan.com/home/201508/03/3697/55bee50b58c8b.jpg"]];
dispatch_async(dispatch_get_main_queue(), ^{
UIImage *image = [UIImage imageWithData:imageDate];
self.imageView.image = image;
});
});
}

2.4 设置widget的edgeInsets

-(UIEdgeInsets)widgetMarginInsetsForProposedMarginInsets:(UIEdgeInsets)defaultMarginInsets{
return UIEdgeInsetsMake(0, 0, 0, 0);
}

这个代理方法在iOS 10以后已经失效,可以设置iOS 10之前的widget的edgeInsets

2.5 通过widget跳转到主应用

通过URL Schemes的方式,需要在主应用中添加白名单,widget通过这个约定的地址进行跳转。

 

 

程序间跳转

- (IBAction)actionClick:(id)sender {
[self.extensionContext openURL:[NSURL URLWithString:@"haha://1"] completionHandler:nil];
}

2.6 数据共享

widget与主程序之间可以进行数据共享,主要通过NSFileManager和NSUserDefaults两种形式。

创建App Group

主程序target->capabilities->App Groups
打开开关,新建一个App Groups并选中。

 

 

同时在widget的target中按照相同的步骤,选中相同的App Group。这个步骤完成之后两个程序就能实现数据之间的共享了。

NSUserDefaults实现共享
NSDateFormatter *formatter = [[NSDateFormatter alloc] init];
formatter.dateFormat = @"yyyy-MM-dd hh-mm-ss";
NSString *dateStr = [formatter stringFromDate:[NSDate date]];
[self.button setTintColor:[UIColor grayColor]];
[self.button setTitle:dateStr forState:UIControlStateNormal];
NSUserDefaults *userDefaults = [[NSUserDefaults alloc] initWithSuiteName:@"group.demo.widget.name"];
[userDefaults setObject:dateStr forKey:@"nowDate"];

通过SuiteName(上一步创建的那个App Group名称)获取userDefaults对象,数据存取和单例对象用法一样。

NSFileManager 实现共享
-(BOOL)saveDataByNSFileManager:(NSData *)data
{
NSURL *containerURL = [[NSFileManager defaultManager] containerURLForSecurityApplicationGroupIdentifier:@"group.demo.widget.name"];
containerURL = [containerURL URLByAppendingPathComponent:@"widget"];
BOOL result = [data writeToURL:containerURL atomically:YES];
return result;
}
-(NSData *)readDataByNSFileManager
{
NSURL *containerURL = [[NSFileManager defaultManager] containerURLForSecurityApplicationGroupIdentifier:@"group.demo.widget.name"];
containerURL = [containerURL URLByAppendingPathComponent:@"widget"];
NSData *value = [NSData dataWithContentsOfURL:containerURL];
return value;
}

通过App Groups名获取数据的存储路径,主程序和widget都能对这个路径中的文件做存取操作,从而实现数据共享。

注意事项

如果带widget需要上架,需要为widget申请一个app ID,并且生成相应的配置文件。
最后,附上代码

人已赞赏
个人中心
购物车
优惠劵
今日签到
有新私信 私信列表
有新消息 消息中心
搜索