【iOS14】仿网易云桌面小组件(一)

随着iOS14的发布,WidgetKit也应运而生,替换了以前的Today Extension,各大APP也都开始适配iOS14,为APP增加桌面小组件,最近发现网易云也增加了桌面小组件的功能,觉得还不错,就模仿着写一下。

看完本篇文章后你将学会以下几点:
1、创建WidgetExtension,运行系统默认小组件
2、使用SwiftUI搭建小组件界面,并实时预览效果
3、实现如下效果的小组件

网易云【小】

1、创建WidgetExtension

在Xcode项目中点击File->New->Target,搜索Widget,选中Widget Extension

widget创建

点击Next,输入名称,这里用GKWYWidget
widget创建

这里的Include Configuration Intent是为小组件增加可编辑功能,如果勾选上长按小组件就会出现编辑小组件的选项,这里暂时不勾选。然后点击Finish,小组件就创建完成了。
运行项目,就可以看到系统默认为我们创建的小组件
默认小组件

2、使用SwiftUI搭建小组件界面

右键GKWYWidget,创建SwiftUI View文件,命名为GKWYWidgetView,这时候点击右边的预览会出现缺少previewContext,这里我们用小组件的方式预览,导入WidgetKit,import WidgetKit,然后加入WidgetPreviewContext,如下

struct GKWYWidgetView_Previews: PreviewProvider {
    static var previews: some View {
        GKWYWidgetView()
            .previewContext(WidgetPreviewContext(family: .systemSmall))
    }
}

这时候点击预览就会出现下面的效果:


hello world preview

下面开始搭建界面,修改GKWYWidgetView为以下代码:

struct GKWYWidgetView: View {
    var body: some View {
        // 通过GeometryReader获取view的尺寸
        GeometryReader { geo in
            ZStack(alignment: .bottomLeading) {
                // 添加背景图
                Image("background")
                    .resizable()
                // 添加阴影
                LinearGradient(gradient: Gradient(colors: [Color.black.opacity(0.15), Color.black.opacity(0.35)]), startPoint: .top, endPoint: .bottom)
                // 添加logo
                Image("cm2_clock_logo")
                    .resizable()
                    .scaledToFill()
                    .frame(width: 20, height: 20)
                    .position(x: geo.size.width - (20/2) - 10, y: (20/2) + 10)
                    .ignoresSafeArea(.all)
                // 添加左下角的图标及文字
                VStack(alignment: .leading, spacing: 5) {
                    HStack() {
                        Image("cm4_disc_type_list")
                            .resizable()
                            .frame(width: 20, height: 20)
                        Text("私人雷达")
                            .font(.system(size: 16))
                            .foregroundColor(.white)
                    }
                    
                    Text("探索另类音乐宝藏")
                        .font(.system(size: 14))
                        .foregroundColor(.white)
                }.padding()
            }
        }
    }
}

然后点击右边的预览,效果图如下:


小组件预览

到这里,通过SwiftUI创建小组件界面就已经完成了。

3、实现小组件

上面代码已经写好,要实现小组件就很简单了,只需要把GKWYWidget里面的GKWYWidgetEntryView修改为下面的即可

struct GKWYWidgetEntryView : View {
    var entry: Provider.Entry

    var body: some View {
        GKWYWidgetView()
    }
}

然后运行项目,小组件就可以显示出来了,如下:


小组件

下面简单介绍下系统widget里面的类

Provider

Provider:为小组件展示提供一切必要信息的结构体,实现TimelineProvider协议,需要实现三个方法,
placeholder:提供一个默认的视图,当网络数据请求失败或者其他一些异常的时候,用于展示
getSnapshot:为了在小部件库中显示小部件,WidgetKit要求提供者提供预览快照,在组件的添加页面可以看到效果
getTimeline:在这个方法内可以进行网络请求,拿到的数据保存在对应的entry中,调用completion之后会到刷新小组件

SimpleEntry

实现TimelineEntry协议,就是用来保存所需要的数据

GKWYWidgetEntryView

这个结构体就是我们需要用来展示的视图View,这里可以进行各种界面搭建

GKWYWidget

@main:代表着Widget的主入口,系统从这里加载
kind:是Widget的唯一标识
StaticConfiguration:初始化配置代码
configurationDisplayName:添加编辑界面展示的标题
description:添加编辑界面展示的描述内容
supportedFamilies这里可以限制要提供三个样式中的哪几个

GKWYWidget_Previews

小组件的预览结构体,实现PreviewProvider协议,在这里可以实现快速预览小组件的效果
WidgetPreviewContext:可实时预览小组件的结构体,支持三种样式的小组件效果

最后

到这里,网易云小组件的简单搭建就完成了,后面将会为你介绍通过网络请求来获取数据,显示不同内容。
---敬请期待

参考资料
iOS14 Widget小组件开发实践1——了解Widget
网易云音乐 iOS 14 小组件实战手册

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,772评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,458评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,610评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,640评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,657评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,590评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,962评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,631评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,870评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,611评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,704评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,386评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,969评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,944评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,179评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,742评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,440评论 2 342

推荐阅读更多精彩内容