独立开发者

项目名称：Routing

项目简介

Routing是一个开源库，旨在帮助开发者在使用SwiftUI开发iOS应用时，将导航逻辑从视图中解耦出来。这样做可以提高代码的可维护性和可读性，并使得导航逻辑更加集中和易于管理。

功能特点

• 导航逻辑解耦：将导航逻辑从SwiftUI视图中分离，实现关注点分离。

• 支持多种导航类型：支持推送（push）、表（sheet）和全屏覆盖（fullScreenCover）等多种导航方式。

• Routable协议：通过定义一个遵循Routable协议的枚举来表示不同的视图路由。

• Router实例注入：在视图层次结构中使用RoutingView包装，将Router实例注入到根视图中。

安装指南

通过Swift Package Manager安装Routing：

1. 在Xcode中选择“File” > “Add Packages...”。

2. 将以下URL粘贴到“Search or Enter Package URL”搜索栏中：
   

   https://github.com/obvios/Routing.git

3. Xcode将获取仓库，并将Routing库添加到你的项目中。

使用方法

1. 创建一个遵循Routable协议的枚举，代表不同的视图路由：
   

   enum ExampleRoute: Routable {
       case viewA
       case viewB(String)
       case viewC
       
       @ViewBuilder
       func viewToDisplay(router: Router<ExampleRoute>) -> some View {
           // ...
       }
       
       var navigationType: NavigationType {
           // ...
       }
   }

2. 使用RoutingView包装视图层次结构，并初始化Router实例：
   

   struct ContentView: View {
       @StateObject var router: Router<ExampleRoute>
       
       var body: some View {
           RoutingView(ExampleRoute.self) { router in
               RootView(router: router)
           }
       }
   }

3. 在视图中使用Router函数进行导航：
   

   struct ViewA: View {
       @StateObject var router: Router<ExampleRoute>
       
       var body: some View {
           Text("View A")
           Button("ViewC") {
               router.routeTo(.viewC)
           }
           Button("Dismiss") {
               router.dismiss()
           }
       }
   }

扩展

Routing作为一个开源项目，开发者可以在此基础上增加更多功能，比如支持更多的导航动画、集成第三方导航库或者增加对新iOS版本的支持。此外，项目也可以作为学习SwiftUI导航模式和路由管理的实例，对于希望深入了解这些技术的开发人员来说，是一个很好的学习资源。