iOS Widget 从入门到放弃-相识

紧接着缘起,今天来正式看下如何创建一个小组件。

定义小组件

  • 种类(Kind)

    或许你的应用非常优秀,单个小组件无法完美诠释应用的美妙。这点 Apple Widget 也替你想好了。那就是一个扩展你可以创建多种类型的小组件。例如,股票小组件。既有股票的简单信息的小组件,也有股市细节小组件。
    股市小组件
    这一切都是有SwiftUI和支持多平台的扩展来完成的。小组件扩展支持 SwiftUI,Appkit 和基于 Catalyst 的 MacOS App
  • 配置(Configuration)
    小组件目前支持两种类型:
    StaticConfiguration:

小组件不允许对其进行任何配置,因为配置对于小组件没有任何意义。比如说健身小组件,他只能显示你今天的运动。

IntentConfiguration:

与上面的类型相对,某些小组件可能需要提供给可选项给用户。因为处于某些考虑,必须让用户提供一些信息才行。比如天气小组件,或许他需要你提供给他一个地址才行。虽然这不是必须的

  • 支持的家族类型(SupportedFamilies)
    家族类型

    以上就是小组件支持的所有的家族类型。默认情况下,小组件支持所有。当然你可以跟你应用的实际情况去调整,苹果设计团队希望我们支持更多的家族类型。大家可以查看“天气小组件”查看实际的应用效果。

  • 占位符(PlaceHolder)
    每一个小组件都应该有自己的占位符用户界面,它是小组件的默认展示界面。当小组件刷新出你要展示的内容时,小组件需要一个页面去给用户,已提供更好的体验。苹果设计团队已经帮你做好一切,虽然你可能压根没有设想过这些。但是一定要注意,占位符界面应该只是小组件类型的表示,不应该包含用户的任何数据。另一个需要注意的重要事项是 此用户界面很少被检索,也不能保证何时会检索。
    通常只会在设备环境更改时,系统会要求一个新的占位符用户界面。例如 如果设备的动态类型设置更改。
    优秀的占位符用户界面显示了,你的小组件类型的表示,苹果设计团队鼓励你为你的小组件 考虑最好的用户界面。

是时候来点代码了,毕竟我是一个技术博主。(嘻嘻~)

public struct SampleWidget: Widget {
    private let kind: String = "SampleWidget"

    public var body: some WidgetConfiguration {
        StaticConfiguration(kind: kind,
                            provider: Provider(),
                            placeholder: PlaceholderView()) { entry in
                                SampleWidgetEntryView(entry: entry)
                            }
        .configurationDisplayName("My Widget")
        .description("This is an example widget.")
        .supportedFamilies([.systemSmall, .systemMedium, .systemLarge])
    }
}

你可以在代码中找到上文提到的所有,当然也有一些新面孔,别着急,我们稍后再来看他g们。
通过上面的代码,我们定义好了一个小组件。或许他们最终的样子是长这样

小组间们
通过这些展示的信息,或许你会想知道更多,轻轻点,小组件默认会帮你启动你的 App。现在不仅又要重复缘起时强调的那句话,不要将小组件当成你的 mini-app。它
不支持组件内滚动
不支持诸如开关和其他控件之类的交互元素
不支持视频或者动画图像
当然你可以通过深度连接与你的应用做一些简单交互。让我们后续的相知中再来详聊它,现在你只需要知道他就好了

视图、时间线和重新加载

视图我们已经聊过了占位界面视图,他只是用来表示小组件的类型。为了能显示你真正的内容,这时候就需要另外一个视图 -- Snapshot。Snapshot 是系统显示单个条目地方,因此,尽可能快的返回第一个视图就显的尤为重要,毕竟这是你要展示给用户的真正内容。第一次,人们总不希望等太久,你懂的。

如果我们声明一组视图在不同时间显示。小组件在正确的时间渲染相应的视图,这就是时间线了。大多数情况下,时间线的第一个条目可以和Snapshot作为向同一个条目返回。时间线是返回时间和条目的组合,它允许指定什么时间显示特定的视图。小组件的的体验正式通过这样一个时间轴来驱动的。

重新加载时,系统会重新唤醒扩展,要求一个新的时间线。小组件会按照你给定的时间线渲染视图。重新加载则是你需要你告诉系统,由系统来完成

苹果弃用 Today Extension

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

推荐阅读更多精彩内容