iOS扩展Extension之Today

旧街凉风 提交于 2021-01-13 22:14:11

1、简介

  扩展(Extension)是iOS 8中引入的一个新特性。扩展让app之间的数据交互成为可能。在iOS 8系统之前,每一个app在物理上都是彼此独立的,app之间不能互访彼此的私有数据。而在引入扩展之后,其他app可以与扩展进行数据交换。iOS 8系统有6个支持扩展的系统区域,分别是Today、Share、Action、Photo Editing、Storage Provider、Custom keyboard。支持扩展的系统区域也被称为扩展点。本文只简单记录Today的使用!

 

2、Today扩展的创建

  方法一:通过路径File -->New -->Target创建!

  方法二:直接点击项目-->点击 + 即可!

 

2、Today简介和方法说明

  Today扩展的一种,虽然依附在App中,但是它是单独的个体,所使用的文件、资源、第三方等,都需要单独设置!

  Today创建之后,其实就是一个ViewController!最小高度为110pt。有三方协议方法:

// iOS10 新增的方法
// 用来设置Widget是展开还是折叠状态的方法,可以设置相关的preferredContentSizes属性修改大小
- (void)widgetActiveDisplayModeDidChange:(NCWidgetDisplayMode)activeDisplayMode withMaximumSize:(CGSize)maxSize{
    if (activeDisplayMode == NCWidgetDisplayModeCompact) {
        NSLog(@"叠起状态下的默认size:%@", NSStringFromCGSize(maxSize));
    } else {
        NSLog(@"展开状态下的默认size:%@", NSStringFromCGSize(maxSize));
    }    
}

// 该方法是用来告知Widget控制器是否需要更新的一个协议方法 
- (void)widgetPerformUpdateWithCompletionHandler:(void (^)(NCUpdateResult))completionHandler {
    // Perform any setup necessary in order to update the view.
    
    // If an error is encountered, use NCUpdateResultFailed
    // If there's no update required, use NCUpdateResultNoData
    // If there's an update, use NCUpdateResultNewData

    completionHandler(NCUpdateResultNewData);
//    typedef NS_ENUM(NSUInteger, NCUpdateResult) {
//        NCUpdateResultNewData,
//        NCUpdateResultNoData,
//        NCUpdateResultFailed
//    } NS_ENUM_AVAILABLE_IOS(8_0);
}

// iOS10 版本之后将不会再被唤起
// 用来设置Widget控制器边框间距的方法,如果出现偏差,可以调整此方法的返回值进行操作
- (UIEdgeInsets)widgetMarginInsetsForProposedMarginInsets:(UIEdgeInsets)defaultMarginInsets NS_DEPRECATED_IOS(8_0, 10_0, "This method will not be called on widgets linked against iOS versions 10.0 and later.");

  2.1 通过Storyboard加载和编码加载两种选择:

    通过修改plist文件storyboard

    编码加载设置:

 

  2.2 Today的展开和折叠:

    第一步:设置 widgetLargestAvailableDisplayMode属性;

self.extensionContext.widgetLargestAvailableDisplayMode = NCWidgetDisplayModeExpanded;

    第二步:实现协议方法;

// iOS10 新增的方法
// 用来设置Widget是展开还是折叠状态的方法,可以设置相关的preferredContentSizes属性修改大小
- (void)widgetActiveDisplayModeDidChange:(NCWidgetDisplayMode)activeDisplayMode withMaximumSize:(CGSize)maxSize{
    if (activeDisplayMode == NCWidgetDisplayModeCompact) {
        NSLog(@"叠起状态下的默认size:%@", NSStringFromCGSize(maxSize));
    } else {
        NSLog(@"展开状态下的默认size:%@", NSStringFromCGSize(maxSize));
    }    
}

  

3、共享数据

  通过扩展点进行数据的共享,真机测试需要在开发者网站注册一个App Groups。模拟器亲测可以免费使用(App Groups的测试group.com.xxx.TextToday),后面是Bundle Identifier。

  3.1 开发者网站注册一个App Groups

  3.2 证书使用自动签名部署,设置项目和Today的target中添加APPGroups选项

  3.3 项目中储存数据,在Today中获取数据

    通过[[NSUserDefaults alloc] initWithSuiteName:@"groupName"]这个格式去创建NSUserDefaults对象,groupName填写当前设置AppGroups勾选的名字。

- (void)savaDataWithArray:(NSArray *)dataArray {
    NSData  *data = [NSKeyedArchiver archivedDataWithRootObject:dataArray];
    NSUserDefaults *defaults = [[NSUserDefaults alloc] initWithSuiteName:@"group.com.ForeverGuard.TextToday"];
    [defaults setObject:data forKey:@"todayModel"];
    [defaults synchronize];
}

    获取数据:注意数据存储需要符合格则NSCoding协议、可储存的类型、自定义转Data存储等。

- (void)readData {
    NSUserDefaults *defaults = [[NSUserDefaults alloc] initWithSuiteName:@"group.com.ForeverGuard.TextToday"];
    NSData *dataArray = [defaults objectForKey:@"todayModel"];
    self.dataArr = [NSKeyedUnarchiver unarchiveObjectWithData:dataArray];    
}

  通过在Today界面加载一个TableView,效果如图:

  注意Today和项目共同使用的Model和资源需要设置Target选项:

 

4、点击Today跳转到APP

  4.1 设置APP的URL Schemes

  4.2 在Today中的跳转代码:

- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath{
    [tableView deselectRowAtIndexPath:indexPath animated:YES];
    [self.extensionContext openURL:[NSURL URLWithString:[NSString stringWithFormat:@"TextToday://todayModel=%@",@"123"]] completionHandler:nil];
}

  效果图:

 

 

 

  

易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!