Share Extension（分享扩展）是一种iOS系统级扩展，该扩展使 iOS 应用间数据交换成为可能。

图片

除 Share Extension 外，iOS 系统级扩展还包括 Today Extension、Action Extension、Photo Editing Extension、Custom Keyboard 等，本文只讲 Share Extension 的基本用法。

言归正传

下面开始

一步步实现Share Extension。

Share Extension 不能单独创建，必须依赖于一个工程项目。

打开要增加扩展的项目，点击 File → New → Target
选择 Share Extension
填写 Product Name（产品名）及其他常用选项，点击Finish
在弹出窗口中选择“Activate”

这样，一个分享扩展就创建好了。

下面，我们可以开始编译运行这个扩展，与普通项目不一样的是：Share Extension 的运行需要选择一个Host APP（宿主应用，以下简称主程序）。这里以 Safari 为例，选中 Safari 并点击 Run，会启动 Safari ，打开任意一个网页，点击下方的

分享按钮

分享按钮，不出意外，这时候应该就可以看见你的分享扩展了。（出意外了？看下面的爬坑记录）

从现在开始，我们讨论的前提就是已经创建好了 Share Extension

创建完 Share Extension 后，在项目目录中会生成一个 ShareExtension 文件夹，其中的 ShareViewController.swift 就是系统默认的入口文件。
ShareViewController 继承于 SLComposeServiceViewController，会附带一个默认的分享视图，点击分享按钮，然后点击刚创建的 Share Extension，弹出的分享弹框视图即是。
此时如果点击弹框的 Post 按钮，程序会执行 didSelectPost 方法，我们只需要在此方法中实现分享逻辑即可。
这里难免会用到主程序的一些信息，比如当前登录用户的 UserID 等。

下面，我们就来讨论一下

如何在 Share Extension 中获取主程序的信息

在默认情况下，iOS的应用是存在一个沙盒里面的，不允许应用之间直接进行数据的交互。
不过，对于开发者自己的应用，可以利用苹果提供的 App Groups 服务，在自己的应用之间进行数据传输。
一般来说，利用 App Groups 服务传输数据主要有 UserDefaults、FileManager、CoreData 三种方式。

使用 App Groups 服务

非常简单，只需在主程序项目配置中选择 Signing & Capabilities（Xcode 11以下是 Capabilities），添加 App Groups Capability ，然后增加一个App Groups 即可。

App Groups 跟Bundle ID 一样，只是通常以group.开头。

下面说一下

共享数据的三种方式

UserDefaults

创建

UserDefaults(suiteName: "your.app.groups.id")，注意不能用 UserDefaults.standard

读取与写入

与正常的UserDefaults一致。
UserDefaults(suiteName: "your.app.groups.id")?.set("your.value", forKey: "YOURKEY")

   UserDefaults(suiteName: "your.app.groups.id")?.value(forKey: "YOURKEY")*

FileManger

创建

let groupURL = FileManager.default.containerURL(forSecurityApplicationGroupIdentifier: "your.app.groups.id")

读取与写入

与正常的FileManager一致
// 写入
try FileManager.default.copyItem(at: srcURL, to: groupURL.appendingPathComponent(srcURL.lastPathComponent))
try "your.content".write(to: groupURL, atomically: true, encoding: .utf8)
// 读取
try String(contentsOf: groupURL)

CoreData

其实CoreData是基于 FileManager 取得共享目录后来实现数据共享的，此处不多介绍。

通过这些方式，相信很容易可以拿到分享时需要的用户信息了，接下来，我们再来看一下

如何获取分享的内容

通过Share Extension唤醒的程序，可以通过 *self.extensionContext?.inputItems *获取到分享内容，示例代码如下：

struct MyError: Error {
    var localizedDescription: String
}

override func viewDidLoad() {
        super.viewDidLoad()

        for inputItems in self.extensionContext?.inputItems.compactMap({ $0 as? NSExtensionItem }) ?? [] {
            for itemProvider in inputItems.attachments ?? [] {
                if itemProvider.hasItemConformingToTypeIdentifier(kUTTypeImage as String) {
                itemProvider.loadItem(forTypeIdentifier: kUTTypeImage as String, options: nil) { (data, error) in
                        
                    guard error == nil else {
                            self.extensionContext?.cancelRequest(withError: error!)
                        return
                    }
                        
                    guard let element = data as? URL else {
                            self.extensionContext?.cancelRequest(withError: MyError(localizedDescription: "获取分享内容失败"))
                        return
                    }
                        
                    // element 就是分享内容的 URL，可以在此保存备用。
                        
                }
            }
        }
    }
}

有了内容跟用户信息，接下来只需要调用网络请求即可，以Alamofire库为例，通常，我们是用CocoaPods管理第三方库的，同样也可以

用CocoaPods管理 Share Extension 的第三方库

使用方法也非常简单，只需要在Podfile里增加

target 'ShareExtension' do
    pod 'Alamofire'
end

接下来，像开发主程序一样去做就可以了。

当然，主程序也可以跟Share Extension

共享代码

只需要选中需共享的文件，在右侧功能区的target里勾选 ShareExtension 即可。
如果你不嫌复制代码low的话，直接粘贴复制当然也可实现共享代码。

配置UI

ShareViewController 中的 configurationItems() 方法可以配置选择项，如分享到微信的发送给朋友、分享到朋友圈、收藏一样。
通常这个方法需要返回一个包含 SLComposeSheetConfigurationItem 的数组，
SLComposeSheetConfigurationItem 有 title，value， tapHandler， valuePending 四个属性，分别对应标题、值、点击事件、加载中提示四个功能。

如果需要跳转控制器，通常需要用到 *self.pushConfigurationViewController(_:) *方法。

自定义UI

如果自带的UI不能满足需求，可以完全自定义UI，只需将ShareViewController 继承于 UIViewController 即可。
值得注意的是，自定义UI时不要使用 UIScreen.main.bounds ，会拿不到数据。

至此，Share Extension 基本开发套路介绍完了。

强调几个需要注意的点

注意内存消耗

Share Extension 只有120M的内存空间可以使用（测试环境：Xcode 11，iOS 12.3.1），所以开发时请注意内存消耗，尤其不要向UserDefaults里大量写入数据，可以采用FileManager 的 *copyItem *保存要分享的内容。

注意上架要求

为减少上架时不必要的麻烦，建议：

Share Extension 的 Info.plist 中，对NSExtensionAttributes做显式声明。

以网址为例，具体做法：
* 在Info.plist将NSExtensionActivationRule字段类型由String改为Dictionary。
* 展开NSExtensionActivationRule字段，创建其子项NSExtensionActivationSupportsWebURLWithMaxCount，并设置一个限制数量。

确保 Share Extension 的部署目标跟主程序部署目标一致。
注意Share Extension 的使用限制：
不能访问 sharedApplication 对象
不能使用任何标记NS_EXTENSION_UNAVAILABLE宏的API，或者类似的宏，或者不可用framework里面的API，例如HealthKit framework不能用于App extensions
不能访问相机或者麦克风（iMessage app可以访问这些资源，只要在Info.plist里面进行配置使用描述即可）
尽量不要运行一个长时间的后台任务（根据不同平台而异）
不能使用AirDrop接收数据

进阶

有些业务放在Share Extension 中可能会过于繁琐，会使 Share Extension 过于臃肿。于是乎，对于一些较为复杂的逻辑，或者对主程序依赖程度较高的功能，我们会考虑

在主程序中处理

例如：QQ的“发送给好友”就采用了该方案。

此方案思路较为明确：
首先，保存要分享的数据，；
然后，打开主程序；
最后，主程序获取到分享的数据并进行相关分享等操作。

保存与读取数据

我们可以用UserDefaults、FileManager、CoreData等任何一种你喜欢的方式保存或读取即可。忘了的可以回去看共享数据的三种方式

打开主程序

因为苹果爸爸是不允许 Share Extension 中使用 openURL的（Today Extension 跟 Message Extension可以），所以，这里我们需要用一点小技巧。

首先，配置URL Scheme。
在项目配置中，选择 Info，在URL Types 中输入 URL Schemes 即可。注意 URL Schemes 通常为纯英文字符，使用 _、*、&、%等特殊会导致无法打开程序（-、.可以使用）。

然后，就可以利用如下小技巧通过 URL Scheme 打开主程序了
具体写法如下：

    /// 打开主APP
    /// - Parameter type: 打開類型
    func openContainerApp(type: String) {

        let scheme = "yoururlscheme://type"

        let url: URL = URL(string: scheme)!

        let context = NSExtensionContext()

        context.open(url, completionHandler: nil)

        var responder = self as UIResponder?

        let selectorOpenURL = sel_registerName("openURL:")

        while (responder != nil) {

            if responder!.responds(to: selectorOpenURL) {

                responder!.perform(selectorOpenURL, with: url)

                break

            }

            responder = responder?.next

        }

        self.extensionContext?.completeRequest(returningItems: [], completionHandler: nil)

    }

主程序打开后会调用AppDelegate 的 application(_:open:options:) 方法，可以用 url.host 获取到 ://后的type，以便进行相应的跳转或数据处理。

主程序打开了，分享的内容也有了，剩下的尽情发挥吧~

爬坑记录：

一、 Share Extension 不显示。

        第一次按步骤操作后，点击分享，Share Extension 始终无法在共享菜单里显示出来，尝试过以下几种方式：

Share Extension 的 Info.plist 中，对NSExtensionAttributes做显式声明，发现并没用。
Share Extension 的 Info.plist 中，增加App Transport Security Settings，设置Allow Arbitrary Loads 为 YES，也无效果；
使用正式版Xcode打开项目（之前用的是Beta版），无效；
更改 Share Extension 的部署目标跟主程序部署目标一致（iOS 10.0，iPhone），无效；

最终，通过在正式版 Xcode 中删除 Share Extension 并重新创建 Share Extension 问题得以解决，推测问题原因可能是 Beta 版 Xcode 对此存在 Bug，建议在开发时，尽量使用正式版 Xcode 进行开发，以免造成一些不必要的麻烦。

二、无法找到 kUTTypeText 等

kUTTypeText、kUTTypeImage、kUTTypeURL 在 CoreServices 内（iOS系统是 MobileCoreServices），需要

import MobileCoreServices
import CoreServices 后在 Linked Frameworks and Libraries中 Add CoreServices库

以上方法二选一，建议第一种。

三、无法通过 URL Schemes 启动程序

URL Schemes 中使用 _、*、&、%等特殊会导致无法打开程序，短线(-)、小数点(.)可以使用。
如果通过 URL Scheme 无法启动程序，可以在 Safari 地址栏中输入 yourURLScheme:// 试一下能否打开，如果Safari都打不开，就是URL Scheme配置问题，否则是唤起的代码存在问题。

附录

Info.plist 常用字段说明

Bundle display name	扩展的显示名称，默认跟你的项目名称相同，可以通过修改此字段来控制扩展的显示名称。
NSExtension	扩展描述字段，用于描述扩展的属性、设置等。作为一个扩展项目必须要包含此字段。
NSExtensionAttributes	扩展属性集合字段。用于描述扩展的属性。
NSExtensionActivationRule	激活扩展的规则。默认为字符串“TRUEPREDICATE”，表示在分享菜单中一直显示该扩展。可以将类型改为Dictionary类型，然后添加以下字段： NSExtensionActivationSupportsAttachmentsWithMaxCount NSExtensionActivationSupportsAttachmentsWithMinCount NSExtensionActivationSupportsImageWithMaxCount NSExtensionActivationSupportsMovieWithMaxCount NSExtensionActivationSupportsWebPageWithMaxCount NSExtensionActivationSupportsWebURLWithMaxCount
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页面分享，需要自己设置一个数值。

参考文档：

【iOS扩展开发攻略】Share Extension
iOS Share Extensions开发教程
面向 Extension 开发 Share Extension
App extension 总结
App Extension Keys

Share Extension 开发指北