iOS小部件
1.前言
言引杰伦的一句歌词,“需求来的太快,就像龙卷风”。在国庆前一个星期,突然接到公司的通知,在国庆前上线一个小组件app。当时接到需求时的我是这样的

但是为了促进公司业务的发展以及维护iOS小分队的尊严,于是我开始了为时5天的iOS小组件学习开发及上线,anyway 只要有决心,铁杵磨成针。
2. Widget是什么?
总结的来说----Widget 的本质是一个随着时间线而更新的用 SwiftUI编写的一个 View。首先我们来创建一个Widget Extension。

我们来看一下,xcode为我们创建的相关代码,进行一一分析,来揭开小部件神秘的面纱。
//
// WidgetOne.swift
// WidgetOne
//
// Created by Bron on 2020/10/20.
//
import WidgetKit //系统引入的小部件库
import SwiftUI //UI编写及布局所需要的SwiftUI框架
struct Provider: TimelineProvider { //时间线或者时间轴提供者
func placeholder(in context: Context) -> SimpleEntry { //对于 widget 可以设置一个 placeholder方法, 作为 timeline 没准备好时的占位 view需要展示的数据。
SimpleEntry(date:Date())
}
func getSnapshot(in context:Context, completion:@escaping(SimpleEntry) -> ()) {//snapshot 的意思是快照,是在 Widget 库中展示的时候调用的,也就是会在Widget被添加的时候执行。
let entry =SimpleEntry(date:Date())
completion(entry)
}
func getTimeline(in context:Context, completion:@escaping(Timeline) -> ()) {//主要用于提供数据和控制数据的刷新,timeline通过Timeline(entries: entries, policy: .atEnd)刷新数据和控制下一步刷新时间
var entries: [SimpleEntry] = []
// Generate a timeline consisting of five entries an hour apart, starting from the current date.
let currentDate =Date()
for hourOffset in0..<5{
let entryDate =Calendar.current.date(byAdding: .hour, value: hourOffset, to: currentDate)!
let entry =SimpleEntry(date: entryDate)
entries.append(entry)
}
let timeline =Timeline(entries: entries, policy: .atEnd)
completion(timeline)
}
}
struct SimpleEntry: TimelineEntry {//这个SimpleEntry,SimpleEntry实现了TimelineEntry,主要用于保存Widget的数据我们可以把它理解成MVVM中的Model层,小老弟们,想想看,viewModel层应该是在哪里??
let date: Date//date,是系统固定的不可更改的时间
let model:BronModel, //可以添加自己需要的数据类型
}
//model层
struct BronModel {
var name:String
var age:Int
}
struct WidgetOneEntryView : View {//顾名思义这个是MVVM的View层了,是Widget的布局部分,是Widget的View的部分
var entry: Provider.Entry
var body: some View {
Text(entry.date, style: .time)
}
}
@main //这是Widget的入口,定义了Widget的Kind、Provider、View等
struct WidgetOne: Widget {
let kind: String = "WidgetOne" //可以理解成widget的标识
var body: some WidgetConfiguration {
StaticConfiguration(kind:kind, provider:Provider()) { entryin
WidgetOneEntryView(entry: entry)
}
.configurationDisplayName("My Widget")
.description("This is an example widget.")
}
}
struct WidgetOne_Previews: PreviewProvider {//Previews看这个名字就知道是预览的意思,可以达到类似前端编辑代码实时刷新网页的赶脚,但是感觉跟前端实时刷新的稳定性还是不在一个level,而且经常容易编译中断,毕竟实时刷新的原理不同。
static var previews: some View {
WidgetOneEntryView(entry: SimpleEntry(date: Date()))
.previewContext(WidgetPreviewContext(family: .systemSmall))
}
}