IOS小组件（4-2）：创建可配置小组件（动态修改配置数据）

引言

  上一篇文章，讲解了如果通过配置修改小组件行为，只不过配置数据是写死的，本文将继续探索配置数据的高级用法，配置数据在小组件中动态创建的

大纲

• 在项目中添加”Intents Extension“
• 在 xxx.intentdefinition文件中增加一个动态类型
• 实现  Intent Handler 提供动态配置数据

在项目中添加”Intens Extension“

  要实现动态修改配置数据，需要向应用程序添加一个"Intens Extension"。当用户编辑窗口小部件时，WidgetKit会加载"Intens Extension"以提供动态信息。要添加"Intens Extension"，请执行以下操作：

1. 选择“File”>“New”>“Target”，然后选择"Intens Extension"。
   
2. 点击"Next"。
3. 输入Intent Extension的名称(这里我们设置为DynamicTimer)，并将"Starting Point"设置为None。
   
4. 单击完成。如果Xcode提示您有关激活"new scheme"信息，请单击“Activate”。
5. 在新Target的属性的“Gneral”选项卡中，在“Supported Intents”部分中添加一个条目，并将“Class Name”设置为 "TimeTypeConfigurationIntent". Xcode会自动把xxx.intentdefinition中的配置转为代码，放到这个文件中。
   
   如果不设置这项，也会自动生成，这个名字怎么来的呢？就是CUSTOM INTENTS中的名字后面加个Intent
   
6. 在项目导航器中，选择之前添加的自定义 intent definition 文件。
7. 右键选择”Show File Inspector“，将”“intent definition”文件添加到前新建的Target中。
   

在 xxx.intentdefinition文件中增加一个动态类型

  上一篇文章中，我们使用的静态类型（枚举）来实现修改Timer类型。要支持动态修改，则需要使用动态类型。创建步骤如下

1. 从“类型”弹出菜单中，选择“New Type”。Xcode在编辑器的“TYPES”中添加了一个新类型。
2. 将类型的名称更改为 "DynamicTimeType"
   
3. 添加一个新属性“dynamicTime”，然后Type选择“String”。
   
4. 在CUSTOM INTENTS中选择 TimeTypeConfiguration
5. 新增一个动态参数 dynamicTimeType
6. 在 Intent 编辑器中，选中“Dynamic Options”复选框，表示代码将为此参数提供了动态的选项列表。
   

实现  Intent Handler 提供动态配置数据

  经过上面的步骤，我们准备好了所有的配置信息，这时候我们编译一下项目，Xcode会根据xxx.intentdefinition文件生成对应的代码。接下来我们要修改DynamicTimer这个Target中的IntentHandler.swift中的代码。修改过的代码如下：

//
//  IntentHandler.swift
//  DynamicTimer
//

import Intents

// TimeTypeConfigurationIntentHandling 这个类在
// TimeTypeConfigurationIntent.swift文件中，这个文件是Xcode生成的。
// 这个文件名怎么来的？ =>
// Target的属性的“Gneral”选项卡中，在“Supported Intents”部分中添加一个条目，
// 并将“Class Name”设置为 "TimeTypeConfigurationIntent".
// Xcode会自动把xxx.intentdefinition中的配置转为代码，放到这个文件中。
class IntentHandler: INExtension, TimeTypeConfigurationIntentHandling {
    func provideDynamicTimeTypeOptionsCollection(
        for intent: TimeTypeConfigurationIntent,
        with completion: @escaping (INObjectCollection<DynamicTimeType>?, Error?) -> Void) {
        
        let time = DynamicTimeType(identifier: "time", display: "时间")
        time.dynamicTime = "time"
        let date = DynamicTimeType(identifier: "date", display: "时期")
        date.dynamicTime = "date"
        let timer = DynamicTimeType(identifier: "timer", display: "计时器")
        timer.dynamicTime = "timer"
        let allTimeType = [
            time, date, timer
        ]
        // 生成一个数组，把数据通过回调方法传出去
        completion(INObjectCollection(items: allTimeType), nil)
    }
    
    override func handler(for intent: INIntent) -> Any {
        // This is the default implementation.  If you want different objects to handle different intents,
        // you can override this and return the handler you want for that particular intent.
        return self
    }    
}

运行效果，从桌面点击组件，右键编辑小组件

目前选择之后还没生效，因为我们布局里面还没有使用这个值，接下来就修改代码，获取这个值，根据这个值动态改变时间类型。

//
//  WidgetConfigIntent.swift
//  WidgetConfigIntent
//

import WidgetKit
import SwiftUI
import Intents

struct Provider: IntentTimelineProvider {
    func placeholder(in context: Context) -> SimpleEntry {
        // 不同点3：传递默认参数
        SimpleEntry(date: Date(), configuration: TimeTypeConfigurationIntent())
    }

    // 不同点4：比使用StaticConfiguration时多了一个配置参数
    func getSnapshot(for configuration: TimeTypeConfigurationIntent, in context: Context, completion: @escaping (SimpleEntry) -> ()) {
        let entry = SimpleEntry(date: Date(), configuration: configuration)
        completion(entry)
    }

    // 不同点5：比使用StaticConfiguration时多了一个配置参数
    func getTimeline(for configuration: TimeTypeConfigurationIntent, in context: Context, completion: @escaping (Timeline<Entry>) -> ()) {
        var entries: [SimpleEntry] = []

        // Generate a timeline consisting of five entries an hour apart, starting from the current date.
        let currentDate = Date()
        for hourOffset in 0 ..< 5 {
            let entryDate = Calendar.current.date(byAdding: .hour, value: hourOffset, to: currentDate)!
            let entry = SimpleEntry(date: entryDate, configuration: configuration)
            entries.append(entry)
        }

        let timeline = Timeline(entries: entries, policy: .atEnd)
        completion(timeline)
    }
}

struct SimpleEntry: TimelineEntry {
    let date: Date
    // 不同点2： 多了一个配置参数，小组件编辑界面设置参数会通过这个传递进来
    let configuration: TimeTypeConfigurationIntent
}

struct WidgetConfigIntentEntryView : View {
    var entry: Provider.Entry

    var body: some View {
        // 根据静态配置信息动态改变布局
//        if (entry.configuration.timeType == TimeTypeEnum.time) {
//            Text(entry.date, style: .time)
//        } else {
//            Text(entry.date, style: .date)
//        }
        // 根据动态配置信息动态改变布局
        if (entry.configuration.dynamicTimeType?.dynamicTime == "time") {
            Text(entry.date, style: .time)
        } else if (entry.configuration.dynamicTimeType?.dynamicTime == "timer") {
            Text(entry.date, style: .timer)
                .multilineTextAlignment(.center)
        } else {
            Text(entry.date, style: .date)
        }
    }
}

// 小组件入口
@main
struct WidgetConfigIntent: Widget {
    let kind: String = "WidgetConfigIntent"

    var body: some WidgetConfiguration {
        //不同点1： 这里使用 IntentConfiguration， 对比 StaticConfiguration，这里还多了一个参数 intent: ConfigurationIntent.self
        IntentConfiguration(kind: kind, intent: TimeTypeConfigurationIntent.self, provider: Provider()) { entry in
            WidgetConfigIntentEntryView(entry: entry)
        }
        .configurationDisplayName("可配置小组件")
        .description("选择不同的时间类型")
    }
}

// Debug调试代码
struct WidgetConfigIntent_Previews: PreviewProvider {
    static var previews: some View {
        WidgetConfigIntentEntryView(entry: SimpleEntry(date: Date(), configuration: TimeTypeConfigurationIntent()))
            .previewContext(WidgetPreviewContext(family: .systemSmall))
    }
}

运行效果
选择计时器

选择时间

选择日期

结语

  本文内容讲解了如何动态修改配置数据，重点就是配置xxx.intentdefinition文件，一定要自己亲自操作一次，不然不容易理解配置是怎么跟代码对应起来的。