App Extensions篇之Share Extension

转载请注明出处：https://yq.aliyun.com/articles/117808?spm=5176.blogshare117808.0.0.9Vjqbx

1.前言

这里主要是对App Extension的一些介绍以及详细给大家介绍一下Share Extension，后期会添加其他的Extension介绍。

2.开始

主要对App Extension和Share Extension进行介绍。请继续往下看：

2.1: App Extension的介绍

 官方给的说法是：App Extension可以让你扩展你的APP的自定义功能和内容，使用户可以在与其他应用或者系统进行互动的时候去使用它。翻译的不一定准确，这样说可能会好理解：我们平时看到的Widget、微信和QQ的share等等，都是App Extension，下图是一些例子：

其实就是我们经常看到的Widget，但是Widget只是Today Extension，除了Today Extension，还有很多。

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

扩展和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.1: Extension的种类

我们可以在Xcode的File--->New--->Target里面看到不同平台的Extension，包括iOS、watchOS、tvOS、macOS等等。这里主要介绍iOS，主要包括以下几种Extensions：

1.Action Extension：动作扩展，在另一个应用程序的上下文中操作或者查看内容

2.Audio Unit Extension：音频单元扩展

3.Broadcast UI Extension：广播UI 扩展

4.Broadcast Upload Extension：广播上传扩展

5.Call Directory Extension：呼叫目录扩展

6.Content Blocker Extension：内容拦截器扩展

7.Custom Keyboard Extension：键盘扩展，例如第三方的键盘，搜狗输入法，百度输入法等。

8.iMessage Extension：消息的扩展

9.Intents Extension：Intents扩展

10.Intents UI Extension：Intents UI扩展

11.Notification Content Extension：通知内容扩展

12.Notification Service Extension：通知服务扩展

13.Photo Editing Extension：图片编辑扩展，在照片app中编辑照片或者视频

14.Share Extension：分享扩展，发布一个共享网站或者与其他应用共享内容。

15.Shared Links Extension：分享链接扩展

16.Spotlight Index Extension：Spotlight 索引扩展

17.Sticker Pack Extension：贴纸包扩展

18.Today Extension：Today扩展，可以快速获取更新或者在通知中心的近日视图中执行一项快速任务。

等等。也可直接在这里参见更多extension。

2.1.2: App Extensions的生命周期

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

 

 

1.用户选择要使用的App extension

2.系统启动App Extension

3.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沟通）：

 

 

 

这个展示的就是正在运行的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沟通：

例如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: Share Extension的简单使用

这里我们以Share Extension为例进行介绍。

2.2.1: 选择正确的Extension Point开始开发 

当你创建app extension的时候，可以直接使用Xcode自带的模板创建你需要的Extension。点击File--->New--->Target:

从这里选择符合你需求的Extension，当你创建完毕后，你的项目工程目录就会多一个文件夹：

可以发现多了一个.swift、.storyboard和一个Info.plist。接下来你也会在Scheme里发现一个Extension，而且多了一个以.appex为后缀的Bundle

这里需要注意：

一个app extension必须在architectures build settings 里面包含arm64(ios)或者x86_64(OS X)，否则containing app上架的时候将会被拒绝。Xcode默认的Standard architecture包含了64-bit的architecture。

An app extension target must include the arm64 (iOS) or x86_64 architecture (OS X) in its Architectures build settings or it will be rejected by the App Store. Xcode includes the appropriate 64-bit architecture with its “Standard architectures” setting when you create a new app extension target.

If your containing app target links to an embedded framework, the app must also include 64-bit architecture or it will be rejected by the App Store.

 2.2.2: 来看看默认的App Extension模板

从上面的项目工程目录看，每个extension都包含了一个plist文件、一个视图控制器类和一个默认的user interface，这些都是被extension point定义的。我们先来看一下Info.plist里面的东西：

再看看项目工程的Info.plist：

两者可以进行一个对比，可以看出：

1、CFBundlePackageType不一样，项目是APPL，而Extension的是XPC！

2、比较明显的就是App Extension里面多了一个NSExtension的字典。 

在Info.plist中，该文件必须包含NSExtension键和扩展点指定的键和值的字典。这里的ExtensionPointIdentifier是com.apple.share-services，因为我创建的是Share Extension。

这里注意，如果你的app extension的Info.plist里面包含了UIBackgroundModes key那么将无法通过AppStore的审核。 

 

2.2.3：调试App Extension 

调试App Extension很简单，你要做的就是选择（scheme）扩展，然后点击Run， 就会弹出一个弹框让你选择Host app，选择Host app之后便可以运行调试。比如你调试Share Extension，你可以选择照片，然后让照片当Host app，然后运行之后就会打开照片，选择分享就会看到你的app扩展，然后进行debug断点处理等。

2.3：Share Extension Demo

先看一下我自己做的分享Demo效果：
 

然后在containing app里面查看分享的图片：如上图的第三张图。先看一下这里默认创建的Share Extension的视图控制器：

 

class ShareViewController: SLComposeServiceViewController {

    override func isContentValid() -> Bool {
        // Do validation of contentText and/or NSExtensionContext attachments here
        return true
    }

    override func 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!.completeRequest(returningItems: [], completionHandler: nil)
    }

    override func configurationItems() -> [Any]! {
        // To add configuration options via table cells at the bottom of the sheet, return an array of SLComposeSheetConfigurationItem here.
        return []
    }

}

 

里面主要有三个方法：

isContentValid是用来判断内容是否可用的,这里可以做一些校验，比如我们分享的内容是否符合要分享的要求，如果返回false，那么在上图的Post按钮就无法点击了。因为一旦返回false，则说明分享内容不符合要求，也就无法Post了。

configuration是一个配置数组，它可以配置多个列表，例如微信分享的[发送给朋友，分享到朋友圈，收藏]：

 

 didSelectPost是你点击发送之后处理的事件，比如微信的点击收藏，可以调用微信的api，然后进行收藏。默认的注释也说明了本方法的作用：

当用户选中post之后调用。是对内容或者NSExtensionContext附件的上传。我这里使用App Group的方式进行app Extension和containing app进行交互。先将内容存储到UserDefaults，然后再在containing app里面取出图片展示到containing app里面。

这里我把图片存储到了UserDefaults，然后在Containing app里面获取：

 suite的name是app group的名称。具体可参见Github源码里的ShareExtension。 

总结

App Extension的出现使App的使用更加方便，比如系统的天气widget，还有类似微信（QQ）的分享，完全可以实现不打开containing app而直接使用share extension分享。

 在后续的时间里，将会不定期进行更新，给读者介绍其他的Extension，如有任何疑问，随时留言沟通。

参考资料

1、App Extension Programming Guide 

2、深入App Extensions for iOS8

3、Information property List Key Reference

4、App Extension Programming Guide---Share