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