iOS App Intent运行时参数依赖注入问题及解决方案咨询

我看了你遇到的这个App Intent运行时参数依赖不生效的问题，确实在App Intents的Entity Query里用@IntentParameterDependency很容易踩这个坑——它在快捷指令编辑阶段能正常拿到参数，但运行时就直接失效了，我来帮你理清楚原因和解决办法：

问题根源 #

@IntentParameterDependency的设计初衷是在快捷指令编辑阶段，辅助系统根据已选参数生成实体建议，它依赖的是编辑时的Intent上下文。但当快捷指令实际运行时，系统会单独初始化TripItineraryDayQueryDemo的实例，这个实例完全脱离了原PlanActivityIntentDemo的上下文，所以那些用@IntentParameterDependency修饰的tripEntity、intentTitle都会是nil，这就是你运行时拿不到选中Trip的根本原因。

解决方案 #

针对你的场景，我推荐两种可行的处理方案，优先选第一种，它能同时兼容编辑阶段和运行时：

方案1：重构实体ID，携带Trip标识（最可靠） #

核心思路是让日程日实体的ID包含Trip的唯一标识，这样不管是编辑阶段还是运行时，都能通过ID直接解析出关联的Trip，不需要依赖Intent的参数上下文。

1. 修改日程日实体的ID结构

更新ShortcutsItineraryDayEntityDemo，让它的ID由TripID-日程日唯一标识组成，同时保留必要的初始化方法：

struct ShortcutsItineraryDayEntityDemo: Identifiable, Hashable, AppEntity {
    typealias DefaultQuery = TripItineraryDayQueryDemo
    static var typeDisplayRepresentation: TypeDisplayRepresentation = "Trip Itinerary Day"
    
    var displayRepresentation: DisplayRepresentation {
        .init(title: "Trip Day") // 替换成你的实际显示逻辑，比如用日程日日期
    }
    
    // ID格式："tripId-dayUniqueId"，包含Trip和日程日的唯一标识
    let id: String
    let tripId: String // 单独存储Trip ID，方便后续处理
    
    // 用于生成实际的日程日实体
    init(tripId: String, dayUniqueId: String) {
        self.tripId = tripId
        self.id = "\(tripId)-\(dayUniqueId)"
    }
    
    // 系统默认初始化方法
    init() {
        self.tripId = UUID().uuidString
        self.id = UUID().uuidString
    }
    
    static var defaultQuery: DefaultQuery { TripItineraryDayQueryDemo() }
}

2. 重写Entity Query的实现

去掉@IntentParameterDependency，改为通过解析ID获取Trip，同时兼容编辑阶段的建议实体生成：

struct TripItineraryDayQueryDemo: EntityQuery {
    func entities(for identifiers: [ShortcutsItineraryDayEntityDemo.ID]) async throws -> [ShortcutsItineraryDayEntityDemo] {
        print("entities being called with identifiers: \(identifiers)")
        let tripsStore = TripsStore()
        var result = [ShortcutsItineraryDayEntityDemo]()
        
        for id in identifiers {
            // 拆分ID获取Trip ID和日程日标识
            let components = id.split(separator: "-")
            guard components.count == 2, 
                  let tripId = components.first, 
                  let dayId = components.last else {
                continue
            }
            
            // 从数据仓库获取对应Trip和日程日
            guard let trip = tripsStore.getTripById(String(tripId)),
                  let itineraryId = trip.firstItineraryId,
                  let itinerary = tripsStore.getItineraryById(itineraryId) else {
                continue
            }
            
            // 替换成你的实际日程日获取逻辑
            if let targetDay = itinerary.days.first(where: { 
                $0.id?.uuidString == dayId || $0.date.formatted() == dayId 
            }) {
                result.append(ShortcutsItineraryDayEntityDemo(
                    tripId: String(tripId), 
                    dayUniqueId: String(dayId)
                ))
            }
        }
        return result
    }
    
    func suggestedEntities() async throws -> [ShortcutsItineraryDayEntityDemo] {
        print("suggested itinerary days being called")
        // 编辑阶段通过环境变量获取Intent的参数依赖（仅iOS 17+支持）
        @Environment(\.intentParameterDependencies) var parameterDependencies
        let selectedTrip: ShortcutsTripEntity? = parameterDependencies.value(for: \PlanActivityIntentDemo.$tripEntity)
        
        guard let trip = selectedTrip?.trip,
              let itineraryId = trip.firstItineraryId,
              let itinerary = TripsStore().getItineraryById(itineraryId) else {
            return []
        }
        
        // 生成选中Trip下的所有日程日实体
        return itinerary.days.map { day in
            let dayId = day.id?.uuidString ?? day.date.formatted()
            return ShortcutsItineraryDayEntityDemo(tripId: trip.id.uuidString, dayUniqueId: dayId)
        }
    }
}

方案2：在Intent的perform方法中直接处理 #

如果你的场景不需要在运行时动态获取实体，仅需要用户在编辑阶段选择Trip和日程日，那么可以直接在PlanActivityIntentDemo的perform()方法中，用选中的Trip和日程日ID获取数据，绕开Entity Query的运行时依赖问题：

struct PlanActivityIntentDemo: AppIntent {
    static var title: LocalizedStringResource = "Plan Activity"
    static var description = IntentDescription("Plan an activity for a trip itinerary day.")
    
    @Parameter(title: "Trip")
    var tripEntity: ShortcutsTripEntity
    
    @Parameter(title: "Itinerary Day", entities: ShortcutsItineraryDayEntityDemo.self)
    var itineraryDayEntity: ShortcutsItineraryDayEntityDemo
    
    func perform() async throws -> some IntentResult {
        let tripsStore = TripsStore()
        guard let trip = tripEntity.trip,
              let itineraryId = trip.firstItineraryId,
              let itinerary = tripsStore.getItineraryById(itineraryId) else {
            return .result(dialog: "无法找到选中的行程或日程")
        }
        
        // 拆分日程日ID获取具体的日程日
        let components = itineraryDayEntity.id.split(separator: "-")
        guard components.count == 2, let dayId = components.last else {
            return .result(dialog: "无效的日程日选择")
        }
        
        guard let targetDay = itinerary.days.first(where: {
            $0.id?.uuidString == dayId || $0.date.formatted() == dayId
        }) else {
            return .result(dialog: "无法找到选中的日程日")
        }
        
        // 这里添加你的业务逻辑，比如创建活动
        return .result(dialog: "已为\(targetDay.date.formatted())规划活动")
    }
}

注意事项 #

• @IntentParameterDependency仅适用于快捷指令编辑阶段，不要依赖它在运行时传递参数；
• 实体ID最好包含所有必要的上下文信息（比如父实体ID），这样运行时能独立解析；
• iOS 17及以上支持通过@Environment(\.intentParameterDependencies)在suggestedEntities()中获取编辑阶段的Intent参数，兼容你的编辑场景。

内容来源于stack exchange