iOS 小组件开发第三篇:实战

这里每天分享一个 iOS 的新知识,快来关注我吧

前言

iOS 小组件开发第一篇:基础介绍

iOS 小组件开发第二篇:时间线

前两天讲了小组件的基础内容,今天准备带大家写一个非常简单的小组件项目。

先说下需求,实现一个可以展示上午、下午、夜里三种状态的小组件,分别用三个不同的图标来显示。

按照上述需求,我们简单地把这个小组件的时间线描述出来,有 3 个阶段:

  1. 早上 8 点到中午 12 点为上午

  2. 中午 12 点到下午 6 点为下午

  3. 下午 6 点到早上 8 点为夜里

TimelineEntry

昨天的文章提到,TimelineEntry 是用来提供小组件显示内容和时间的,那么我们需要先写一个展示时间状态的枚举,用来表示上午、下午和晚上,然后在 SimpleEntry 中声明这个属性:

csharp 复制代码
struct SimpleEntry: TimelineEntry {
    enum Time {
        case morning, afternoon, night
    }
    
    let date: Date
    // 表示上午、下午、晚上
    let time: Time
}

Provider

然后是 Provider 的实现,placeholder 方法中直接返回一个固定的 Entry:

less 复制代码
func placeholder(in context: Context) -> SimpleEntry {
    SimpleEntry(date: Date(), time: .morning)
}

然后是 getSnapshot 方法,这里依然返回一个固定的 morning:

less 复制代码
func getSnapshot(in context: Context, completion: @escaping (SimpleEntry) -> ()) {
    let entry = SimpleEntry(date: Date(), time: .morning)
    completion(entry)
}

然后在运行程序,在组件库中就可以看到这个预览了:

最后是最重要的 getTimeline 方法,我们需要在这里把时间线给到系统,我的思路是,先拿到当前时间,判断是上午、下午还是晚上,如果是上午,则添加上午、下午、和晚上的时间条目。如果当前是下午,则添加下午和晚上的时间条目,如果是晚上,则只添加晚上的时间线条目。

首先写个方法来获取指定小时的时间,这个方法传入小时,返回当天这个小时的时间:

sql 复制代码
func getDate(in hour: Int) -> Date {
    let calendar = Calendar.current
    var components = calendar.dateComponents([.year, .month, .day], from: Date())
    components.hour = hour
    components.minute = 0
    components.second = 0

    return calendar.date(from: components)!
}

然后写具体的时间线条目的代码:

less 复制代码
func getTimeline(in context: Context, completion: @escaping (Timeline<Entry>) -> ()) {
    var entries: [SimpleEntry] = []
    
    let hour = Calendar.current.component(.hour, from: Date())
    
    switch hour {
    case 8..<12:
        entries.append(SimpleEntry(date: Date(), time: .morning))
        entries.append(SimpleEntry(date: getDate(in: 12), time: .afternoon))
        entries.append(SimpleEntry(date: getDate(in: 18), time: .night))

    case 12..<18:
        entries.append(SimpleEntry(date: Date(), time: .afternoon))
        entries.append(SimpleEntry(date: getDate(in: 18), time: .night))

    default:
        entries.append(SimpleEntry(date: Date(), time: .night))
    }
    
    let timeline = Timeline(entries: entries, policy: .atEnd)
    completion(timeline)
}

UI 渲染

为了能够正常显示文案和图标,我给 Time 枚举做了扩展,为不同的 case 返回不同的图标和标题:

swift 复制代码
extension SimpleEntry.Time {
    var text: String {
        switch self {
        case .morning:
            return "上午"
        case .afternoon:
            return "下午"
        case .night:
            return "晚上"
        }
    }
    
    var icon: String {
        switch self {
        case .morning:
            return "sunrise"
        case .afternoon:
            return "sun.max.fill"
        case .night:
            return "sunset"
        }
    }
}

最后是 SwiftUI 渲染代码,我用一个 VStack 包裹外层,里边先是一个图标,然后是个 HStack 来展示文本内容:

scss 复制代码
struct MyWidgetEntryView : View {
    var entry: Provider.Entry
    var body: some View {
        VStack(spacing: 10) {
            Image(systemName: entry.time.icon)
                .imageScale(.large)
                .fontWeight(.medium)
                .foregroundColor(.red)
            HStack {
                Text("现在是:")
                Text(entry.time.text)
            }
            .font(.subheadline)
        }
    }
}

其他部分的代码不需要改动,保持创建工程时的状态即可。

看下效果

这样,我们的小组件就完成了:

明天继续讲小组件!

这里每天分享一个 iOS 的新知识,快来关注我吧

本文同步自微信公众号 "iOS新知",每天准时分享一个新知识,这里只是同步,想要及时学到就来关注我吧!

相关推荐
布莱克6054 小时前
Swift 字符串详解:从基础用法到性能与最佳实践
服务器·开发语言·ssh·字符串·swift
茶底世界之下4 小时前
雾中山路的冷光层次:用 Awaking 留住红色背影
ios·app·产品
Digitally5 小时前
iPhone 如何添加日历?
ios·iphone
Gracker19 小时前
100 Years Life:把体检、睡眠和运动放进同一份健康档案
ios
ShineWinsu1 天前
对于Qt:QTreeWidget常见属性以及QTreeWidgetItem类的解析
开发语言·c++·qt·gui·客户端·多叉树·qtreewidget
秋雨梧桐叶落莳1 天前
【iOS】Block底层详解
macos·ios·cocoa
布莱克6051 天前
Swift 条件语句详解:从 if 到 switch 的完整指南
开发语言·ssh·swift·switch·条件语句·guard·if
茶底世界之下1 天前
舞台灯下的萨克斯:用 Awaking 让铜管从蓝幕前亮起来
ios·app·产品
传奇开心果编程1 天前
【Flutter踩坑排雷】第28课:平台目录缺失与修复坑|`flutter create` 的“重建”与“覆盖”边界
android·flutter·ios·移动开发·跨平台·dart·声明式ui
3095566661 天前
股票接口返回 404 与空数组的排查笔记:证书状态与级别参数
java·笔记·python·ios·iphone·股票数据api·股票数据接口