iOS8-Today Extension

extension point

系统中支持extension的区域，extension的类别也是据此区分的，iOS上共有Today、Share、Action、Photo Editing、Storage Provider、Custom keyboard几种，其中Today中的extension又被称为widget。每种extension point的使用方式和适合干的活都不一样，因此不存在通用的extension。

 

app extension

即为本文所说的extension。extension并不是一个独立的app，它有一个包含在app bundle中的独立bundle，extension的bundle后缀名是.appex。其生命周期也和普通app不同。extension不能单独存在，必须有一个包含它的containing app。另外，extension需要用户手动激活，不同的extension激活方式也不同，比如： 比如Today中的widget需要在Today中激活和关闭；Custom keyboard需要在设置中进行相关设置；Photo Editing需要在使用照片时在照片管理器中激活或关闭；Storage Provider可以在选择文件时出现；Share和Action可以在任何应用里被激活，但前提是开发者需要设置Activation Rules，以确定extension需要在合适出现。

 

containing app

尽管苹果开放了extension，但是在iOS中extension并不能单独存在，要想提交到AppStore，必须将extension包含在一个app中提交，并且app的实现部分不能为空,这个包含extension的app就叫containing app。extension会随着containing app的安装而安装，同时随着containing app的卸载而卸载。

 

host app

能够调起extension的app被称为host app，比如widget的host app就是Today。

1 extension和host app之间可以通过extensionContext属性直接通信，该属性是新增加的UIViewController类别。

实际上extension和host app之间是通过IPC（interprocess communication）实现的，只是苹果把调用接口高度抽象了，我们并不需要关注那么底层的东西。

 

2 containing app和host app

他们之间没有任何直接关系，也从来不需要通信。

 

3 extension和containing app

这二者之间的关系最复杂，纠纠缠缠扯不清关系。

 

首先，尽管extension的bundle是放在containing app的bundle中，但是他们是两个完全独立的进程，之间不能直接通信。不过extension可以通过openURL的方式启动containing app（当然也能启动其它app），不过必须通过extensionContext借助host app来实现。

 

可以共享Shared resources

 extension和containing app可以共同读写一个被称为Shared resources的存储区域，这是通过App Groups实现。

使用说明：

1 Extension info.plist中字段NSExtension

1)   NSExtensionActivationRule定义了当前的扩展支持的数据类型及数据项个数，例如当前的设置只支持图片格式和视频格式的数据，并且最多不超过10张图片和1个视频。

2)   NSExtensionJavaScriptPreprocessingFile用于配置与脚本交互的JS脚本文件的名字。

3)   NSExtensionMainStoryboard配置扩展的Storyboard文件名。

4)   NSExtensionPointIdentifier用于表示扩展点，每一个扩展点拥有一个唯一的名字。

5)   NSExtensionPrincipalClass配置当扩展启动时，扩展点首先要实例化的类

如果不使用自动生成的storyBoard，纯代码实现的话就在plist文件删除第二个字段，添加第五个值为你的VC名字。

 

2 Extension VC的属性NSExtensionContext

1.通过URL Schemes打开contain app

- (void)openURL:(NSURL *)URL completionHandler:(void (^)(BOOL success))completionHandler;

2. 对于其他的耗时任务似乎并没有更好的方式，由于返回  host app  后其生命周期会马上结束，因此，对于其它类型的耗时任务，只能在任务完成后，再调用

- (void)completeRequestReturningItems:(NSArray *)items completionHandler:(void(^)(BOOL expired))completionHandler;

3 与host app的协议NCWidgetProviding更新视图

- (void)widgetPerformUpdateWithCompletionHandler:(void (^)(NCUpdateResult result))completionHandler;

每次显示这个页面都会调用这个函数去更新界面

- (UIEdgeInsets)widgetMarginInsetsForProposedMarginInsets:(UIEdgeInsets)defaultMarginInsets;

布局的边界

4 NCWidgetController控制显示与隐藏

[[NCWidgetController widgetController] setHasContent:YES forWidgetWithBundleIdentifier:@"com.qunar.iphoneclientdev.cyjToday"];

 

5 Host App在调用Extension的时候会首先

- (void)beginRequestWithExtensionContext:(NSExtensionContext *)context

如果实现了的话，会先执行里面的函数再viewDidLoad

Demo

https://github.com/caiyangjieto/TodayExtension