iOS：应用程序扩展开发之Today扩展（Today Extesnsion）

看山还是山 發表於 2019-11-20 16:45:00

iOS：应用程序扩展开发之Today扩展（Today Extesnsion）

一、简介
iOS应用程序扩展是苹果在iOS8推出的一个新特性，可以将自定义的功能和内容扩展到应用程序之外，在之后又经过不断地优化和更新，已经成为开发中不可或缺的功能之一。扩展也是一个Target项目，它运行在主机应用程序上，可以与主机应用程序实现资源共享，和宿主应用程序的Target项目是彼此独立的。系统提供的扩展有很多，Toady扩展就是其中之一，也被成为应用程序插件，它的作用是将今日发生的简单消息展示在系统的插件界面上。Toady扩展模板名称为Today Extension。图1是创建Today扩展，图2是扩展显示在插件界面上(可以通过点击Edit来添加或者移除扩展)。  
<img src="https://img2018.cnblogs.com/blog/791499/201911/791499-20191120132900974-1370460397.png">
 
二、创建
按照上图1的方式创建一个Today Extension的Target后，系统会默认帮我们生成一个TodayViewController控制器类、MainInterface.storyBoard故事板、plist序列化文件，文件结构图如下：
<img src="https://img2018.cnblogs.com/blog/791499/201911/791499-20191120133948393-464574678.png">
上图中红色圈内和箭头指向的配置就是系统通过MainInterface.storyBoard帮我们实现了一个基本的Toady插件UI布局，运行后可以直接显示在插件界面上。可是，有的时候开发者并不想使用系统的故事板来构建UI，系统支持自定义的，我们只需要修改plist配置即可。具体的配置是这样的：
 将NSExtensionMainStoryboard字段删除;
 添加NSExtensionPrincipalClass字段，修改value为控制器的类名。 
 在TodayViewController中的ViewDidLoad中设置preferredContentSize属性大小，用来调整widget界面UI的尺寸。
配置如下图所示:
<img src="https://img2018.cnblogs.com/blog/791499/201911/791499-20191120135032509-1363294602.png">
<div class="cnblogs_code">
<pre>//设置尺寸
self.preferredContentSize = CGSizeMake(.bounds.size.width, 300); </pre>
</div>
  
三、分析
TodayViewController类比较简单，就是一个VC类，它实现了系统提供的一个扩展协议<NCWidgetProviding>，可以在协议方法中实现对扩展的更新和状态监控。
协议如下，都是可选的，开发者根据需要进行重写。
<div class="cnblogs_code">
<pre>//协议
@protocol NCWidgetProviding <NSObject>

@optional

//当数据更新时调用的方法，系统会定期更新扩展
- (void)widgetPerformUpdateWithCompletionHandler:(void (^)(NCUpdateResult result))completionHandler;

//监听显示模式(宽松型、紧奏型)和尺寸的改变，其中宽松和紧凑表示的是展开和折叠状态, iOS10开始才能使用
- (void)widgetActiveDisplayModeDidChange:(NCWidgetDisplayMode)activeDisplayMode withMaximumSize:(CGSize)maxSize __API_AVAILABLE(ios(10.0));

//设置扩展UI边距，注意：使用StoryBoard时，若要所见即所得，则这个方法中需要返回UIEdgeInsetsZero; (iOS10 and later 不会再被调用，弃用了)
- (UIEdgeInsets)widgetMarginInsetsForProposedMarginInsets:(UIEdgeInsets)defaultMarginInsets __API_DEPRECATED("This method will not be called on widgets linked against iOS versions 10.0 and later.", ios(8.0, 10.0));

@end</pre>
</div>
<div class="cnblogs_code">
<pre>//扩展，都是iOS10开始才能使用
@interface NSExtensionContext (NCWidgetAdditions)

//设置widget折叠或展开状态
@property (nonatomic, assign) NCWidgetDisplayMode widgetLargestAvailableDisplayMode __API_AVAILABLE(ios(10.0));

//只读，widget状态
@property (nonatomic, assign, readonly) NCWidgetDisplayMode widgetActiveDisplayMode __API_AVAILABLE(ios(10.0));

//获取widget不同状态的尺寸
- (CGSize)widgetMaximumSizeForDisplayMode:(NCWidgetDisplayMode)displayMode __API_AVAILABLE(ios(10.0));

@end</pre>
</div>
 
四、交互
Today扩展是寄宿于主机应用程序上的， TodayViewController又是一个UIViewController类，系统支持Today扩展对UIViewController进行切换。也就是说，苹果在考虑提供给开发者在对UIViewController中添加各种展示控件这种便利的同时，也相应的提供给开发者通过Today扩展的widget从主机应用程序激活并打开宿主应用程序的机会。不过这个操作必须通过设置并调起scheme来实现。步骤如下：
 配置宿主应用程序的scheme;
 使用扩展的openURL打开宿主应用程序。
交互如下：
<img src="https://img2018.cnblogs.com/blog/791499/201911/791499-20191120141657975-1136906215.png">
<div class="cnblogs_code">
<pre>//扩展通过scheme打开主宿主应用程序
completionHandler:nil];</pre>
</div>
 
五、数据
既然Today扩展能与宿主应用程序进行交互，那么肯定就存在数据通信的问题了。扩展与宿主目录应用程序位于不同的目录结构中，默认情况下，扩展与宿主应用程序的数据并不共享，代码也不能复用。例如在宿主目录应用程序中可能有网络请求、数据持久化存储等结构框架，在扩展中不可以直接使用，扩展需要提供自己的网络请求框架、数据持久化框架等。这些问题苹果都提供了解决方法，可以通过创建静态库的方式实现代码共享，通过APP Group和Scheme跳转实现数据共享。这里主要讲一下数据共享。注意：扩展和宿主应用程序的素材文件也是互相独立的，必须将扩展中的素材添加到扩展Target。
方式一：通过配置scheme跳转来实现数据共享。可以将传递的数据配置到URL中，然后宿主应用程序通过AppDeleagte的代理方法application:openURL:options:获取数据，不过这个数据传递只能是单方向的。
<div class="cnblogs_code">
<pre> //打开主应用程序
-(void)openMainApp {

//共享数据
NSString *schemeFormat = @"MainApp://action=openCarema?name=xiayuanquan";
completionHandler:nil];
}</pre>
</div>
<div class="cnblogs_code">
<pre>-(BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {

//从URL获取共享数据，截取数据
NSLog(@"---------url = %@---------",url);

return YES;
}</pre>
</div>
方式二：给扩展的Target和宿主应用程序的Target项目都开启APP Group，两者配置相同的appgroupIndentifier标识，分别生成后缀名为.entitlements文件。然后对于小数据推荐使用偏好进行双向传递共享数据，如图所示。
<img src="https://img2018.cnblogs.com/blog/791499/201911/791499-20191120144405471-853677770.png">
<div class="cnblogs_code">
<pre>//共享数据
//使用偏好设置
NSUserDefaults *defalut = [ initWithSuiteName:@"group.xiayuanquan"];
;</pre>
</div>
<div class="cnblogs_code">
<pre>//从偏好设置获取共享数据
NSUserDefaults *defalut = [ initWithSuiteName:@"group.xiayuanquan"];
NSString *name1 = ;
NSLog(@"1------------name1=%@",name1);</pre>
</div>
方式三：配置跟方式二一样，不过双向传递共享数据使用文件目录来实现。
<div class="cnblogs_code">
<pre>//共享数据
//方式二：使用共享目录
NSFileManager *fileManager = ;
NSURL *baseURL = ;
NSURL *filePath = ;
NSData *data = ;
;</pre>
</div>
<div class="cnblogs_code">
<pre>//从共享目录获取共享数据
NSFileManager *fileManager = ;
NSURL *baseURL = ;
NSURL *filePath = ;
NSData *data = ;
NSLog(@"2------------data=%@",data);</pre>
</div>
 
六、适配
从iOS10开始，苹果提供了NCWidgetDisplayMode展示模式，通过设置该模式来支持对widget进行折叠和展开。在这里，preferredContentSize就用到了。这个是用来设置widget的尺寸的。苹果对widget的尺寸有自己的标准，width为maxSize.width，height取值范围。这个maxSize可以在扩展协议<NCWidgetProviding>的协议方法也即widgetActiveDisplayModeDidChange:withMaximumSize中获取:，可以发现每一种机型maxSize不一样。
<div class="cnblogs_code">
<pre>// 6s模拟器下：
// NCWidgetDisplayModeCompact模式下:{359.000000, 110.000000}
// NCWidgetDisplayModeExpanded模式下:{359.000000, 528.000000}

// 8 plus模拟器下:
// NCWidgetDisplayModeCompact模式下:{304.000000, 110.000000}
// NCWidgetDisplayModeExpanded模式下:{304.000000, 616.000000}</pre>
</div>
折叠状态：widget的高为110，此时设置preferredContentSize无效; 
展开状态：widget的高为开发者设置的preferredContentSize.height，但是如果preferredContentSize.height>maxSize.height，此时取值为maxSize.height。 
适配iOS10，默认支持展开，设置如下： 
<div class="cnblogs_code">
<pre>//设置widget默认为可以展开，此时处于折叠状态
#ifdef __IPHONE_10_0 //适配iOS10
self.extensionContext.widgetLargestAvailableDisplayMode = NCWidgetDisplayModeExpanded;
#endif</pre>
</div>
 
七、范例
【去掉MainInterface.storyBoard，采用纯代码实现】
1、宿主应用程序AppDelegate
<div class="cnblogs_code">
<pre>- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Override point for customization after application launch.

//存储共享数据
//方式二：使用偏好设置
NSUserDefaults *defalut = [ initWithSuiteName:@"group.xiayuanquan"];
;

//存储共享数据
//方式三：使用共享目录
NSFileManager *fileManager = ;
NSURL *baseURL = ;
NSURL *filePath = ;
NSData *data = ;
;

return YES;
}

-(BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {

//方式一：从URL获取共享数据，例如参数
NSLog(@"---------url = %@---------",url);

return YES;

}</pre>
</div>
2、Widget扩展TodayViewController
<div class="cnblogs_code">
<pre>//
//TodayViewController.m
//TodayExtension
//Created by 夏远全 on 2019/11/19.
//

#import "TodayViewController.h"
#import <NotificationCenter/NotificationCenter.h>

@interface TodayViewController () <NCWidgetProviding>

@end

@implementation TodayViewController

- (void)viewDidLoad {
;
;
;
;
}

//配置
-(void)config {

self.view.backgroundColor = ; //widget背景色为灰色
self.preferredContentSize = CGSizeMake(.bounds.size.width, 300); //widget尺寸大小, 宽度实际取maxSize，width，高度

//设置widget默认为可以展开，此时处于折叠状态
#ifdef __IPHONE_10_0 //适配iOS10
 self.extensionContext.widgetLargestAvailableDisplayMode = NCWidgetDisplayModeExpanded;
#endif

}

//创建UI
-(void)createUI {

CGFloat width = self.view.frame.size.width;
CGFloat btnWidth = 100;
UIButton *button = [ initWithFrame:CGRectMake((width-btnWidth)/2, 0, btnWidth, 40)];
button.backgroundColor = ;
;
forState:UIControlStateNormal];
;
;
}

//打开主应用程序
-(void)openMainApp {

//传递共享数据
//方式一：参数传递
NSString *schemeFormat = @"MainApp://action=openCarema?name=xiayuanquan";
completionHandler:nil];

}

//获取共享数据
-(void)fecthData {

//方式二：从偏好设置获取共享数据
NSUserDefaults *defalut = [ initWithSuiteName:@"group.xiayuanquan"];
NSString *name1 = ;
NSLog(@"1------------name1=%@",name1);

//方式三：从共享目录获取共享数据
NSFileManager *fileManager = ;
NSURL *baseURL = ;
NSURL *filePath = ;
NSData *data = ;
NSLog(@"2------------data=%@",data);
}

//当数据更新时调用的方法，系统会定期更新扩展
- (void)widgetPerformUpdateWithCompletionHandler:(void (^)(NCUpdateResult))completionHandler {

//获取共享的数据，根据判断回调对应的block
//NCUpdateResultNewData,
//NCUpdateResultNoData,
//NCUpdateResultFailed

completionHandler(NCUpdateResultNoData);
}

//监听显示模式(宽松型、紧奏型)和尺寸的改变
//NCWidgetDisplayModeCompact :折叠
//NCWidgetDisplayModeExpanded : 展开
- (void)widgetActiveDisplayModeDidChange:(NCWidgetDisplayMode)activeDisplayMode withMaximumSize:(CGSize)maxSize {

//maxSize：
//虽说是最大的Size，但苹果还是把Widget的高度范围限制在了之间
//如果设置高度小于110，那么default = 110;
//如果设置高度大于开发者设置的preferredContentSize.Heiget，那么default = maxSize;
//折叠状态下，苹果将高度固定为110，这个时候设置preferredContentSize属性无效。
NSLog(@"width = %lf-------height = %lf",maxSize.width,maxSize.height);

//可以更改状态
if (activeDisplayMode == NCWidgetDisplayModeExpanded) {
 self.preferredContentSize = CGSizeMake(.bounds.size.width, 300);
}
else{
 self.preferredContentSize = CGSizeMake(.bounds.size.width, 100);
}
}

//设置扩展UI边距，注意：使用StoryBoard时，若要所见即所得，则这个方法中需要返回UIEdgeInsetsZero; (iOS10 and later 不会再被调用)
//- (UIEdgeInsets)widgetMarginInsetsForProposedMarginInsets:(UIEdgeInsets)defaultMarginInsets {
// return UIEdgeInsetsZero;
//}

@end</pre>
</div>
3、打印和gif
<div class="cnblogs_code">
<pre>2019-11-20 16:22:31.074596+0800 TodayExtension[29668:1132736] 1------------name1=xiayuanquan
2019-11-20 16:22:31.234435+0800 TodayExtension[29668:1132736] 2------------data={length = 149, bytes = 0x62706c69 73743030 d4010203 04050607 ... 00000000 00000068 }
2019-11-20 16:22:31.234970+0800 TodayExtension[29668:1132736] maxSize.width = 359.000000-------maxSize.height = 110.000000 //折叠
2019-11-20 16:22:38.117764+0800 TodayExtension[29668:1132736] maxSize.width = 359.000000-------maxSize.height = 528.000000 //展开</pre>
</div>
<img src="https://img2018.cnblogs.com/blog/791499/201911/791499-20191120163418652-475497750.gif">
 
 
 
 
 

</div>
<div id="MySignature" role="contentinfo">
程序猿神奇的手，每时每刻，这双手都在改变着世界的交互方式！ 
来源：https://www.cnblogs.com/XYQ-208910/p/11897343.html

頁: [1]

琼殿技术论坛's Archiver

iOS：应用程序扩展开发之Today扩展（Today Extesnsion）