创建主工程就不必讲了
1 创建小组件
创建子工程 [new Target ] 选择 [ Widger Extension]
小组件入口是WidgetBundle文件,可以进行多个小组件的调试
TestWidget2文件是主要操作,小组件使用swiftUI布局,使用 AppIntent进行事件处理,TestDataUserDefalut 用的userdefault 和主程序数据同步,下面详细讲解
//
// TestWidget2.swift
// TestSwift6Demo
//
// Created by ITHPNB04296 on 11/3/25.
//import WidgetKit
import SwiftUI
import AppIntentsstruct TestWidget2:Widget{let kind:String = "TestWidget2"var body: some WidgetConfiguration{StaticConfiguration(kind: kind, provider: MyWidget2Provider()) {entry inTestWidget2View(entry: entry ,ganmeStatus: entry.state).containerBackground(for: ContainerBackgroundPlacement.widget) {//背景色Color.yellow}}.configurationDisplayName("TestWidget2").description("show Testwidget2").supportedFamilies([.systemMedium])}}struct TestWidget2View:View {var entry: MyWidget2Provider.Entry(\.widgetFamily) var family:WidgetFamilyvar ganmeStatus:Test2State
// var selectedCharacter:CharacterDetailvar body: some View {VStack{Text("\(ganmeStatus.date.description)")Button("\(ganmeStatus.state)") {print("点击按钮1 直接就跳转到主APP了")}if entry.running{createRunningView()}else{createStaticView()}}}func createRunningView()->some View{//点击一次更新了一次return VStack{Button("点击按钮2", intent: Test2Intent())//该Text 无法设置停止时间
// Text(entry.date, style: Text.DateStyle.timer)
// .font(Font.system(size: 15.0))
// .fontWeight(.bold)
// .multilineTextAlignment(.center)
// .contentTransition(.numericText(countsDown: entry.state.duration > 0))//新Text样式,可以设置停止时间Text(timerInterval: entry.daterange,pauseTime: entry.pauseTime,countsDown: entry.countsDown,showsHours: entry.showsHours)}}func createStaticView()->some View{return VStack{Button("点击按钮2", intent: Test2Intent())Text(entry.date, style: Text.DateStyle.date).font(Font.system(size: 15.0)).fontWeight(.bold).multilineTextAlignment(.center)//过渡动画 countsDown 参数用来控制是否向下滚动.contentTransition(.numericText(countsDown: entry.state.duration > 0))}}
}//添加按钮点击事件行为
struct Test2Intent:AppIntent{static var title: LocalizedStringResource = "XXX"//点击事件函数是异步的可以做一些耗时操作,比如网络请求等func perform() async throws -> some IntentResult {//也可以通过App group 和主程序共享数据//点击事件更新let isrunning = TestDataUserDefalut().get()TestDataUserDefalut().set(!isrunning)return .result()}
}struct Test2State{var state:Stringvar date:Date{return Date()}var duration:Int = 10}struct MyWidget2Entry:TimelineEntry{var date: Date//默认区间是0var daterange:ClosedRange<Date> = Date()...Date()//默认没有开启var running:Bool {//添加状态控制return TestDataUserDefalut().get()}/// The relevance of a widget’s content to the user.var relevance: TimelineEntryRelevance?//添加适配新的TimerText//停止时间var pauseTime: Date = Date()//倒计时var countsDown = falsevar showsHours = true//携带其他额外数据var state:Test2State
}struct MyWidget2Provider: TimelineProvider{//没有数据时候占位,仅初始化时候调用一次,数据没加载上来时候,添加占位数据func placeholder(in context: Context) -> MyWidget2Entry {return MyWidget2Entry(date: Date(), state: Test2State(state: "init"))}//生成预览照,给系统组件库使用func getSnapshot(in context: Context, completion: (MyWidget2Entry) -> Void) {let date = Date()let entry:MyWidget2Entryprint("getSnapshot")entry = MyWidget2Entry(date: date, state: Test2State(state:"perview"))completion(entry)}//实时更新时间线,每次点击按钮时候调用两次 ? 调用两次没理解func getTimeline(in context: Context, completion: (Timeline<MyWidget2Entry>) -> Void) {let date = Date()let endtime:Date = Calendar.current.date(byAdding: .minute, value: 10, to: date)!let entry = MyWidget2Entry(date: date, daterange: date...endtime,countsDown: true, state: Test2State(state:"start"))//下一次更新时候let nextUpdateDate = Calendar.current.date(byAdding: .second, value: 1, to: date)!//时间线,\/*atend -当时间线中的所有条目都已显示完毕后,才会重新加载时间线。固定时间点加载,比如天气never - 不会自动刷新小组件内容,只有主app主动去刷新数据after(Date) - 指定一个未来的日期和时间*/let timeline = Timeline(entries: [entry], policy: TimelineReloadPolicy.after(nextUpdateDate))print("时间线方法1更新了 ")completion(timeline)}}//更新共享数据
struct TestDataUserDefalut{func get()->Bool{let sharedDefaults = UserDefaults(suiteName: "group.testwidget1.demo")let isrunning = sharedDefaults?.value(forKey: "sharedRunning") as? Bool ?? falsereturn isrunning}func set(_ state:Bool){let sharedDefaults = UserDefaults(suiteName: "group.testwidget1.demo")sharedDefaults?.set(state, forKey: "sharedRunning")sharedDefaults?.synchronize()}
}
小组件和主工程进行数据同步,也就是进程间通信
配置 App Groups
1. 打开 Xcode,选择你的主 App 目标(Target)。
2. 在 Signing & Capabilities 中,点击 + Capability。
3. 搜索 App Groups 并添加。
4. 创建一个新的 App Group(如 group.com.yourcompany.shared)。
5. 在 Widget Extension / App Clips 目标中重复上述步骤,选择相同的 App Group。
我的demo使用plist文件也就是userdefault 同步数据当然也可以使用数据库同步数据,我看同事使用SwiftData(ios 17之后才能使用)同步数据 swiftData官方文档 ,我选择的appgroup 名字是 “group.testwidget1.demo”,这个不是包名,TestWidget2 里面的 TestDataUserDefalut 就是小程序同步数据代码,下面看一下主程序App同步代码,添加包括刷新通知等,讲解比较详细
class ViewController: UIViewController {lazy var stateLab:UILabel = {let size = UIScreen.main.bounds.sizelet labwidth = 100.0let labheight = 50.0let lab = UILabel(frame: CGRectMake((size.width - labwidth) / 2.0, (size.height - labheight) / 2.0, labwidth, labheight))view.addSubview(lab)lab.backgroundColor = UIColor.greenlab.font = UIFont.systemFont(ofSize: 28)lab.textColor = UIColor.redlab.textAlignment = .centerreturn lab}()func updateState(_ state:Bool){DispatchQueue.main.async {self.stateLab.text = state ? "打开" : "关闭"}}func addTest(){/*配置 App Groups1. 打开 Xcode,选择你的主 App 目标(Target)。2. 在 Signing & Capabilities 中,点击 + Capability。3. 搜索 App Groups 并添加。4. 创建一个新的 App Group(如 group.com.yourcompany.shared)。5. 在 Widget Extension / App Clips 目标中重复上述步骤,选择相同的 App Group。*/let appGroup = "group.testwidget1.demo"let sharedDefaults = UserDefaults(suiteName: appGroup)let isrunning = sharedDefaults?.value(forKey: "sharedRunning") as? Bool ?? falseupdateState(isrunning)}override func touchesBegan(_ touches: Set<UITouch>, with event: UIEvent?) {super.touchesBegan(touches, with: event)let sharedDefaults = UserDefaults(suiteName: "group.testwidget1.demo")let isrunning = sharedDefaults?.value(forKey: "sharedRunning") as? Bool ?? falsesharedDefaults?.set(!isrunning, forKey: "sharedRunning")print("\(!isrunning)")updateState(!isrunning)//通知小组件刷新notifiUpdateWidget()}func notifiUpdateWidget(){//通知小组件刷新,刷新所有小组件WidgetCenter.shared.reloadAllTimelines()//刷新指定的小组件,小组件那边注册的kind
// WidgetCenter.shared.reloadTimelines(ofKind: "TestWidget1")//获取配置去刷新小组件
// WidgetCenter.shared.getCurrentConfigurations { result in
// guard case .success(let success) = result else {
// return
// }
//
if let widget = success.first(
where:{ widget in
let intent = widget.configuration as ConfigurationAppIntent
return intent?.character == ""
}
){
WidgetCenter.shared.reloadTimelines(ofKind: widget.kind)
}
// }}override func viewDidLoad() {super.viewDidLoad()addTest()}}
苹果官方小组件文档
苹果官方swiftUI文档