在Objective-C 项目中创建iOS小组件

iOS14出来了有一段时间，小组件当仁不让火得不要不要的

一步步摸索下来，这里记录一下捣鼓widget时遇到的坑和要点

【新建小组件】

1、新建一个Objective-c项目

2、给项目添加一个小组件

勾选Include Congifuration Intent选项，允许用户进行配置

此时项目已经可以进行编译运行

【小组件基础点】

系统自动生成了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() 

      }

}