HHRouter 开源项目安装与使用教程-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00051/article/details/141418268

HHRouter 开源项目安装与使用教程

HHRouterYet another URL Router for iOS.项目地址:https://gitcode.com/gh_mirrors/hh/HHRouter

项目概述

HHRouter 是一个基于 Swift 的 URL 路由框架，旨在简化 iOS 应用内部页面跳转逻辑，提供灵活的路由注册与解析机制。本教程将引导您了解其基本架构，以及如何快速集成至您的项目中。

1. 项目目录结构及介绍

HHRouter 的项目结构简洁明了，主要组件围绕核心功能展开：

HHRouter/
│
├── Example               # 示例应用，展示了HHRouter的基本用法。
│   ├── HHRouterExample.xcodeproj
│   └── ...                # 示例相关源码和资源文件
├── HHRouter               # 主工程，包含了HHRouter的核心库代码。
│   ├── HHRouter.swift     # 路由核心处理类
│   ├── HHRouteConfig.swift # 路由配置相关
│   └── ...                # 其他支持文件
├── Sources                # 核心源码目录
│   └── HHRouter.swift     # 同样指向核心的路由处理逻辑
├── Tests                  # 测试目录
│   └── ...                # 单元测试文件
└── README.md              # 项目说明文档

Example 目录包含了示例应用，是学习和理解HHRouter如何在实际项目中使用的最佳入口。
HHRouter 和 Sources 盽录下的 .swift 文件为核心库代码，定义了路由的注册、解析和执行过程。
Tests 包含单元测试，用于确保路由功能的正确性。

2. 项目的启动文件介绍

HHRouter并未明确指定一个“启动文件”，但通常在其使用场景下，您会在应用初始化阶段（例如 AppDelegate.swift）配置和初始化HHRouter。这是一个简化的示例流程，展示如何开始使用HHRouter：

import HHRouter

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // 初始化HHRouter并进行基础设置
    HHRouter.shared.config = HHRouteConfig(debugMode: true) // 可选地，开启调试模式
    HHRouter.register(routePattern: "/home", handler: { params in
        // 在这里处理路径对应的逻辑，比如导航到对应ViewController
        let storyboard = UIStoryboard(name: "Main", bundle: nil)
        let homeVC = storyboard.instantiateViewController(withIdentifier: "HomeViewController")
        self.window?.rootViewController?.pushViewController(homeVC, animated: true)
    })
    return true
}