ios 跨软件传输数据之Share Extension的配置与外
配置Share Extension
设置允许发送的数据类型:text、url、image、mp3、mp4、pdf、word、excel、ppt
4193251-10ad4991c8cd0188.png
处理Share Extension中的数据。
Share Extension中默认都会有一个数据展现的UI界面。该界面继承SLComposeServiceViewController这个类型,如:(这是系统帮我们生成的)
#import <UIKit/UIKit.h>
#import <Social/Social.h>
@interface ShareViewController : SLComposeServiceViewController
@end
当然我们也可以自定义新的控制器,并在Share Extension的plist里做下对应的匹配
1556184296430.jpg
处理Share Extension中的数据
分享界面顶部包括了标题、取消(Cancel)按钮和提交(Post)按钮。然后下面跟着左边就是一个文本编辑框,右边就是一个图片显示控件。那么,每当用户点击取消按钮或者提交按钮时,都会分别触发下面的方法:
/**
* 点击取消按钮
*/
- (void)didSelectCancel
{
[super didSelectCancel];
}
/**
* 点击提交按钮
*/
- (void)didSelectPost
{
[self.extensionContext completeRequestReturningItems:@[] completionHandler:nil];
}
在这两个方法里面可以进行一些自定义的操作。一般情况下,当用户点击提交按钮的时候,扩展要做的事情就是要把数据取出来,并且放入一个与Containing App(** 容器程序,尽管苹果开放了Extension,但是在iOS中extension并不能单独存在,要想提交到AppStore,必须将Extension包含在一个App中提交,并且App的实现部分不能为空,这个包含Extension的App就叫Containing app。Extension会随着Containing App的安装而安装,同时随着ContainingApp的卸载而卸载。)共享的数据介质中(包括NSUserDefault、Sqlite、CoreData),要跟容器程序进行数据交互需要借助AppGroups服务,下面先来看看怎么获取扩展中的数据。
在ShareExtension中,UIViewController包含一个ExtensionContext这样的上下文对象,NSExtensionContext的结构比较简单,包含一个属性和三个方法。其说明如下:
1556185400640.jpg
类的下面还定义了一些通知,这些通知都是跟宿主程序的行为相关,在设计扩展的时候可以根据这些通知来进行对应的操作。其说明如下:
图片.png
从inputItems中获取数据
inputItems是包含NSExtensionItem类型对象的数组。
NSExtensionItem包含四个属性:
企业微信截图_d43aa636-5fac-444b-a5df-1e09ac64f9d0.png
对应userInfo结构中的NSExtensionItem属性的键名如下:
企业微信截图_0bdebaeb-9603-4223-8e2f-ed410030a770.png
为了要取到宿主程序提供的数组,那么只要关注loadItemTypeIdentifier:options:completionHandler方法的使用即可。有了上面的了解,那么接下来就是对inputItems进行数据分析并提取了,这里以一个链接的分享为例,改写视图控制器中的didSelectPost方法。看下面的代码:
- (void)didSelectPost
{
__block BOOL hasExistsUrl = NO;
[self.extensionContext.inputItems enumerateObjectsUsingBlock:^(NSExtensionItem * _Nonnull extItem, NSUInteger idx, BOOL * _Nonnull stop) {
[item.attachments enumerateObjectsUsingBlock:^(NSItemProvider * _Nonnull itemProvider, NSUInteger idx, BOOL * _Nonnull stop) {
if ([itemProvider hasItemConformingToTypeIdentifier:@"public.url"])
{
[itemProvider loadItemForTypeIdentifier:@"public.url"
options:nil
completionHandler:^(id<NSSecureCoding> _Nullable item, NSError * _Null_unspecified error) {
if ([(NSObject *)item isKindOfClass:[NSURL class]])
{
NSLog(@"分享的URL = %@", item);
}
}];
hasExistsUrl = YES;
*stop = YES;
}
}];
if (hasExistsUrl)
{
*stop = YES;
}
}];
// This is called after the user selects Post. Do the upload of contentText and/or NSExtensionContext attachments.
// Inform the host that we're done, so it un-blocks its UI. Note: Alternatively you could call super's -didSelectPost, which will similarly complete the extension context.
// [self.extensionContext completeRequestReturningItems:@[] completionHandler:nil];
}
上面的例子中遍历了extensionContext的inputItems数组中所有NSExtensionItem对象,然后从这些对象中遍历attachments数组中的所有NSItemProvider对象。匹配第一个包含public.url标识的附件(具体要匹配什么资源,数量是多少皆有自己的业务所决定)。
- 注意:在上面代码中注释了[self.extensionContext completeRequestReturningItems:@[] completionHandler:nil];这行代码,主要是使到视图控制器不被关闭,等到实现相应的处理后再进行调用该方法,对分享视图进行关闭。
ios 跨软件传输数据之系统Share Extension创建与分享(一)
ios 跨软件传输数据之Share Extension的配置与外部数据获取(二)
ios 跨软件传输数据之Share Extension将分享数据传递给容器程序(三)
ios 跨软件传输数据之Share Extension容器程序数据处理与上线(四)