如何通过EntityPropertyQuery实现按关联实体属性搜索App实体？

嘿，我完全懂你现在的困扰——想用EntityPropertyQuery让用户通过关联实体的属性来搜索主实体，结果写代码的时候碰到语法错误对吧？我之前做类似功能的时候也踩过这个坑，咱们一步步把它捋顺。

首先，先明确你的实体关系：CJPersonAppEntity 有一个关联属性 emails，对应多个 CJEmailAppEntity，而你要让用户通过 CJEmailAppEntity 的 emailAddress 来找到对应的 CJPersonAppEntity。你之前的代码问题在于，直接把关联实体的属性当成了顶层的 Property 参数，这不符合 EntityPropertyQuery 的语法逻辑。

正确的做法是嵌套定义Property：先声明主实体的关联属性，再在它的闭包里定义关联实体的目标属性。下面是修正后的完整代码示例：

import CoreData
import AppIntents

// 先确认你的实体定义（示例）
class CJPersonAppEntity: NSManagedObject, AppEntity {
    @NSManaged var name: String?
    @NSManaged var emails: Set<CJEmailAppEntity>
    // 其他属性...
    
    // 实现AppEntity的必要方法，比如displayString等
    static var typeDisplayRepresentation = TypeDisplayRepresentation(name: "Person")
    var displayRepresentation: DisplayRepresentation {
        DisplayRepresentation(title: "\(name ?? "Unknown Person")")
    }
}

class CJEmailAppEntity: NSManagedObject, AppEntity {
    @NSManaged var emailAddress: String?
    @NSManaged var person: CJPersonAppEntity?
    // 其他属性...
    
    static var typeDisplayRepresentation = TypeDisplayRepresentation(name: "Email")
    var displayRepresentation: DisplayRepresentation {
        DisplayRepresentation(title: "\(emailAddress ?? "Unknown Email")")
    }
}

// 修正后的Query实现
struct CJPersonAppEntityQuery: EntityPropertyQuery, EntityStringQuery {
    static var properties = QueryProperties {
        // 主实体的直接属性（比如姓名，可选）
        Property(\.name)
        
        // 关联实体属性的定义：先指向主实体的关联属性，再嵌套子实体的目标属性
        Property(\.emails) {
            Property(\.emailAddress)
        }
    }
    
    // 如果需要支持全局字符串搜索，指定默认搜索的属性
    static var defaultQueryProperties: [QueryProperty] {
        [properties.name, properties.emails.emailAddress]
    }
    
    // 实现EntityPropertyQuery的必要方法（示例）
    func entities(matching properties: QueryPropertyMatchers<CJPersonAppEntity>) async throws -> [CJPersonAppEntity] {
        // 这里写你的Core Data查询逻辑，根据匹配的属性过滤Person实体
        // 比如根据emailAddress匹配的话，查询关联的emails中包含对应地址的Person
        let fetchRequest: NSFetchRequest<CJPersonAppEntity> = CJPersonAppEntity.fetchRequest()
        if let emailMatch = properties[\.emails.emailAddress]?.stringValue {
            fetchRequest.predicate = NSPredicate(format: "ANY emails.emailAddress CONTAINS[cd] %@", emailMatch)
        }
        // 其他属性的匹配逻辑...
        return try await PersistenceController.shared.container.viewContext.fetch(fetchRequest)
    }
    
    // 实现EntityStringQuery的必要方法（如果需要）
    func entities(matching string: String) async throws -> [CJPersonAppEntity] {
        let fetchRequest: NSFetchRequest<CJPersonAppEntity> = CJPersonAppEntity.fetchRequest()
        fetchRequest.predicate = NSPredicate(format: "name CONTAINS[cd] %@ OR ANY emails.emailAddress CONTAINS[cd] %@", string, string)
        return try await PersistenceController.shared.container.viewContext.fetch(fetchRequest)
    }
}

我来给你拆解关键部分：

• 顶层的 Property(\.emails) 告诉系统：我们要基于 CJPersonAppEntity 的 emails 关联属性来拓展搜索条件。
• 嵌套的 Property(\.emailAddress) 则指定了关联实体 CJEmailAppEntity 中的具体属性，这样Shortcuts就能识别出“邮箱地址”这个搜索选项。
• 在 entities(matching:) 方法里，你需要用Core Data的谓词来实现实际的过滤逻辑，比如用 ANY emails.emailAddress 来匹配多对多关联中的属性。

另外，如果你一定要用带 entityProvider 的初始化器（比如关联是一对一的情况），语法应该是这样的：

// 假设是一对一关联，比如person有一个primaryEmail属性
Property(\CJEmailAppEntity.$emailAddress, entityProvider: { person in
    person.primaryEmail // 这里返回单个CJEmailAppEntity实例，而不是集合
})

但你的场景是一对多（一个Person对应多个Email），所以用嵌套Property的方式更合适。

这样设置之后，用户在Shortcuts里就能选择“邮箱地址”作为搜索条件，输入对应邮箱后就能找到匹配的Person实体啦。

备注：内容来源于stack exchange，提问作者Z S