iOS 17 Beta8/Xcode15 Beta8：框架AppEnum用于WidgetConfigurationIntent参数报错

环境 #

• iOS 17 Beta 8
• Xcode 15 Beta 8

问题重现 #

主应用和扩展共享一个框架，框架内的AppEntities、AppEnum在主应用逻辑、普通Intent参数、快捷指令中都能正常使用，但将AppEnum作为WidgetConfigurationIntent的参数时，触发编译错误：

Unable to determine value type for type <AppEnum>

已确认：

• 已导入共享框架
• AppEnum已声明为public
• 尝试过AppIntentsPackage API，无效果
  临时方案是在扩展中重命名声明枚举，再转换为框架版本，但维护成本高、不够优雅。

解决方案 #

1. 给共享框架的枚举添加Intent相关协议与配置 #

确保框架内的AppEnum遵守IntentEnum、CaseIterable、Identifiable协议，并补充Intent所需的本地化配置，示例代码：

import AppIntents

public enum AppEnum: String, CaseIterable, Identifiable, IntentEnum {
    case optionA
    case optionB

    // 满足Identifiable协议要求
    public var id: String { rawValue }

    // Intent中显示的类型名称
    public static var typeDisplayName: LocalizedStringResource { "选项类型" }

    // 每个枚举case的显示名称
    public static var caseDisplayNames: [Self: LocalizedStringResource] {
        [.optionA: "选项A", .optionB: "选项B"]
    }
}

注意：IntentEnum是Xcode 15引入的宏协议，用于标记该类型可作为Intent参数，必须配合CaseIterable让系统枚举所有可选值。

2. 检查WidgetConfigurationIntent的参数声明 #

在Widget扩展的Intent定义中，确保正确导入共享框架，并声明参数类型为框架内的AppEnum：

import AppIntents
import YourSharedFrameworkName

struct WidgetConfigIntent: WidgetConfigurationIntent {
    static var title: LocalizedStringResource = "配置小组件"
    static var description = IntentDescription("设置小组件的显示选项")

    @Parameter(title: "选择选项")
    var selectedOption: AppEnum
}

3. 清理Xcode缓存并重新构建 #

Beta版本的Xcode容易出现缓存识别问题，执行以下操作：

• 按下Cmd + Shift + K清理构建缓存
• 关闭Xcode，重新打开项目
• 先构建共享框架，再构建Widget扩展

原理说明 #

WidgetConfigurationIntent对参数类型的识别逻辑比普通Intent更严格，Beta版Xcode在处理跨Target的枚举时，需要明确标记该类型符合Intent参数的规范（通过IntentEnum协议和相关配置），否则无法自动推断其值类型，导致编译错误。

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