揭秘 iOS App Extension 开发 —— Today 篇

从 iOS 8 开始，苹果引入了全新的 App Extension，涉及到方方面面，例如今日面板、键盘、内容拦截器、分享动作等。但是官方对于 App Extension 的开发指南少之又少，入门起来会有很多坑。所以我准备写一系列文章来帮助大家更好入门 App Extension 的开发，也能少走弯路。

何为 App Extension？

顾名思义，它是一种扩展，很类似于一些大型软件（好吧，现在可能是个应用都可以有）的插件机制。App Extension 事实上并不是你应用的插件，而是系统的插件，其生命周期是由系统来管理的，所以如果你想做什么坏事还是行不通的...但是 App Extension 分发的载体是应用，也就是说如果你只是单纯想做一个今日面板插件，也需要有个主程序，你的主程序可以什么都不做，也可以提供一些基本的设置和数据。

App Extension 和主程序的关系？

可以说没有什么关系，基本上就是两个独立的程序，你的主程序既不可以访问 App Extension 的代码，也不可以访问其存储空间，这完完全全就是两个进程、两个程序。这时你可能会问，我擦，都不能交互那有什么卵用？？别急，后面我会讲到如何做一些交互。

App Extension 可以干什么？不可以干什么？

基本上什么都能干，有人不是在今日面板里把 Chrome 的恐龙小彩蛋硬塞进去了吗？还有拿输入法当浏览器作分屏多任务的...只有你想不到，没有你做不到......诶等等，有些还是做不到的。比如，内存有限制，App Extension 的可用内存远不如常规应用，以至于如果你真想做游戏，还是掂量掂量你的资源占用问题能不能解决吧。而且还不能访问 UIApplication，因为它的容器应用是系统，你拿系统的 UIApplication 想干嘛...（当然，你可以用递归查找 UIResponder 的方法拿到 UIApplication，但是我没试过）再次，你不能执行长时间的操作，你的 App Extension 可能随时被系统 Kill 掉，who knows?

还有更多不可用的 API 可以看这个苹果官方文档：Understand How an App Extension Works

开始创建一个 App Extension

首先看一下我们要做的东西，是一个简单 Todo 应用，主程序长这个样：

今日面板插件长这个样：

界面都很简单啦~

主程序实现其实很简单，就是 Table View 的使用以及数据持久化，这里就不着重讲了。但注意，我们要留出一个接口给今日面板，假设这里我们要在今日面板里显示前 4 条待办事项，我们必须要单独将这 4 条存在一个主程序和扩展都能访问的地方。后面我会说怎么做。

Tips:

苹果的 HIG 明确指出，不要在今日面板里使用可以滚动的 Scroll View，而是要完全展开，因此对于多条数据，我们要不就分页，要不就只显示前几项。

下面，我们就为工程创建一个 Today Extension：

一路下一步，输入一个子项目名，点 『Finish』就完成 Today Extension 的添加了。

这个子项目的初始目录结构如下：

P.S. 那个 entitiements 文件是后来创建的，一开始不会有

然后我们在 Storyboard 里把大致界面拖出来，如果画布大小不合适可以在这调整一下，但是也就是调整了预览效果，真实的大小不能在 IB 里修改。

那我们怎么修改视图在今日面板里的大小呢？答案是修改 View Controller 的 preferredContentSize 属性，不理会 width，调整 height 到合适的大小即可，因为宽度总是和屏幕宽度相同的。

在这个例子中，我使用 44 * 项目数量 - 1 来作为视图高度，因为一个标准 Table View Cell 的高度是 44，然后减掉最后一个条目分割线的高度就是我们理想的合适高度。

主程序向 App Extension 共享数据

我们在主程序里创建了待办事项，怎么才能让 App Extension 获取到呢？由于两者代码和数据都不互通，所以我们 可以理所当然的想到用 App Group 来解决。首先在主程序中创建一个 App Group：

然后在 App Extension 里添加这个 App Group 即可。

这样，我们就可以用 NSUserDefaults 通过这个 App Group 交流数据了。

还记得我说过要拿出所有数据的前四条放到今日面板中展示吗？下面我们就来实现这个功能：

当主应用的数据变化后就调用这个方法来更新快照数据。

下面我们主要来看 Today Extension 怎么实现，首先看看这两个方法：

其中第一个方法是系统告诉 Extension 需要更新了，当你更新完毕之后通过 block 回调告诉系统你完成了还有做了什么，通常我们就告诉系统我们更新数据了即可（就是给 block 传 NCUpdateResultNewData 枚举项作为参数）。

其中第二个方法是返回一个内补大小，如果不实现，默认情况视图左侧会有一定的缩进。当然，苹果还是希望你不要修改默认的内补~

然后我们实现数据的读取：

P.S. 第三行写错了，不要管它

其实也很简单，就是从 App Group 的配置里拿出前 4 项的快照，然后更新一下 Table View 即可。这个方法在 viewDidLoad 或者 widgetPerformUpdateWithCompletionHandler: 中调用都可以。

到这我们看看效果，选中 Today Extension 的那个 Scheme 点击调试按钮，弹出下面的对话框：

选择我们的主程序，点击 『Run』。

App Extension 调起主程序并执行动作

当我们的 Todo List 是空的情况下，我们希望在今日面板里展示一个按钮，点击后可以快速进入创建 Todo 的界面，就像这样：

由于我们访问不了主程序的代码，所以只剩下一条路可以选，那就是 URL Scheme。

首先，我们给主程序注册一个 URL Scheme：

然后响应按钮点击：

由于 App Extension 访问不了 UIApplication，因此不能用它的 openURL:，但是我们可以用 extensionContext 来打开 URL，用法和效果是一样的。

回到主程序，我们处理 URL 的打开：

这里我用 Notification 的方式告知指定 View Controller 来执行相应动作，当然你也可以用你自己喜欢的方式，这里最复杂也就是处理路由，现在也有很多方法实现，我这里就不深究了。

下面看看效果（不好意思，图没做好，不动请在新窗口中打开）：

好了，到这我们就基本打通主程序和 App Extension 的相互通信了，是不是也很简单呢？

最后，一个小提醒

由于通知中心的界面是一大块 UIVisualEffectView ，并且具体参数调整过，所以插件的背景色最好保持透明，主要文字颜色最好是白色，次要文字的颜色最好是 lightTextColor，这样能适应毛玻璃下的 Vibrancy 效果。

今日面板每个插件的高度计算和 UITableView 自适应高度的计算方式一致，如果你没有设置 preferredContentSize，或者把它设为 CGSizeZero 了，就表示你想采用自适应高度，那么系统就会根据你设计的 Auto Layout 来确定适合的高度。如果你想这么做的话，直接参考 UITableViewCell 在 iOS 8 以后自适应高度的方式即可。