能否在App Intent的perform方法执行前通过构造器接收参数？

问题根源 #

WidgetConfigurationIntent的实例由系统负责初始化，只会调用空构造器，你自定义的带参构造器不会被系统触发。因此在perform执行时，手动通过自定义构造器设置的参数还未被赋值，自然是nil。

解决方案 #

方案1：使用系统Intent参数标记（@Parameter） #

这是符合WidgetConfigurationIntent设计规范的做法，通过@Parameter标记属性，让系统负责参数的传递与初始化：

import AppIntents

struct ConfigurationAppIntent: WidgetConfigurationIntent {
    static var title: LocalizedStringResource = "Configuration"
    static var description = IntentDescription("This is an example widget.")
    
    // 用@Parameter标记参数，系统会自动处理序列化与传递
    @Parameter(title: "自定义参数")
    var myParameter: MyCustomClass?
    
    // 仅保留系统要求的空构造器即可
    init() {}
    
    func perform() async throws -> some IntentResult {
        if let param = myParameter {
            // 正常使用参数执行操作
            print("执行操作，参数：\(param)")
        }
        return .result()
    }
}

// 自定义类必须遵循Codable协议，确保系统能序列化传递
struct MyCustomClass: Codable {
    // 你的类属性，例如：
    var id: String
    var value: Int
}

方案2：通过状态存储获取参数（适用于非用户配置的内部数据） #

如果参数是App内部的状态，而非用户在Widget配置界面输入的内容，可直接在perform方法中读取状态存储（如UserDefaults、AppStorage）：

import AppIntents
import SwiftUI

struct ConfigurationAppIntent: WidgetConfigurationIntent {
    static var title: LocalizedStringResource = "Configuration"
    static var description = IntentDescription("This is an example widget.")
    
    init() {}
    
    func perform() async throws -> some IntentResult {
        // 方式1：使用UserDefaults
        if let savedParam = UserDefaults.standard.object(forKey: "myCustomParam") as? Data {
            let param = try? JSONDecoder().decode(MyCustomClass.self, from: savedParam)
            print("读取到参数：\(param)")
        }
        
        // 方式2：使用AppStorage（需在可访问的上下文）
        @AppStorage("myCustomParam") var storedParam: Data?
        if let data = storedParam {
            let param = try? JSONDecoder().decode(MyCustomClass.self, from: data)
            print("读取到参数：\(param)")
        }
        
        return .result()
    }
}

struct MyCustomClass: Codable {
    var id: String
    var value: Int
}

关键说明 #

• 不要试图通过自定义构造器给Intent传参，系统不会调用这些构造器，只会使用空构造器初始化实例。
• 若参数需要通过Widget配置界面传递，必须用@Parameter标记，并确保参数类型遵循Codable协议。
• 内部状态类的参数，直接在perform方法中读取存储即可，无需依赖构造器赋值。

内容的提问来源于stack exchange，提问作者izmatlDev