App Extension 之 Today

Today 视图的中扩展被称为插件。用户可以通过插件快速访问当前重要的信息。比如,用户打开 Today 视图检查当前的股票价格和天气情况,查看日程安排或者快速执行类似标记已完成项目等操作。用户会频繁打开Today视图,并且他们期望能立即看到他们感兴趣的信息。插件也能展示在iOS设备的锁屏界面上。

开始之前
要确保 Today 扩展点适合你想提供的功能。最好的插件可以为用户展现最近的更新或者完成简单的任务。如果你创建的扩展想完成步骤繁多或者比较耗时的任务,比如上传或者下载内容,那么Today扩展可能不是最佳选择。

可参看 Table 1-1 了解你可以创建的其他扩展类型。

理解Today 插件
在两个平台上,Today 插件应该:
1.确保内容永远是最新的
2.正确响应用户的操作
3.高效运行(特别是iOS插件必须合理使用内存,否则系统可能终止插件的运行)

由于与插件的交互快速且有限制,所以你应该设计一个精简的UI以突出用户感兴趣的信息。通常,一个很好的办法是限制插件中可交互项的数目,尤其要注意iOS插件不支持键盘输入。

注意:避免在插件中放置滚动视图,因为用户在滚动插件中的内容时,会很容易误滚动整个Today视图。

用户使用的平台不同,因此插件配置方式也有差别。

iOS.由于插件不允许键盘输入,所以用户需要能使用containing app来配置插件的内容和行为。比如,在 Stocks 插件中,用户可在不同的股票值之间进行切换,但是他们必须打开Stocks app来管理股票列表。

OS X.containing app可能不会执行任何功能,所以插件在运行时需要给用户配置它的方式。比如,OS X中的Stocks插件可以让用户找到和添加他们想要追踪的股票。OS X中通知中心的API包括可以让用户配置插件的方法。

在用户安装完包含 Today 插件的应用程序后,他们可以为 Today 视图添加插件。当用户在 Today 视图中选择编辑时,通知中心会展现一个视图让用户添加插件,并可对其进行排序和移除。

使用Xcode的Today模板
Xcode的Today模板为主要类提供了默认的头文件和执行文件(命名为TodayViewController),一个Info.plist文件,一个界面文件(一个storyboard或者xib文件)。

默认情况下,Today 模板提供了以下 Info.plist 键和值(这里展示的是OS X target):
NSExtension

    NSExtensionPointIdentifier 
    com.apple.widget-extension 
    NSExtensionPrincipalClass 
    TodayViewController 

如果你使用了自定义视图控制器子类,那么使用自定义类的名字来取代NSExtensionPrincipalClass 键对应的TodayViewController值。

iOS.如果你不想使用模板提供的storyboard文件,那就移除NSExtensionMainStoryboard 键,并添加NSExtensionPrincipalClass 键,使用view controller的名字作为值。

创建Today插件所需的大部分工作包括设计UI和实现一个完成自定义功能的view controller子类。

设计UI
重要:为了获得最佳的效果,请使用Auto Layout设计Today插件的视图。

由于Today视图的空间有限,并且用户体验应该是快速和集中的,你不应该默认创建一个过大的插件。在两个平台上,一个插件必须适应Today视图的宽度,但是它可以通过增加高度来展示更多的内容。

默认情况下,插件视图包括标准的margin insets。如果你需要检查或者改变边距值,你可以遵循 NCWidgetProviding 协议,并实现widgetMarginInsetsForProposedMarginInsets:方法。

在大多数情况下,调整margin insets不是必须的,但如果你的设计需要你可能会这么做。比如,Reminders插件在左侧边缘展示复选框图片。

如果插件需要展示额外的内容,你可以用Auto Layout约束来调整插件到合适的高度。如果不使用Auto Layout,那你可以使用UIViewController 属性 preferredContentSize来指定插件的新高度。比如:

  • (void)receivedAdditionalContent {
    self.preferredContentSize = [self sizeNeededToShowAdditionalContent];
    }
    通常情况下,你不应该让插件过高,因为用户必须滚动才能查看全部内容。

iOS.如果你想让调整高度的动画和展示内容的动画一起执行,实现viewWillTransitionToSize:withTransitionCoordinator:方法。用animateAlongsideTransition:completion:方法把动画添加到coordinator参数中。

为了让你的插件能在Today视图中清晰地展示出来,可使用notificationCenterVibrancyEffect。

OS X. 插件会从它的view controller所在的视图中继承NSAppearanceNameVibrantDark当使用标准控件时,你会自动获得正确的外观。如果使用自定义颜色,那要确保所选颜色在深色视图中看起来也很适合。

更新内容
Today 扩展点提供了API来管理插件的状态,并处理内容更新(你可以在 Notification Center Framework Reference 阅读关于该API的内容)。虽然 Today API 针对特定平台会有所不同,但两个平台都支持的功能的API大部分是相同的。

为了让插件看起来保持最新的内容,系统会不定期抓取插件视图的快照。当插件再次可见,将会展示最近的快照,直到系统使用视图的实时版本取代它。

想要在抓取快照前更新插件的状态,那要确保遵照 NCWidgetProviding 协议。当你的插件接收widgetPerformUpdateWithCompletionHandler: 调用时使用最近的内容更新插件视图,并调用completion handler(完成处理程序),使用以下常量来描述更新结果:

NCUpdateResultNewData—新内容要求你重绘view
NCUpdateResultNoData—插件不要求更新
NCUpdateResultFailed—在更新期间发生错误

指定插件应该在何时出现
如果你的插件只应该在某种环境下进行展示,比如当它有新内容或者值得关注的内容进行展示时,你可以使用NCWidgetController API来指定插件应该在何时出现。

插件与其 containing app 可使用 setHasContent:forWidgetWithBundleIdentifier:方法来设置插件内容的当前状态。即使插件没有运行,Containing app也可以使用这个API。

注意:如果没有内容可供展示,那么插件会隐藏自身。通知中心将不会再次打开你的插件直到containing app指定插件应该被展示。

打开Containing App
在某些情况下,插件请求containing app打开是有意义的。比如,在OS X中,当用户点击日历插件中的事件时会打开日历应用。(在iOS中,用户可能需要在containing app打开之前解锁设备)在用户当前任务上下文环境中,为了确保containing app能以用户理解的方式打开,你需要定义一个能在app和它的插件中都能使用的URL scheme。

插件不能直接通知其containing app打开,它使用NSExtensionContext的openURL:completionHandler:方法通知系统去打开其containing app。当插件使用该方法打开URL,系统会在使用它之前确认请求。

支持可编辑(仅适用于OS X)
想要在 OS X 插件中支持编辑模式,需要遵照 NCWidgetProviding 协议。当你把 widgetAllowsEditing 属性设置为YES,Info按钮会自动展示在插件的头部区域。(当用户点击Info按钮,它会自动切换至 Done 按钮。)使用 NCWidgetProviding协议来支持可编辑,当视图进入编辑模式时,编辑、完成和取消按钮会自动被提供。

为了观察插件中编辑和非编辑模式之间的变化,你可以使用 NCWidgetProviding 协议的widgetDidBeginEditing 和 widgetDidEndEditing 方法。

如果你还想在用户编辑插件时展示一个模态搜索UI,可使用NSViewController的NCWidgetProvidingPresentationStyles 类别来模态弹出搜索视图控制器。当用户表明他们进行搜索时,可使用dismissViewControllerAnimated:completion:方法来解除搜索视图控制器。(注意你也可以使用presentViewControllerInWidget:方法来展示一个在头部区域有取消按钮的非搜索模态视图)

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,406评论 5 475
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,976评论 2 379
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,302评论 0 335
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,366评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,372评论 5 363
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,457评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,872评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,521评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,717评论 1 295
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,523评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,590评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,299评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,859评论 3 306
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,883评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,127评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,760评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,290评论 2 342

推荐阅读更多精彩内容

  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 12,010评论 4 62
  • 最近,看方中信,廖启智《律政强人》里商界斗法奇招迭出,人物塑造张弛有力,很是过瘾。方中信饰演的大状有魄力,有手段,...
    煜麒阅读 497评论 0 0
  • 婚姻情感语录:没有不幸的婚姻,只有不幸的夫妻。一对对夫妻怀着对婚姻的无比美好的憧憬走入婚姻的殿堂,可最终他们却失望...
    432c57ca314e阅读 378评论 0 1
  • 没想到前几日的文章还会有评论,真是让我受宠若惊。但是原谅我不再一一回复了。 今天和大长腿小姐讲到张爱玲,我几乎已经...
    独木Atree阅读 477评论 0 5
  • end() 方法结束当前链条中的最近的筛选操作,并将匹配元素集还原为之前的状态。 主要是在利用 jQuery 的链...
    尤樊容阅读 360评论 1 1