iOS14 widget

要开发新的 Widget 组件, 首先你要准备 Xcode 12 Beta 版本, 以及一台安装了 iOS 14 Beta 版本的设备, 或者直接使用模拟器.

1.在 Xcode 12 中创建一个新项目, 并且在项目设置页面里,点击左下角的箭头创建新的 Target:

2.在弹出的组件选择窗口中, 在右上角的搜索栏中输入 widget , 然后在过滤后列表中选中 Widget Extension , 点击 Next 继续.

2.接着, 输入 widget 的名称, 根据需求选择 Include Configuration Intent 的选择, 点击 Finish

不勾选小组件事没有编辑功能的，我的项目是需要勾选的

3，勾选之后创建项目会多出来这些

4.默认Widget文件结构分析

1）@main
struct WidgetUI: Widget {
?? ?
??? let kind: String = "WidgetUI"

???? var body: some WidgetConfiguration {
?????? ?
????? return? IntentConfiguration(kind: kind,

这里就是widget的main入口函数了，不勾选ConfigurationIntent 这里应该是个staictConfiguration

?

??? func placeholder(in context: Context) -> SimpleEntry {

2）Provider主要用于数据刷新

???? placeholder :系统让你的 view 自动渲染一个占位图。

?? getSnapshot：快照预览为了在小部件库中显示小部件，在你添加widget时候，预览的样式。当部件还没有从服务器获取状态??? 时，Provider通过显示一个空状态来实现getSnapshot方法。

getTimeline：在请求初始快照后，WidgetKit调用getTimeline(for:with:completion:)向提供者请求一个常规的时间线。时间线由一个或多个时间线条目和一个重载策略组成，告知WidgetKit何时请求后续时间线。

? Widget的刷新策略

??? Timeline里面有三种方式：atEnd，after(date)，never

• atEnd: timeline 中最后一个 entry 显示后更新。timelines 方法会重新调用。
• after(date): 指定日期，重新更新timeline。
• never：系统不会自动更新，除非我们主动通过 Widget Center Api 来更新

所以要是做时钟时间空间就要刷新的频繁了 in 0 ..< 60

?let entryDate = Calendar.current.date(byAdding: .second, value: hourOffset, to: currentDate)!

?

3）SimpleEntry 就是数据了,像电量及时刷新的数据可以放到里面

struct SimpleEntry: TimelineEntry {
??? let date: Date
??? let configuration: ConfigurationIntent

??? let batteryLevel: Float

}

4）WidgetUIEntryView这里就是写页面布局的地方了

5）编辑功能有静态和动态的

静态的不用勾选Dynamic 选择所需要的类型在表里面添加所需要的数据

如选择枚举类型进行添加type1，type2，编辑小组件的时候会出现type1，type2选择的列表

我这里用的是动态的

动态的需要加另外一个extension

会出现

class IntentHandler: INExtension, ConfigurationIntentHandling{
?? ?
??? func provideModelOptionsCollection(for intent: ConfigurationIntent, with completion: @escaping (INObjectCollection<LRDModel>?, Error?) -> Void) {

???? let collection = INObjectCollection(items:list)
??????? completion(collection, nil)

}

在这里可以返回你所需的动态数据，当然返回的是之前定义数据类型的一个集合

可以用UserDefaults.init(suiteName:)或者 FileManager 与主app进行数据共享

在获取文件路径转字符串时用.path 不要用absoluteString 返回的结果不一样

.path file:/Users/admin/Library/

absoluteString

file:///Users/admin/Library/

?

?