如何为watchOS Complications添加基于上下文的深度链接？

核心实现依据 #

苹果官方说明：

复杂功能可通过深度链接将用户引导至应用的特定板块。使用CLKComplicationTapAction类定义用于打开URL的点击动作。

由于需兼容watchOS 9以下版本，需基于ClockKit框架的CLKComplicationDataSource完成开发，具体步骤如下：

1. 配置应用URL Scheme #

• 在Watch App的Info.plist中添加CFBundleURLTypes数组，配置自定义URL Scheme（例如mywatchapp://），用于标识应用的深度链接路径。
• 示例配置（可直接复制到Info.plist源码视图）：

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>mywatchapp</string>
        </array>
    </dict>
</array>

2. 在Complication数据源中设置点击跳转动作 #

在CLKComplicationDataSource的getCurrentTimelineEntry(for:withHandler:)方法中，创建CLKComplicationTimelineEntry时为其添加tapAction属性，指定跳转的深度链接：

func getCurrentTimelineEntry(for complication: CLKComplication, withHandler handler: @escaping (CLKComplicationTimelineEntry?) -> Void) {
    // 构建Complication显示模板
    let template = CLKComplicationTemplateModularLargeStandardBody()
    template.headerTextProvider = CLKSimpleTextProvider(text: "我的应用")
    template.bodyTextProvider = CLKSimpleTextProvider(text: "点击跳转")
    
    // 定义指向特定板块的深度链接
    guard let url = URL(string: "mywatchapp://feature/tasklist") else {
        handler(nil)
        return
    }
    let tapAction = CLKComplicationTapAction(url: url)
    
    // 创建带点击动作的TimelineEntry
    let entry = CLKComplicationTimelineEntry(date: Date(), complicationTemplate: template, tapAction: tapAction)
    
    handler(entry)
}

3. 在Watch App中处理深度链接跳转 #

在Watch App的ExtensionDelegate中实现handle(_:)方法，解析传入的URL并导航至对应板块：

func handle(_ userActivity: NSUserActivity) {
    guard let url = userActivity.webpageURL else { return }
    
    // 解析URL路径，跳转至对应板块
    if url.path == "/feature/tasklist" {
        if let rootController = WKExtension.shared().rootInterfaceController as? InterfaceController {
            rootController.pushController(withName: "TaskListController", context: nil)
        }
    }
}

额外注意事项 #

• 若使用CloudKit同步数据，需确保Complication的TimelineEntry更新时，tapAction的URL配置保持一致，避免跳转路径失效。
• 跳转功能需在真机上测试验证，部分模拟器可能存在深度链接兼容性问题。

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