iOS14出来了有一段时间,小组件当仁不让火得不要不要的
一步步摸索下来,这里记录一下捣鼓widget时遇到的坑和要点
【新建小组件】
1、新建一个Objective-c项目
2、给项目添加一个小组件
此时项目已经可以进行编译运行
【小组件基础点】
系统自动生成了4个文件,分别是小组件代码文件,用户自定义配置小组件的配置文件,资源文件夹,以及info.plist配置文件
WidgetUI.swift 中包含了几个小组件的关键函数
1、可以理解成数据结构体,用来保存和传递数据
struct SimpleEntry: TimelineEntry {
let date: Date
let configuration: ConfigurationIntent
}
2、Provider:为小组件展示提供一切必要信息的结构体,里面有3个函数
struct Provider: IntentTimelineProvider {
func placeholder
func getSnapshot
func getTimeline
}
placeholder 提供一个默认的视图用于展示
getSnapshot 在小部件库中显示小部件,在组件的添加页面可以看到效果
getTimeline 可以理解成为一个时间线,是静态的,只能提前将时间线添加好,不能动态的改变和刷新
3、EntryView 小组件的样式视图
struct WidgetUIEntryView : View {
var entry: Provider.Entry
var body: some View {
Text(entry.date, style: .time)
}
}
4、小组件的一些配置
@main:代表着Widget的主入口,系统从这里加载
kind:小组件唯一标识
StaticConfiguration:初始化配置
configurationDisplayName:小组件库中展示的标题
description:小组件库中展示的描述
supportedFamilies:组件的样式,提供了小,中,大三个
@main
struct WidgetUI: Widget {
let kind: String = "WidgetUI"
var body: some WidgetConfiguration {
IntentConfiguration(kind: kind, intent: ConfigurationIntent.self, provider: Provider(){entry in
WidgetUIEntryView(entry: entry)
} .configurationDisplayName("My Widget") .description("This is an example widget.").supportedFamilies([.systemSmall,.systemMedium,.systemLarge])
}
}
5、添加多个小组件,也可以通过用户自定义配置来进行实现改变样式。
@main
struct YourWidgets: WidgetBundle {
var body: some Widget {
WidgetBundle1().body
WidgetBundle2().body
}
}
struct WidgetBundle1: WidgetBundle {
var body: some Widget {
XXXWidget()
XXXWidget()
}
}
struct WidgetBundle2: WidgetBundle {
var body: some Widget {
XXXWidget()
}
}