紧接着缘起,今天来正式看下如何创建一个小组件。
定义小组件
-
种类(Kind)
或许你的应用非常优秀,单个小组件无法完美诠释应用的美妙。这点 Apple Widget 也替你想好了。那就是一个扩展你可以创建多种类型的小组件。例如,股票小组件。既有股票的简单信息的小组件,也有股市细节小组件。
配置(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们。
通过上面的代码,我们定义好了一个小组件。或许他们最终的样子是长这样
不支持组件内滚动
不支持诸如开关和其他控件之类的交互元素
不支持视频或者动画图像
当然你可以通过深度连接与你的应用做一些简单交互。让我们后续的相知中再来详聊它,现在你只需要知道他就好了
视图、时间线和重新加载
视图我们已经聊过了占位界面视图,他只是用来表示小组件的类型。为了能显示你真正的内容,这时候就需要另外一个视图 -- Snapshot。Snapshot 是系统显示单个条目地方,因此,尽可能快的返回第一个视图就显的尤为重要,毕竟这是你要展示给用户的真正内容。第一次,人们总不希望等太久,你懂的。
如果我们声明一组视图在不同时间显示。小组件在正确的时间渲染相应的视图,这就是时间线了。大多数情况下,时间线的第一个条目可以和Snapshot作为向同一个条目返回。时间线是返回时间和条目的组合,它允许指定什么时间显示特定的视图。小组件的的体验正式通过这样一个时间轴来驱动的。
重新加载时,系统会重新唤醒扩展,要求一个新的时间线。小组件会按照你给定的时间线渲染视图。重新加载则是你需要你告诉系统,由系统来完成