要开发新的 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/补充：
之前在刷新控件的时候用的是
let timeline = Timeline(entries: entries, policy: .atEnd)这种机制
填充entry使时间一秒一秒的变化，做到时间准确，（有的说可以），但是我这边总是有时候会停止一段时间，然后在刷新，widget是有自己的刷新机制的，并不会按照要求刷新的那么快
于是换了思路（当然如果你的是时间包括显示秒的话这种是不行的，只能精确到分钟，秒动的话可以使用text 的timer）
let timeline = Timeline(entries: entries, policy: .after(entryDate))
这种方式
记录当前启动widget使距离整分剩余的秒数
let lastSecond = Int(currentDate.timeIntervalSince1970)%60
let intSecond :Int = 60 - lastSecond
这里填充20分钟的数据
for secondOffset in 0 ..< 20{
if secondOffset == 0{
/// 第一条用当前时间
let entry = SimpleEntry(date: currentDate, ...);
entries.append(entry)
}else if secondOffset == 1{
/// 第二条用剩余的秒数凑够一分钟
let entryDate = Calendar.current.date(byAdding: .second, value: intSecond , to: currentDate)!
let entry = SimpleEntry(date: entryDate, .....)
entries.append(entry)
} else{
/// 用当前时间 - 非整分钟 ，之后按整分钟数据添加
let entryDate = Calendar.current.date(byAdding: .minute, value: hourOffset, to: currentDate - TimeInterval(lastSecond))!
let entry = SimpleEntry(date: entryDate.....)
entries.append(entry)
}// 填充的数据不到20分钟，这里我用了15分钟之后再刷新
let entryDate = Calendar.current.date(byAdding: .minute, value: 15, to: currentDate)!
let timeline = Timeline(entries: entries, policy: .after(entryDate))}
