iOS15及以上SwiftUI视图导航适配方案咨询

要让你的NavigationStack/NavigationPath导航逻辑兼容iOS 15及以上系统，我们通过条件编译和兼容层适配不同版本的导航API，以下是完整实现方案：

1. 改造Router类 #

修改Router，同时支持iOS 15的数组栈和iOS 16的NavigationPath：

import SwiftUI

class Router: ObservableObject {
    public enum Destination: Codable, Hashable {
        case home
        case livingroom
        case bedroom(owner: String)
    }
    
    // iOS 16+ 导航栈
    @Published var navPath = NavigationPath()
    // iOS 15 导航栈
    @Published var navigationStack: [Destination] = []
    
    // 统一导航方法
    func navigate(to destination: Destination) {
        if #available(iOS 16.0, *) {
            navPath.append(destination)
        } else {
            navigationStack.append(destination)
        }
    }
    
    func navigateBack() {
        if #available(iOS 16.0, *) {
            guard !navPath.isEmpty else { return }
            navPath.removeLast()
        } else {
            guard !navigationStack.isEmpty else { return }
            navigationStack.removeLast()
        }
    }
    
    func navigateToRoot() {
        if #available(iOS 16.0, *) {
            navPath.removeLast(navPath.count)
        } else {
            navigationStack.removeAll()
        }
    }
}

2. 创建兼容的导航容器 #

写一个NavigationContainer视图，根据系统版本自动切换NavigationStack或NavigationView：

struct NavigationContainer<Content: View>: View {
    @EnvironmentObject var router: Router
    let content: Content
    
    init(@ViewBuilder content: () -> Content) {
        self.content = content()
    }
    
    var body: some View {
        if #available(iOS 16.0, *) {
            NavigationStack(path: $router.navPath) {
                content
                    .navigationDestination(for: Router.Destination.self) { destination in
                        destinationView(for: destination)
                    }
            }
        } else {
            NavigationView {
                ZStack {
                    content
                    hiddenNavigationLinks
                }
            }
            .navigationViewStyle(.stack)
        }
    }
    
    // 根据目的地生成对应视图
    @ViewBuilder
    private func destinationView(for destination: Router.Destination) -> some View {
        switch destination {
        case .home:
            HomeView()
        case .livingroom:
            LivingroomView()
        case .bedroom(let owner):
            BedroomView(ownerName: owner)
        }
        .environmentObject(router) // 传递Router给子视图
    }
    
    // iOS 15专用：隐藏的NavigationLinks，用于触发程序式导航
    @ViewBuilder
    private var hiddenNavigationLinks: some View {
        ForEach(router.navigationStack.indices, id: \.self) { index in
            NavigationLink(
                destination: destinationView(for: router.navigationStack[index]),
                isActive: Binding(
                    get: { router.navigationStack.count > index },
                    set: { isActive in
                        if !isActive {
                            // 用户手动返回时同步更新栈
                            router.navigationStack.removeLast(router.navigationStack.count - index)
                        }
                    }
                )
            ) {
                EmptyView()
            }
            .hidden()
        }
    }
}

3. 更新App入口 #

替换原来的NavigationStack为NavigationContainer，并使用@StateObject正确初始化Router：

@main
struct App: App {
    @StateObject private var router = Router() // 用StateObject管理Router生命周期
    
    var body: some Scene {
        WindowGroup {
            NavigationContainer {
                HomeView()
            }
            .environmentObject(router)
        }
    }
}

4. 视图中使用导航 #

在任意子视图中，通过@EnvironmentObject获取Router并调用导航方法即可，和原来的用法完全一致：

struct HomeView: View {
    @EnvironmentObject private var router: Router
    
    var body: some View {
        VStack {
            Button("去客厅") {
                router.navigate(to: .livingroom)
            }
            Button("去卧室（主人：小明）") {
                router.navigate(to: .bedroom(owner: "小明"))
            }
        }
    }
}

关键说明 #

• 条件编译：通过#available区分iOS 16+和iOS 15的导航逻辑
• 状态同步：iOS 15中通过隐藏的NavigationLink和绑定关系，确保手动返回和程序式导航的栈状态一致
• 代码复用：所有业务视图的导航调用逻辑完全不变，无需针对不同系统版本修改

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