在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() 

      }

}

你可能感兴趣的:(在Objective-C 项目中创建iOS小组件)