iOS

iOS功能_桌面小组件

[toc]

桌面小组件

相关文档：

一、小组件时间线

时间线，其包含多个时间线条目，每个时间线条目都包含时间和数据，用来更新小组件。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
struct Provider: AppIntentTimelineProvider {
  	// 用户第一次看到小组件时，显示的时间线条目占位数据
    func placeholder(in context: Context) -> SimpleEntry {
        SimpleEntry(date: Date(), configuration: ConfigurationAppIntent())
    }

  	// 随后会调用以下方法，会要求程序提供预览快照，需要异步返回一个时间线条目展示小组件。当然这个方法不仅在小组件库中展示时会调用，其他情况下也可能调用，可以用 `context.isPreview` 来判断当前是否在组件库中显示
    func snapshot(for configuration: ConfigurationAppIntent, in context: Context) async -> SimpleEntry {
        SimpleEntry(date: Date(), configuration: configuration)
    }
    
  	// 返回时间线，其包含多个时间线条目，每个时间线条目都包含时间和数据，用来更新小组件
    func timeline(for configuration: ConfigurationAppIntent, in context: Context) async -> Timeline<SimpleEntry> {
        var entries: [SimpleEntry] = []

        // Generate a timeline consisting of five entries an hour apart, starting from the current date.
        let currentDate = Date()
        for hourOffset in 0 ..< 5 {
            let entryDate = Calendar.current.date(byAdding: .hour, value: hourOffset, to: currentDate)!
            let entry = SimpleEntry(date: entryDate, configuration: configuration)
            entries.append(entry)
        }

      	// 
        return Timeline(entries: entries, policy: .atEnd)
    }
}

主动请求重新刷新

如果在App中修改了小组件的数据，可以通过如下的方式主动触发WidgetKit刷新小组件。

代码语言：javascript

复制

1
2
3
4
// 指定刷新哪个组件
WidgetCenter.shared.reloadTimelines(ofKind: "com.mygame.character-detail")
// 刷新全部组件
WidgetCenter.shared.reloadAllTimelines()

End