如何从Widget Extension跳转至UIKit ViewController？

我来帮你搞定这个Widget跳转的问题！因为.systemSmall类型的Widget确实只能用.widgetURL来处理跳转，咱们得通过自定义URL Scheme来实现精准跳转到指定页面，具体步骤如下：

首先，先调整你Widget里的.widgetURL设置，用合法的自定义URL格式来标识跳转目标，而不是直接写控制器名称：

struct WidgetView: View { 
    var data : DataProvider.Entry 
    var body: some View { 
        ZStack { 
            Image("Clicker") 
                .padding(.all, 15) 
        }
        .widgetURL(URL(string: "myapp://clicker")) // 这里用自定义Scheme+跳转标识
        .padding(.all, 30) 
        .background(Color.green) 
    } 
}

接下来，需要在你的App中拦截这个URL并处理跳转，分两种常见的App结构来适配：

情况1：你的App基于UIKit（AppDelegate/SceneDelegate） #

1. 先注册自定义URL Scheme：
   打开Info.plist，添加URL types数组项，在子项里设置URL Schemes为myapp（和上面的Scheme保持一致）。

2. 在SceneDelegate中处理跳转：

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else { return }
    handleDeepLink(url: url)
}

private func handleDeepLink(url: URL) {
    // 判断URL的host，确认是跳转到Clicker页面的请求
    if url.host == "clicker" {
        // 获取当前窗口的根控制器
        guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
              let window = windowScene.windows.first,
              let rootVC = window.rootViewController else {
            return
        }
        // 实例化目标控制器
        let clickerVC = ClickerViewController()
        // 根据根控制器类型选择跳转方式
        if let navVC = rootVC as? UINavigationController {
            navVC.pushViewController(clickerVC, animated: true)
        } else {
            rootVC.present(UINavigationController(rootViewController: clickerVC), animated: true)
        }
    }
}

情况2：你的App是纯SwiftUI结构（iOS 14+） #

1. 同样先注册自定义URL Scheme：步骤和上面一致，在Info.plist里添加myapp的Scheme。

2. 在App结构体中处理跳转：

@main
struct MyApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
                .onOpenURL { url in
                    handleDeepLink(url: url)
                }
        }
    }
    
    private func handleDeepLink(url: URL) {
        if url.host == "clicker" {
            // 获取当前窗口环境，跳转到UIKit控制器
            guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
                  let window = windowScene.windows.first,
                  let rootVC = window.rootViewController else {
                return
            }
            let clickerVC = ClickerViewController()
            if let navVC = rootVC as? UINavigationController {
                navVC.pushViewController(clickerVC, animated: true)
            } else {
                rootVC.present(UINavigationController(rootViewController: clickerVC), animated: true)
            }
            
            // 如果你用的是SwiftUI的NavigationStack，也可以通过绑定路径跳转：
            // appNavigationPath.append(AppRoute.clicker)
        }
    }
}

关键逻辑说明 #

• 自定义URL Scheme：必须用scheme://host这种合法的URL格式，系统才能正确识别并传递给你的App，直接写控制器名称是无效的。
• URL拦截逻辑：核心是在App被Widget唤醒时，捕获传入的URL，通过判断URL的host或路径，确定要跳转的目标页面，然后实例化并展示对应的控制器。
• 适配不同结构：不管你的App是UIKit主导还是SwiftUI主导，核心逻辑都是一致的，只是处理URL的入口位置不同。

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