iOS小部件基础学习

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

    }

}

最后编辑于 :
©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

友情链接更多精彩内容