iOS 14开发 Widget小组件

详细介绍小组件的内容已经有很多了。我就不再多费事了。现在将一些内容总结在本文中。
更新:根据资料我自己写了一套完整的14开发 Widget小组件介绍
iOS 14 Widget小组件

一、资料

  1. 以下资料对于从零开始搭建一个实战Widget小组件,有很好的帮助。
    按照作者一步一步写,就能搭起一个有互联网请求、图片请求、与主App交互的小组件
    iOS14 Widget小组件开发实践1——了解Widget
    iOS14 Widget小组件开发实践2——自定义Widget
    iOS14 Widget小组件开发实践3——Widget点击交互
    iOS14 Widget小组件开发实践4——用户属性配置
    iOS14 Widget小组件开发实践5——网络图片的加载
    iOS14 Widget小组件开发实践6——关于组件数据刷新间隔问题
  2. 以下资料可以了解一些App Widget 的更新机制、渲染机制问题。
    对于可配置的Widget组件也有介绍
    iOS14新特性探索之二:App Widget小组件应用

二、爬坑

  1. 与主App交互
  1. 创建多个小组件
    iOS14 Widget开发踩坑(二)修正版-多个小组件
    https://blog.csdn.net/qq_38718912/article/details/108148736?utm_medium=distribute.pc_relevant.none-task-blog-baidujs_title-2&spm=1001.2101.3001.4242

三、TimelineProvider补充

1. 概述

在不同的时候,WidgetKit会向提供者请求一个时间表。日程表是符合TimelineEntry的对象数组。每个日程表条目都有一个日期,您可以指定用于显示小部件的其他属性。
WidgetKit通过以下两种方式之一请求时间线条目:

  • 单个即时快照,表示小部件的当前状态。
  • 一个条目数组,包括小部件状态改变的当前时刻和任何未来日期(如果已知)。
2. getSnapshot(快照)

WidgetKit在临时情况下(例如用户添加小部件时)显示小部件时发出快照请求。WidgetKit提供了一个上下文参数,其中包含有关如何使用条目的详细信息,包括它是否是小部件库的预览,以及要显示的小部件的系列或大小。如果上下文.isPreview如果为true,则小部件将显示在小部件库中,并且需要提供商的快速响应。如果生成快照所需的信息不可用,或者需要额外的时间来加载,请改用示例数据。

3. 时间线设置

WidgetKit在用户从小部件库添加小部件后发出时间线请求。因为小部件扩展并不总是在运行,所以WidgetKit需要知道何时激活它来更新小部件。当您想要更新小部件时,提供者生成的时间线会通知WidgetKit。

如果提供者需要执行异步工作来生成时间线,例如从服务器获取数据,请存储对完成处理程序的引用,并在异步工作完成时调用它。

4. 确定刷新策略

创建时间线时,提供程序指定一个刷新策略,用于控制WidgetKit何时请求新的时间线。默认行为是使用.atEnd在时间线中的条目指定的最后日期之后请求新的时间线。但是,如果WidgetKit请求新时间线的日期不同,则可以将刷新策略指定为.after(date:)。

// 2.5小时后刷新时间线.
let date = Calendar.current.date(byAdding: .minute, value: 150, to: Date())
let timeline = Timeline(entries: entries, policy: .after(date))
completion(timeline)

使用不同日期有意义的其他示例包括:

  • 在显示股票市场详细信息的小部件中,您可以指定下一个市场开盘或收盘日期,因为信息通常不会在夜间或周末更改。
  • 航班着陆后,航班跟踪小部件可能会继续显示“航班着陆”指示。在这种情况下,您可以指定一个比航班着陆时间晚的日期,以便在清除之前其状态保持可见一段时间。

或者,如果将来的事件不可预测,可以通过为策略指定.never来告诉WidgetKit根本不请求新的时间线。在这种情况下,当新的时间线可用时,应用程序调用WidgetCenter函数reloadTimelines(ofKind:)。

  • 当用户将一个小部件配置为显示一个角色的健康状况,但该角色不再积极参与战斗,并且其健康水平不会改变时。
  • 当一个小部件的内容依赖于用户登录到一个帐户,而他们当前没有登录时。

在这两个示例中,当应用程序确定状态已更改时,它调用WidgetCenter函数reloadTimelines(ofKind:),WidgetKit请求一个新的时间线。

5. 高效刷新小部件

每个配置的小部件每天接收有限的刷新次数。有几个因素会影响小部件接收的刷新次数,例如包含的应用程序是在前台还是后台运行,小部件在屏幕上显示的频率,以及包含的应用程序参与的活动类型。

6. 注意

在Xcode中调试小部件时,WidgetKit不会施加此限制。要验证小部件的行为是否正确,请在Xcode的调试器之外测试应用程序和小部件的行为。

7. 使用以下方法优化小部件刷新:
  • 让包含应用程序在小部件需要数据之前为小部件准备数据。使用共享组容器存储数据。
  • 在应用程序中使用后台处理时间来更新共享数据。有关详细信息,请参阅使用后台应用程序刷新更新应用程序。
  • 如前一节所述,为显示的信息选择最合适的刷新策略。
  • 仅当小部件当前显示更改的信息时才调用reloadtimelines(ofkind:)。

当你的应用程序在前台,有一个活动的媒体会话(AVAudioSession),或者正在使用标准的位置服务时,刷新不计入小部件的每日限制。有关媒体会话和位置服务的更多信息,请参阅AVAudioSession和使用标准位置服务。

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

推荐阅读更多精彩内容