SwiftUI环境下基于Branch.io实现Deep Link视图跳转的方案咨询

要在SwiftUI中处理Branch Deep Link的视图跳转，核心是通过可观察对象（ObservableObject）管理导航状态，替代UIKit中直接操作window和rootViewController的方式。以下是完整实现方案：

1. 创建导航状态管理器 #

定义一个ObservableObject类，用来存储和发布Deep Link指定的跳转目标：

import SwiftUI

class NavigationManager: ObservableObject {
    // 用NavigationPath管理导航栈（iOS 16+），或者用可选值控制Sheet展示
    @Published var navigationPath = NavigationPath()
    
    // 枚举定义所有可跳转的页面类型，与Branch后台配置的`nav_to`字段对应
    enum Destination: Hashable {
        case landingPage
        case tutorial
        case content
    }
}

2. 配置App结构体 #

注入导航管理器，处理Deep Link的URL回调，并将管理器传递给AppDelegate：

@main
struct YourAppNameApp: App {
    @UIApplicationDelegateAdaptor(AppDelegate.self) private var appDelegate
    @StateObject private var navigationManager = NavigationManager()
    
    init() {
        // 将导航管理器传递给AppDelegate，以便在Branch回调中更新状态
        appDelegate.navigationManager = navigationManager
    }
    
    var body: some Scene {
        WindowGroup {
            // 使用NavigationStack管理导航栈（iOS 16+）
            NavigationStack(path: $navigationManager.navigationPath) {
                ContentView()
                    .environmentObject(navigationManager)
                    .onOpenURL(perform: { url in
                        // 交给Branch处理Deep Link
                        Branch.getInstance().handleDeepLink(url)
                    })
                    // 配置导航目标与视图的映射
                    .navigationDestination(for: NavigationManager.Destination.self) { destination in
                        switch destination {
                        case .landingPage:
                            LandingPageView()
                        case .tutorial:
                            TutorialView()
                        case .content:
                            ContentDetailView()
                        }
                    }
            }
        }
    }
}

3. 修改AppDelegate更新导航状态 #

在Branch的会话初始化回调中，解析Deep Link参数并更新导航管理器的状态：

import UIKit
import Branch

class AppDelegate: NSObject, UIApplicationDelegate {
    weak var navigationManager: NavigationManager?
    
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
        Branch.getInstance().initSession(launchOptions: launchOptions) { [weak self] params, error in
            // 解析Branch返回的参数
            guard let deepLinkParams = params as? [String: AnyObject],
                  let navTarget = deepLinkParams["nav_to"] as? String else {
                return
            }
            
            // 匹配跳转目标，更新导航栈
            DispatchQueue.main.async {
                switch navTarget {
                case "landing_page":
                    self?.navigationManager?.navigationPath.append(NavigationManager.Destination.landingPage)
                case "tutorial":
                    self?.navigationManager?.navigationPath.append(NavigationManager.Destination.tutorial)
                case "content":
                    self?.navigationManager?.navigationPath.append(NavigationManager.Destination.content)
                default:
                    break
                }
            }
        }
        
        return true
    }
}

4. 示例目标视图 #

定义对应的跳转目标视图：

// 着陆页视图
struct LandingPageView: View {
    var body: some View {
        VStack(spacing: 20) {
            Text("着陆页")
                .font(.title)
            Text("通过Deep Link跳转至此")
        }
    }
}

// 教程页视图
struct TutorialView: View {
    var body: some View {
        VStack(spacing: 20) {
            Text("教程页")
                .font(.title)
            Text("展示应用教程内容")
        }
    }
}

// 内容详情页视图
struct ContentDetailView: View {
    var body: some View {
        VStack(spacing: 20) {
            Text("内容详情页")
                .font(.title)
            Text("展示具体内容详情")
        }
    }
}

可选：用Sheet展示跳转页面 #

如果不需要推入导航栈，而是以模态方式展示页面，可以修改导航管理器和视图：

// 修改导航管理器
class NavigationManager: ObservableObject {
    @Published var presentedDestination: Destination?
    
    enum Destination: String {
        case landingPage = "landing_page"
        case tutorial
        case content
    }
}

// 在ContentView中处理Sheet展示
struct ContentView: View {
    @EnvironmentObject private var navigationManager: NavigationManager
    
    var body: some View {
        VStack {
            Text("主页面")
                .font(.title)
        }
        .sheet(item: $navigationManager.presentedDestination) { destination in
            switch destination {
            case .landingPage:
                LandingPageView()
            case .tutorial:
                TutorialView()
            case .content:
                ContentDetailView()
            }
        }
    }
}

// AppDelegate中更新状态
DispatchQueue.main.async {
    guard let dest = NavigationManager.Destination(rawValue: navTarget) else { return }
    self?.navigationManager?.presentedDestination = dest
}

注意事项 #

• 确保已正确集成Branch SDK，并完成基础配置（如在Info.plist中添加相关权限、关联域名等）
• 所有UI更新必须在主线程执行，因此用DispatchQueue.main.async包裹状态更新代码
• 若需兼容iOS 15及以下，可使用NavigationView替代NavigationStack，并通过绑定变量手动管理导航

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