如何为Core Data取数的小组件实现深度链接？

你遇到的编译报错、深度链接不生效的问题，来自两个核心问题：

1. 代码引用错误：你在Link(destination:)里写的project.url，其中project是@FetchRequest返回的所有项目的集合数组，既不是随机选中的单个项目，集合本身也没有url成员，完全是对象引用的位置写错了。
2. 认知偏差：深度链接不需要给Core Data的Project实体额外存储url字段，只需要基于项目的唯一标识生成系统可识别的自定义URL，主App接收到URL后解析标识、路由到对应页面即可。

1. 定义全局深度路由规则 #

不需要修改Core Data模型，只要约定一套主App和小组件共用的URL生成规则即可，把这套规则放到主App和小组件target都能访问的共享文件里：

enum AppDeepLink {
    // 替换为你自己App专属的URL scheme，避免和其他应用冲突
    static let scheme = "your-app-scheme"
    static let projectDetailHost = "project-detail"
}

注意：这套自定义scheme必须在主App的Target信息配置里注册（Info -> URL Types 新增条目，填写和上面一致的scheme），否则系统不会把对应URL的打开事件传递给你的App。

2. 为Project实体添加深度链接生成方法 #

利用Project自带的objectID作为项目唯一标识（不需要额外加存储字段），生成对应项目的深度链接：

extension Project {
    var deepLinkURL: URL? {
        // 把项目的唯一objectID转成字符串作为路由标识
        let projectID = self.objectID.uriRepresentation().absoluteString
        var components = URLComponents()
        components.scheme = AppDeepLink.scheme
        components.host = AppDeepLink.projectDetailHost
        components.queryItems = [
            URLQueryItem(name: "projectID", value: projectID)
        ]
        return components.url
    }
}

3. 修正小组件视图的Link逻辑 #

把原本错误的project.url替换为随机选中项目生成的深度链接：

struct WidgetEntryView : View {
    var entry: Provider.Entry
    @FetchRequest(entity: Project.entity(), sortDescriptors: []) var project: FetchedResults<Project>
    
    var body: some View {
        if let randomProject = project.randomElement() {
            // 绑定单个项目生成的深度链接，而非整个集合不存在的url
            if let linkURL = randomProject.deepLinkURL {
                Link(destination: linkURL) {
                    Image(
                        uiImage: UIImage(data: randomProject.image1 ?? Data()) 
                        ?? UIImage(imageLiteralResourceName: "icon")
                    )
                    .resizable()
                    .aspectRatio(contentMode: .fill)
                }
            }
        }
    }
}

4. 主App接收深度链接并路由到详情页 #

在主App的入口处监听URL打开事件，解析URL里的项目标识，从Core Data取出对应项目后跳转到ProjectDetailView：

@main
struct MainApp: App {
    let persistenceController = PersistenceController.shared
    @State private var navigationPath = NavigationPath()
    
    var body: some Scene {
        WindowGroup {
            ProjectListView(navigationPath: $navigationPath)
                .environment(\.managedObjectContext, persistenceController.container.viewContext)
                .onOpenURL { url in
                    // 解析接收到的深度链接
                    guard let components = URLComponents(url: url, resolvingAgainstBaseURL: true),
                          components.host == AppDeepLink.projectDetailHost,
                          let projectIDString = components.queryItems?.first(where: { $0.name == "projectID" })?.value,
                          let projectURI = URL(string: projectIDString),
                          let storeCoordinator = persistenceController.container.persistentStoreCoordinator.managedObjectID(forURIRepresentation: projectURI)
                    else { return }
                    // 从Core Data取出对应项目
                    if let project = try? persistenceController.container.viewContext.existingObject(with: storeCoordinator) {
                        // 将项目详情页加入导航栈完成跳转
                        navigationPath.append(project)
                    }
                }
        }
    }
}

• 小组件的视图中不推荐依赖@FetchRequest拉取数据，更好的做法是在小组件的TimelineProvider中提前获取随机项目，把项目图片、ID信息直接存入TimelineEntry，避免小组件渲染时数据加载异常。
• 全程不需要给Core Data的Project实体添加任何存储型url属性，所有路由标识都基于系统自带的objectID生成，完全满足深度跳转的需求。

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