韦德国际bv1946_www.bv1946com_韦德国际1946手机版
做最好的网站

iOS应用之间的通信就只能通过间接的方式

日期:2020-04-15编辑作者:韦德国际bv1946计算机

出于安全考虑,iOS系统的沙盒机制规定每个应用都只能访问当前沙盒目录下面的文件(也有例外,比如系统通讯录能在用户授权的情况下被第三方应用访问),这个规则把iOS系统的封闭性展现的淋漓尽致。详细可以参考我的iOS多线程技术的文章。

图片 1image.png

由于沙盒机制的存在,iOS应用之间的通信就只能通过间接的方式。正如苹果官方文档 ## Inter-App Communication所说。

Apps communicate only indirectly with other apps on a device. You can use AirDrop to share files and data with other apps. You can also define a custom URL scheme so that apps can send information to your app using URLs.

  1. airDrop, 该方式经常是苹果设备之间传递文件使用,当然你也可以通过该方式分享safari里面的网页给另外一台设备的safari。
  2. 通过服务器来实现,跨应用和跨设备之间的通信。比如:QQ通信录助手,QQ, 微信,新浪微博等等等。
  3. 系统级别的应用,比如:通信录,相册,健康等由系统统一管理的数据的应用,第三方应用可以通过在info.plist里面注册说明用途,调用系统API来调用获取对应的数据,关于隐私数据苹果审核越来越严格,也就要求info.plist里面说明数据用途尽可能详细具体,才更容易通过AppStore的审核。
  4. 通过自定义URL Scheme的形式,经常用于一个应用调用另外一个应用,比如:社交化方面的第三方登录,分享(QQ, 微信,微博等)。包括常用的第三方社交化框架ShareSDK、友盟也主要是基于此技术实现调用第三方APP进行登录或者分享等授权功能。当然开发者也可以自定义的形式来实现该部分功能,可以参考笔者文章:iOS进阶篇-应用之间的跳转
  5. 通过UIDocumentInteractionController或者是UIActivityViewController这俩个iOS SDK中封装好的类在App之间发送数据、分享数据和操作数据。该部分常用于跨应用打开文件:比如通过QQ传递过来的PDF文件,用PDF阅读器打来。
  6. 最后一种是App Extension,该部分功能是iOS8的SDK中提供拓展新特性能。可以实现跨APP应用之间的操作和分享。

本篇文章将围绕方式5和方式6展开介绍这方面的技术,也就是苹果原生提供的基于iOS SDK的分享技术。同时推荐俩篇苹果开发者中心的文档:Inter-App Communication和Document Interaction Programming Topics for iOS

1.1.1 About Document Interaction

点击以上链接可以打开官方文档,文档说明了应用可以通过制定的步骤向系统注册自身可以支持的文件类型,以便于能够用于打开其它应用里面的文件。

1.1.2 Uniform Type Identifier

简称UTI,用于类型标识。也可以参见如下链接:详解苹果提供的UTI。概括来说:第一、UTI的体系树,如下图官方文档所示

图片 2uniform_type_identifier_2x.png第二、对于自己应用UTI命名,一般采用反域名的形式,类似于包名,尽可能的保证唯一,比如QQ采用的就是com.tencent.mqq。图片 3WX20180313-154157.png

我们需要在info.plist文件中,添加一个新的属性CFBundleDocumentTypes(实际上输入的是"Document types"),这是一个数组类型的属性,意思就是我们可以同时注册多个类型。而针对数组中的每一个元素,都有许多属性可以指定,详细的属性列表我们可以从官方文档上找到: Core Foundation Keys ---- CFBundleDocumentTypes。这里列举我们在做iOS开发时常用的属性:CFBundleTypeName("Icon File Name")字符串类型,指定某种类型的别名,也就是用来指代我们规定的类型的别称,一般为了保持唯一性,我们使用UTI来标识。CFBundleTypeIconFiles数组类型,包含指定的png图标的文件名,指定代表某种类型的图标,而图标有具体的尺寸标识:

Device Sizes
iPad 64 x 64 pixels, 320 x 320 pixels
iPhone and iPod touch 22 x 29 pixels, 44 x 58 pixels (high resolution)

LSItemContentTypes("Document Content Type UTIs")数组类型,包含UTI字符串,指定我们的应用程序所有可以识别的类型集合LSHandlerRank("Handler rank")字符串类型,包含Owner,Default,Alternate,None四个可选值,指定对于某种类型的优先权级别,而Launcher Service会根据这个优先级别来排列显示的App的顺序。优先级别从高到低依次是Owner,Alternate,Default。None表示不接受这种类型。以下配置可作为参考:

图片 4WX20180313-160927.png图片 5WX20180313-161056.png经过以上配置之后,编译之后,可以在工程中看到如下界面,表示配置成功。图片 6WX20180313-161634.png

特别注意该部分配置依据苹果官方文档是通过系统的launch service来完成的,安装成功之后,需要重启手机,才能看到现象。

1.3.1 打开QQ应用的任何一张图片

笔者采用的是某个聊天窗口的图片,运行如图:

图片 7image.png图片 8image.png

1.3.2 处理openURL的代理

之后iOSShare的应用打开,如下为代码的运行结果,之后开发者可以在对应的openURL的代理中处理该图片,实例代码如下

#if __IPHONE_OS_VERSION_MAX_ALLOWED < __IPHONE_9_0- application:(UIApplication *)application openURL:url sourceApplication:(nullable NSString *)sourceApplication annotation:annotation{ NSLog(@"ios9以下调用了OpenURL的接口。。。。。。。。。。。返回的内容为============================="); NSLog(@"url = %@", url); NSLog(@"sourceApplication = %@", sourceApplication); NSLog(@"annotation = %@", annotation); return YES;}#else- application:(UIApplication *)application openURL:url options:(nonnull NSDictionary<NSString *,id> *)options{ NSLog(@"ios9以上调用了OpenURL的接口。。。。。。。。。。。返回的内容为============================="); NSLog(@"url = %@", url); NSLog(@"options = %@", options); //新建立一个页面用于预览该图片 return YES;}#endif

图片 9image.png

1.3.3 到沙盒中一探究竟

打开沙盒结合删除的log的输出结构们可以看出,实际上该部分内容已经完成了这张图片的拷贝,拷贝的地址为Documents目录下的Inbox里面。

图片 10WX20180313-153914@2x.png

扩展( Extension )是 iOS 8 中引入的一个非常重要的新特性。扩展让 app 之间的数据交互成为可能。用户可以在 app 中使用其他应用提供的功能,而无需离开当前的应用。在 iOS 8 系统之前,每一个 app 在物理上都是彼此独立的, app 之间不能互访彼此的私有数据。而在引入扩展之后,其他 app 可以与扩展进行数据交换。基于安全和性能的考虑,每一个扩展运行在一个单独的进程中,它拥有自己的 bundle , bundle 后缀名是.appex 。扩展 bundle 必须包含在一个普通应用的 bundle 的内部。iOS 8 系统有 6 个支持扩展的系统区域,分别是 Today 、 Share 、 Action 、 Photo Editing 、 Storage Provider 、 Custom keyboard 。支持扩展的系统区域也被称为扩展点。iOS 9中新增扩展网络扩展开发者可以通过改扩展来实现自定义的VPN客户端、透明的网络代理客户端以及实现动态的设备端网络内容过滤。Safari扩展该扩展可以让用户通过Safari的分享链接看到你的内容。又或者提供一个屏蔽列表,让你的用户使用你的App浏览Web内容时屏蔽指定的内容。Spotlight扩展该扩展可以对App内的数据进行索引,并且可以在不重启App的情况下重建数据索引。Audio Unit扩展该扩展允许App提供类似于GarageBand,Logic等App提供的乐器演奏,音频特效,声音合成功能。

一个支持扩展的系统区域叫做一个extension point。每个扩展点的扩展都有自己独有的使用方法和API。你可以根据你的需求来选择不同的扩展。官方API里面提出了一个名词叫:Host app,我们可以把它理解为宿主的App也就是提供应用扩展界面显示或者功能的App。还有一个container app,我们可以把它理解为容器App,就像下图的微信share extension,容器app就是微信。

图片 11image.png

扩展和app不同,扩展无法单独上架AppStore。尽管你必须使用个app来包含并且分发你的extension,extension也是一个单独的二进制文件,独立于用于传递和分发的container app。

你可以通过File--->New --->Target来创建Extension,它和其他的target一样,它和你的app project组合成为一个产品。一个app可以有一个扩展,也可以有多个扩展。最好的创建扩展的方式就是通过Xcode提供的Extension种类选择自己需要的来创建,里面包含了必要的API以及方法实现。如果你想让用户去使用你的扩展,那么就需要吧你的containing app发布到AppStore,当用户安装了你的Containing app,扩展也就安装了。不同的扩展启动的方式也不一样,例如Today Extension,你需要Widget来展示到你的通知中心。扩展也不要乱用,扩展的最佳用户体验从来都是希望用户操作更精简、更快速,并且专注于单个任务。

2.1.2 shareExtension的生命周期

先上图,估计你已经看到了好多次这张图,恭喜你这次又看到了,因为这个是苹果官方提供的图片。

图片 12image

1.用户选择要使用的App extension2.系统启动App Extension3.App Extension 代码运行4.运行完之后系统kill掉App Extension这就是App Extension的生命周期,举个例子:一个Share Extension,在图库里面你选择了一张图片,然后点击分享,选择你的Share Extension,此时系统会启动你的Share Extension。然后你将选择的图片分享到指定的程序(例如微信的发送给朋友)。接下来分享页面关闭,系统kill掉了Share Extension。

2.1.3 App Extension的通信方式

App Extension主要的通信是和他的host app(例如微信的Share Extension和微信),来自host app的请求和extension的response。下图你应该也很熟悉(app 扩展直接和host app沟通):

图片 13image

这个展示的就是正在运行的App Extension、host app和containing app之间的关系。可以看出:Containing App和app Extension并没有直接的沟通。甚至有的时候Containing app可以不运行,而App Extension直接运行。Containing app和Host app没有任何的沟通。

在一个典型的request/response中,系统打开代表host app的extension(微信分享的share extension),把host app提供的数据输送到extension的context,然后extension展示界面,提供一些功能任务(例如微信的分享到朋友)。

还有一种是app extension可以直接和他的containing app沟通:

图片 14image

例如Today Widget,可以直接告诉系统打开他的Containing app,只需要调用NSExtensionContext的openURL:CompletionHandler:方法即可。

2.1.4 在App Extension中不可以做的事情

一个app extension不能有以下情况:

1.访问sharedApplication对象。因此不能使用任何该对象的防范

2.使用任何标记NS_EXTENSION_UNAVAILABLE宏的API,或者类似的宏,或者不可用framework里面的API,例如HealthKit framework不能用于app extensions

3.iOS设备访问相机或者麦克风(iMessage app可以访问这些资源,只要在Info.plist里面进行配置使用描述即可)

4.运行一个长时间的后台任务

5.使用AirDrop接收数据

2.2 上手和实践

注:扩展不能单独创建,必须依赖于应用工程项目,因此如果你还没有创建一个应用工程,先去创建一个。

2.2.1 打开项目设置,在TARGETS侧栏地下点击“+”号来创建一个新的Target,如图:

图片 15image

2.2.2 然后选择”iOS” -> “Application Extension” -> “Share Extension”,点击“Next”。如图:

图片 16image

2.2.3 配置Share Extension
字段 描述
Bundle display name 扩展的显示名称,默认跟你的项目名称相同,可以通过修改此字段来控制扩展的显示名称。
NSExtension 扩展描述字段,用于描述扩展的属性、设置等。作为一个扩展项目必须要包含此字段。
NSExtensionAttributes 扩展属性集合字段。用于描述扩展的属性。
NSExtensionActivationRule 激活扩展的规则。默认为字符串“TRUEPREDICATE”,表示在分享菜单中一直显示该扩展。可以将类型改为Dictionary类型,然后添加以下字段:
NSExtensionMainStoryboard 设置主界面的Storyboard,如果不想使用storyboard,也可以使用NSExtensionPrincipalClass指定自定义UIViewController子类名
NSExtensionPointIdentifier 扩展标识,在分享扩展中为:com.apple.share-services
NSExtensionPrincipalClass 自定义UI的类名
NSExtensionActivationSupportsAttachmentsWithMaxCount 附件最多限制,为数值类型。附件包括File、Image和Movie三大类,单一、混选总量不超过指定数量
NSExtensionActivationSupportsAttachmentsWithMinCount 附件最少限制,为数值类型。当设置NSExtensionActivationSupportsAttachmentsWithMaxCount时生效,默认至少选择1个附件,分享菜单中才显示扩展插件图标。
NSExtensionActivationSupportsFileWithMaxCount 文件最多限制,为数值类型。文件泛指除Image/Movie之外的附件,例如附件、等。单一、混选均不超过指定数量。
NSExtensionActivationSupportsImageWithMaxCount 图片最多限制,为数值类型。单一、混选均不超过指定数量。
NSExtensionActivationSupportsMovieWithMaxCount 视频最多限制,为数值类型。单一、混选均不超过指定数量。
NSExtensionActivationSupportsText 是否支持文本类型,布尔类型,默认不支持。如的分享
NSExtensionActivationSupportsWebURLWithMaxCount Web链接最多限制,为数值类型。默认不支持分享超链接,需要自己设置一个数值。
NSExtensionActivationSupportsWebPageWithMaxCount Web页面最多限制,为数值类型。默认不支持Web页面分享,需要自己设置一个数值。

图片 17image.png

我们只需要关注以下几个字段的设置:

字段 描述
Bundle display name 扩展的显示名称,默认跟你的项目名称相同,可以通过修改此字段来控制扩展的显示名称。
NSExtension 扩展描述字段,用于描述扩展的属性、设置等。作为一个扩展项目必须要包含此字段。
NSExtensionAttributes 扩展属性集合字段。用于描述扩展的属性。
NSExtensionActivationRule 激活扩展的规则。默认为字符串“TRUEPREDICATE”,表示在分享菜单中一直显示该扩展。可以将类型改为Dictionary类型,然后添加以下字段:
NSExtensionMainStoryboard 设置主界面的Storyboard,如果不想使用storyboard,也可以使用NSExtensionPrincipalClass指定自定义UIViewController子类名
NSExtensionPointIdentifier 扩展标识,在分享扩展中为:com.apple.share-services
NSExtensionPrincipalClass 自定义UI的类名
NSExtensionActivationSupportsAttachmentsWithMaxCount 附件最多限制,为数值类型。附件包括File、Image和Movie三大类,单一、混选总量不超过指定数量
NSExtensionActivationSupportsAttachmentsWithMinCount 附件最少限制,为数值类型。当设置NSExtensionActivationSupportsAttachmentsWithMaxCount时生效,默认至少选择1个附件,分享菜单中才显示扩展插件图标。
NSExtensionActivationSupportsFileWithMaxCount 文件最多限制,为数值类型。文件泛指除Image/Movie之外的附件,例如附件、等。单一、混选均不超过指定数量。
NSExtensionActivationSupportsImageWithMaxCount 图片最多限制,为数值类型。单一、混选均不超过指定数量。
NSExtensionActivationSupportsMovieWithMaxCount 视频最多限制,为数值类型。单一、混选均不超过指定数量。
NSExtensionActivationSupportsText 是否支持文本类型,布尔类型,默认不支持。如的分享
NSExtensionActivationSupportsWebURLWithMaxCount Web链接最多限制,为数值类型。默认不支持分享超链接,需要自己设置一个数值。
NSExtensionActivationSupportsWebPageWithMaxCount Web页面最多限制,为数值类型。默认不支持Web页面分享,需要自己设置一个数值。

对于不同的应用里面有可能出现只允许接受某种类型的内容,那么Share Extension就不能一直出现在分享菜单中,因为不同的应用提供的分享内容不一样,这就需要通过设置NSExtensionActivationRule字段来决定Share Extension是否显示。例如,只想接受其他应用分享链接到自己的应用,那么可以通过下面的步骤来设置:将NSExtensionActivationRule字段类型由String改为Dictionary。展开NSExtensionActivationRule字段,创建其子项NSExtensionActivationSupportsWebURLWithMaxCount,并设置一个限制数量。调整后如下图所示:

图片 18image

2.2.4 处理Share Extension中的数据

其实在Share Extension中默认都会有一个数据展现的UI界面。该界面继承SLComposeServiceViewController这个类型,如:

@interface ShareViewController : SLComposeServiceViewController@end

其展现效果,如图:

图片 19image

顶部包括了标题、取消按钮和提交按钮。然后下面跟着左边就是一个文本编辑框,右边就是一个图片显示控件。那么,每当用户点击取消按钮或者提交按钮时,都会分别触发下面的方法:

/** * 点击取消按钮 */- didSelectCancel{ [super didSelectCancel];}/** * 点击提交按钮 */- didSelectPost{ // 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];}

在这两个方法里面可以进行一些自定义的操作。一般情况下,当用户点击提交按钮的时候,扩展要做的事情就是要把数据取出来,并且放入一个与Containing App(容器程序,尽管苹果开放了Extension,但是在iOS中extension并不能单独存在,要想提交到AppStore,必须将Extension包含在一个App中提交,并且App的实现部分不能为空,这个包含Extension的App就叫Containing app。Extension会随着Containing App的安装而安装,同时随着ContainingApp的卸载而卸载。)共享的数据介质中(包括NSUserDefault、Sqlite、CoreData),要跟容器程序进行数据交互需要借助AppGroups服务,下面的章节会对这块进行详细说明。下面先来看看怎么获取扩展中的数据。

在ShareExtension中,UIViewController包含一个extensionContext这样的上下文对象:

@interface UIViewController(NSExtensionAdditions) <NSExtensionRequestHandling>// Returns the extension context. Also acts as a convenience method for a view controller to check if it participating in an extension request.@property (nullable, nonatomic,readonly,strong) NSExtensionContext *extensionContext NS_AVAILABLE_IOS;@end

通过操作它就可以获取到分享的数据,返回宿主应用的界面等操作。我们可以先看一下extensionContext的定义。

NS_CLASS_AVAILABLE(10_10, 8_0)@interface NSExtensionContext : NSObject// The list of input NSExtensionItems associated with the context. If the context has no input items, this array will be empty.@property(readonly, copy, NS_NONATOMIC_IOSONLY) NSArray *inputItems;// Signals the host to complete the app extension request with the supplied result items. The completion handler optionally contains any work which the extension may need to perform after the request has been completed, as a background-priority task. The `expired` parameter will be YES if the system decides to prematurely terminate a previous non-expiration invocation of the completionHandler. Note: calling this method will eventually dismiss the associated view controller.- completeRequestReturningItems:(nullable NSArray *)items completionHandler:(void(^ __nullable)(BOOL expired))completionHandler;// Signals the host to cancel the app extension request, with the supplied error, which should be non-nil. The userInfo of the NSError will contain a key NSExtensionItemsAndErrorsKey which will have as its value a dictionary of NSExtensionItems and associated NSError instances.- cancelRequestWithError:(NSError *)error;// Asks the host to open an URL on the extension's behalf- openURL:URL completionHandler:(void (^ __nullable)(BOOL success))completionHandler;@end// Key in userInfo. Value is a dictionary of NSExtensionItems and associated NSError instances.FOUNDATION_EXTERN NSString * __null_unspecified const NSExtensionItemsAndErrorsKey NS_AVAILABLE(10_10, 8_0);// The host process will enter the foregroundFOUNDATION_EXTERN NSString * __null_unspecified const NSExtensionHostWillEnterForegroundNotification NS_AVAILABLE_IOS;// The host process did enter the backgroundFOUNDATION_EXTERN NSString * __null_unspecified const NSExtensionHostDidEnterBackgroundNotification NS_AVAILABLE_IOS;// The host process will resign active status (stop receiving events), the extension may be suspendedFOUNDATION_EXTERN NSString * __null_unspecified const NSExtensionHostWillResignActiveNotification NS_AVAILABLE_IOS;// The host process did become active (begin receiving events)FOUNDATION_EXTERN NSString * __null_unspecified const NSExtensionHostDidBecomeActiveNotification NS_AVAILABLE_IOS;
字段 说明
inputItems 该数组存储着容器应用传入给NSExtensionContext的NSExtensionItem数组。其中每个NSExtensionItem标识了一种类型的数据。要获取数据就要从这个属性入手。
completeRequestReturningItems:completionHandler: 通知宿主程序的扩展已完成请求。调用此方法后,扩展UI会关闭并返回容器程序中。其中的items就是返回宿主程序的数据项。
cancelRequestWithError: 通知宿主程序的扩展已取消请求。调用此方法后,扩展UI会关闭并返回容器程序中。其中error为错误的描述信息。
NSExtensionItemsAndErrorsKey NSExtensionItem的userInfo属性中对应的错误信息键名。

NSExtensionContext的结构比较简单,包含一个属性和三个方法。其说明如下:

字段 说明
inputItems 该数组存储着容器应用传入给NSExtensionContext的NSExtensionItem数组。其中每个NSExtensionItem标识了一种类型的数据。要获取数据就要从这个属性入手。
completeRequestReturningItems:completionHandler: 通知宿主程序的扩展已完成请求。调用此方法后,扩展UI会关闭并返回容器程序中。其中的items就是返回宿主程序的数据项。
cancelRequestWithError: 通知宿主程序的扩展已取消请求。调用此方法后,扩展UI会关闭并返回容器程序中。其中error为错误的描述信息。
NSExtensionItemsAndErrorsKey NSExtensionItem的userInfo属性中对应的错误信息键名。
字段 说明
NSExtensionHostWillEnterForegroundNotification 宿主程序将要返回前台通知
NSExtensionHostDidEnterBackgroundNotification 宿主程序进入后台通知
NSExtensionHostWillResignActiveNotification 宿主程序将要被挂起通知
NSExtensionHostDidBecomeActiveNotification 宿主程序被激活通知

类的下面还定义了一些通知,这些通知都是跟宿主程序的行为相关,在设计扩展的时候可以根据这些通知来进行对应的操作。其说明如下:

字段 说明
NSExtensionHostWillEnterForegroundNotification 宿主程序将要返回前台通知
NSExtensionHostDidEnterBackgroundNotification 宿主程序进入后台通知
NSExtensionHostWillResignActiveNotification 宿主程序将要被挂起通知
NSExtensionHostDidBecomeActiveNotification 宿主程序被激活通知

从上面的定义可以看出除了文本内容,其他类型的内容都是作为附件存储的,而附件又是封装在一个叫NSItemProvider的类型中,其定义如下:

typedef void (^NSItemProviderCompletionHandler)(__nullable id <NSSecureCoding> item, NSError * __null_unspecified error);typedef void (^NSItemProviderLoadHandler)(__null_unspecified NSItemProviderCompletionHandler completionHandler, __null_unspecified Class expectedValueClass, NSDictionary * __null_unspecified options);// An NSItemProvider is a high level abstraction for file-like data objects supporting multiple representations and preview images.NS_CLASS_AVAILABLE(10_10, 8_0)@interface NSItemProvider : NSObject <NSCopying>// Initialize an NSItemProvider with a single handler for the given item.- (instancetype)initWithItem:(nullable id <NSSecureCoding>)item typeIdentifier:(nullable NSString *)typeIdentifier NS_DESIGNATED_INITIALIZER;// Initialize an NSItemProvider with load handlers for the given file URL, and the file content.- (nullable instancetype)initWithContentsOfURL:(null_unspecified NSURL *)fileURL;// Sets a load handler block for a specific type identifier. Handlers are invoked on demand through loadItemForTypeIdentifier:options:completionHandler:. To complete loading, the implementation has to call the given completionHandler. Both expectedValueClass and options parameters are derived from the completionHandler block.- registerItemForTypeIdentifier:(NSString *)typeIdentifier loadHandler:(NSItemProviderLoadHandler)loadHandler;// Returns the list of registered type identifiers@property(copy, readonly, NS_NONATOMIC_IOSONLY) NSArray *registeredTypeIdentifiers;// Returns YES if the item provider has at least one item that conforms to the supplied type identifier.- hasItemConformingToTypeIdentifier:(NSString *)typeIdentifier;// Loads the best matching item for a type identifier. The client's expected value class is automatically derived from the blocks item parameter. Returns an error if the returned item class does not match the expected value class. Item providers will perform simple type coercions (eg. NSURL to NSData, NSURL to NSFileWrapper, NSData to UIImage).- loadItemForTypeIdentifier:(NSString *)typeIdentifier options:(nullable NSDictionary *)options completionHandler:(nullable NSItemProviderCompletionHandler)completionHandler;@end// Common keys for the item provider options dictionary.FOUNDATION_EXTERN NSString * __null_unspecified const NSItemProviderPreferredImageSizeKey NS_AVAILABLE(10_10, 8_0); // NSValue of CGSize or NSSize, specifies image size in pixels.@interface NSItemProvider(NSPreviewSupport)// Sets a custom preview image handler block for this item provider. The returned item should preferably be NSData or a file NSURL.@property(nullable, copy, NS_NONATOMIC_IOSONLY) NSItemProviderLoadHandler previewImageHandler NS_AVAILABLE(10_10, 8_0);// Loads the preview image for this item by either calling the supplied preview block or falling back to a QuickLook-based handler. This method, like loadItemForTypeIdentifier:options:completionHandler:, supports implicit type coercion for the item parameter of the completion block. Allowed value classes are: NSData, NSURL, UIImage/NSImage.- loadPreviewImageWithOptions:(null_unspecified NSDictionary *)options completionHandler:(null_unspecified NSItemProviderCompletionHandler)completionHandler NS_AVAILABLE(10_10, 8_0);@end// Keys used in property list items received from or sent to JavaScript code// If JavaScript code passes an object to its completionFunction, it will be placed into an item of type kUTTypePropertyList, containing an NSDictionary, under this key.FOUNDATION_EXTERN NSString * __null_unspecified const NSExtensionJavaScriptPreprocessingResultsKey NS_AVAILABLE(10_10, 8_0);// Arguments to be passed to a JavaScript finalize method should be placed in an item of type kUTTypePropertyList, containing an NSDictionary, under this key.FOUNDATION_EXTERN NSString * __null_unspecified const NSExtensionJavaScriptFinalizeArgumentKey NS_AVAILABLE_IOS;// Errors// Constant used by NSError to distinguish errors belonging to the NSItemProvider domainFOUNDATION_EXTERN NSString * __null_unspecified const NSItemProviderErrorDomain NS_AVAILABLE(10_10, 8_0);// NSItemProvider-related error codestypedef NS_ENUM(NSInteger, NSItemProviderErrorCode) { NSItemProviderUnknownError = -1, NSItemProviderItemUnavailableError = -1000, NSItemProviderUnexpectedValueClassError = -1100, NSItemProviderUnavailableCoercionError NS_AVAILABLE(10_11, 9_0) = -1200} NS_ENUM_AVAILABLE(10_10, 8_0);
字段 说明
initWithItem:typeIdentifier: 初始化方法,item为附件的数据,typeIdentifier是附件对应的类型标识,对应UTI的描述。
initWithContentsOfURL: 根据制定的文件路径来初始化。
registerItemForTypeIdentifier:loadHandler: 为一种资源类型自定义加载过程。这个方法主要针对自定义资源使用,例如自己定义的类或者文件格式等。当调用loadItemForTypeIdentifier:options:completionHandler:方法时就会触发定义的加载过程。
hasItemConformingToTypeIdentifier: 用于判断是否有typeIdentifier所指定的资源存在。存在则返回YES,否则返回NO。该方法结合loadItemForTypeIdentifier:options:completionHandler:使用。
loadItemForTypeIdentifier:options:completionHandler: 加载typeIdentifier指定的资源。加载是一个异步过程,加载完成后会触发completionHandler。
loadPreviewImageWithOptions:completionHandler: 加载资源的预览图片。

NSItemProvider结构说明

字段 说明
initWithItem:typeIdentifier: 初始化方法,item为附件的数据,typeIdentifier是附件对应的类型标识,对应UTI的描述。
initWithContentsOfURL: 根据制定的文件路径来初始化。
registerItemForTypeIdentifier:loadHandler: 为一种资源类型自定义加载过程。这个方法主要针对自定义资源使用,例如自己定义的类或者文件格式等。当调用loadItemForTypeIdentifier:options:completionHandler:方法时就会触发定义的加载过程。
hasItemConformingToTypeIdentifier: 用于判断是否有typeIdentifier所指定的资源存在。存在则返回YES,否则返回NO。该方法结合loadItemForTypeIdentifier:options:completionHandler:使用。
loadItemForTypeIdentifier:options:completionHandler: 加载typeIdentifier指定的资源。加载是一个异步过程,加载完成后会触发completionHandler。
loadPreviewImageWithOptions:completionHandler: 加载资源的预览图片。

由此可见,其结构如下图所示:

图片 20image

为了要取到宿主程序提供的数组,那么只要关注loadItemTypeIdentifier:options:completionHandler方法的使用即可。有了上面的了解,那么接下来就是对inputItems进行数据分析并提取了,这里以一个链接的分享为例,改写视图控制器中的didSelectPost方法。看下面的代码:

- 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];这行代码,主要是使到视图控制器不被关闭,等到实现相应的处理后再进行调用该方法,对分享视图进行关闭。在下面的章节会说明这一点。

2.2.5 将分享数据传递给容器程序

上面章节已经讲述了如何取得宿主应用所分享的内容。那么,接下来就是将这些内容传递给容器程序进行相应的操作(如:在一款社交应用中,可能会为取得的分享内容发布一条用户动态)。在默认情况下,iOS的应用是存在一个沙盒里面的,不允许应用与应用直接进行数据的交互。为此,苹果提供了一项叫App Groups的服务,该服务允许开发者可以在自己的应用之间通过NSUserDefaults、NSFileManager或者CoreData来进行相互的数据传输。下面介绍如何激活App Groups服务:

  • 首先要有一个独立的AppID(带通配符*号的AppID是不允许激活App Groups的)

图片 21image

  • 然后打开容器应用的项目配置的Capabilities页签,激活App Groups特性,如图:

图片 22image

  • 点击+号添加一个App Groups,点击OK按钮

图片 23image

  • 创建完成后,XCode会自动把应用添加到新建的分组中。如图:

图片 24image

  • 上述步骤完成后,容器程序的App Groups已经算是设置完成。然后轮到Share Extension插件需要激活App Groups服务,设置步骤跟容器程序相同,唯一不同的是,插件不需要创建新的App Group,只要加入到容器程序刚才创建的Group即可(这里可以理解为,哪些应用要实现共享数据,那么他们必须在同一个Group里面)。如图:

图片 25image

至此,应用和扩展的App Groups服务都已经启动,现在就要进行分享内容的传输操作。下面分别介绍一下NSUserDefaults、NSFileManager以及CoreData三种方式是如何实现App Groups下的数据操作:

  • NSUserDefaults:要想设置或访问Group的数据,不能在使用standardUserDefaults方法来获取一个NSUserDefaults对象了。应该使用initWithSuiteName:方法来初始化一个NSUserDefaults对象,其中的SuiteName就是创建的Group的名字,然后利用这个对象来实现,跨应用的数据读写,代码如下:
//初始化一个供App Groups使用的NSUserDefaults对象NSUserDefaults *userDefaults = [[NSUserDefaults alloc] initWithSuiteName:@"group.cn.vimfung.ShareExtensionDemo"];//写入数据[userDefaults setValue:@"value" forKey:@"key"];//读取数据NSLog(@"%@", [userDefaults valueForKey:@"key"]);
  • NSFileManager:通过调用 containerURLForSecurityApplicationGroupIdentifier:方法可以获得AppGroup的共享目录,然后在此目录的基础上实现任意的文件操作。代码如下:
//获取分组的共享目录NSURL *groupURL = [[NSFileManager defaultManager] containerURLForSecurityApplicationGroupIdentifier:@"group.cn.vimfung.ShareExtensionDemo"];NSURL *fileURL = [groupURL URLByAppendingPathComponent:@"demo.txt"];//写入文件[@"abc" writeToURL:fileURL atomically:YES encoding:NSUTF8StringEncoding error:nil];//读取文件NSString *str = [NSString stringWithContentsOfURL:fileURL encoding:NSUTF8StringEncoding error:nil];NSLog(@"str = %@", str);
  • CoreData:其实CoreData是基于NSFileManager取得共享目录后来实现数据共享的。即在初始化CoreData时,先使用NSFileManager取得共享目录,然后再指定共享目录为存储数据文件的目录(如存储的sqlite文件)。代码如下:
//获取分组的共享项目NSURL *containerURL = [[NSFileManager defaultManager] containerURLForSecurityApplicationGroupIdentifier:@"group.cn.vimfung.ShareExtensionDemo"];NSURL *storeURL = [containerURL URLByAppendingPathComponent:@"DataModel.sqlite"];//初始化持久化存储调度器NSURL *modelURL = [[NSBundle mainBundle] URLForResource:@"DataModel" withExtension:@"momd"];NSManagedObjectModel *model = [[NSManagedObjectModel alloc] initWithContentsOfURL:modelURL];NSPersistentStoreCoordinator *coordinator = [[NSPersistentStoreCoordinator alloc] initWithManagedObjectModel:model];[coordinator addPersistentStoreWithType:NSSQLiteStoreType configuration:nil URL:storeURL options:nil error:nil];//创建受控对象上下文NSManagedObjectContext *context = [[NSManagedObjectContext alloc] initWithConcurrencyType:NSMainQueueConcurrencyType];[context performBlockAndWait:^{ [context setPersistentStoreCoordinator:coordinator];}];

为了方便演示,这里会使用NSUserDefault来直接把取到的url地址保存起来。代码如下所示:

/** * 点击提交按钮 */- 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); NSUserDefaults *userDefaults = [[NSUserDefaults alloc] initWithSuiteName:@"group.cn.vimfung.ShareExtensionDemo"]; [userDefaults setValue: item).absoluteString forKey:@"share-url"]; //用于标记是新的分享 [userDefaults setBool:YES forKey:@"has-new-share"]; } }]; 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];}
2.2.6 自定义UI

如果通过扩展SLComposeServiceViewController还不能满足需求的情况下,这时候就需要自己设计一个分享视图控制器来替换默认的SLComposeServiceViewController。

  1. 首先,创建一个自定义视图控制器,如:CustomShareViewController。

  2. 然后打开扩展的Info.plist文件,删除NSExtensionMainStoryboard属性并增加一项NSExtensionPrincipalClass属性并指向CustomShareViewController(注:这里没有使用Storyboard所以要删除该属性),如图:

    图片 26image.png

  3. 接下来根据实际的需要来设计分享视图的展示与交互形式。

  4. 然后调用CustomShareViewController的extensionContext属性来控制扩展的提交与取消等操作(注:由于扩展中导入了关于ExtensionContext的UIViewController类目,因此,每个ViewController都带有extensionContext属性)。

2.2.7 演示的效果图

对于html分享和image分享的UI分开采用不同的形式展示

图片 27image.png图片 28image.png

扩展中的处理不能太长时间阻塞主线程(建议放入线程中处处理),否则可能导致苹果拒绝你的应用。扩展不能单独提审,必须要跟容器程序一起提交AppStore进行审核。提审的扩展和容器程序的Build Version要保持一致,否则在上传审核包的时候会提示警告,导致程序无法正常提审。

源码git地址

Inter-App CommunicationApp Extensions篇之Share ExtensioniOS实现App之间的内容分享iOS扩展开发攻略 - Share ExtensionApp Extensions篇之Share Extension

本文由韦德国际bv1946手机版发布于韦德国际bv1946计算机,转载请注明出处:iOS应用之间的通信就只能通过间接的方式

关键词: 伟德19461188 iOS 通信

怎么实现组件化

本片文章主要讲解我们项目中为什么要组件化 组件化的好处 怎么使用组件化怎么实现组件化 随着项目的更新迭代 项...

详细>>

可以在单例这里直接设置属性

最新!!! 有人反映使用有问题,换了一种实现方式,修改如下。 集成过高德地图的筒子们应该都清楚,创建地图内...

详细>>

通过检查比2.0更大的值来检测强烈的摇动

一、概念 加速计和陀螺仪是通过CoreMotion框架访问的。此框架提供了CMMotionManager等类,该类提供的所有数据都用来描述...

详细>>

理解运行期环境中各个部分协同工作的原理

OC是面向对象的变成语言,“对象”就是“基本构造单元”。而对象之间传递数据并执行任务的过程,就是“消息传递...

详细>>