HHRouter 开源项目教程

HHRouter 开源项目教程

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

1. 项目介绍

HHRouter 是一个为 iOS 设计的 URL 路由框架，它可以帮助开发者以简洁、快速和灵活的方式管理应用内的页面跳转。该框架受到了 ABRouter 和 Routable iOS 的启发，旨在为开发者提供一个易于使用的路由管理解决方案。

2. 项目快速启动

首先，确保你的项目已经集成了 CocoaPods。

通过 CocoaPods 安装 HHRouter

在你的 Podfile 文件中添加以下代码：

pod 'HHRouter', '~> 0.1.8'

然后执行以下命令安装：

pod install

安装完成后，你可以开始使用 HHRouter。

映射 URL 模式到 ViewController

在 AppDelegate 中，你可以映射 URL 模式到对应的 ViewController。

[[HHRouter shared] map:@"/user/:userId/" toControllerClass:[UserViewController class]];

根据 URL 获取 ViewController 实例

UIViewController *viewController = [[HHRouter shared] matchController:@"/user/1/"];
XCTAssertEqualObjects([viewController class], [UserViewController class]);
XCTAssertEqualObjects(viewController.params[@"route"], @"/user/1/");
XCTAssertEqualObjects(viewController.params[@"userId"], @"1");

支持 URL 查询参数

UIViewController *viewController = [[HHRouter shared] matchController:@"/user/1/?tabIndex=3"];
XCTAssertEqualObjects(viewController.params[@"tabIndex"], @"3");

支持 URL Scheme

如果你的应用已经定义了一些 URL Scheme，HHRouter 会自动识别。

UIViewController *viewController = [[HHRouter shared] matchController:@"hhrouter://user/1/"];
XCTAssertEqualObjects([viewController class], [UserViewController class]);

3. 应用案例和最佳实践

在应用中，你可以使用 HHRouter 来实现模块间的解耦，比如在不同的模块之间进行页面跳转时，不需要直接引用目标模块的类。这有助于减少模块间的依赖，使得项目结构更加清晰。

一个最佳实践是在应用启动时，预先定义好所有可能的页面跳转路径，这样可以在运行时动态地根据 URL 来打开对应的页面。

4. 典型生态项目

目前，HHRouter 已经被一些应用所使用，例如布丁动画等。开发者们可以通过 HHRouter 实现应用内页面跳转的统一管理和参数传递。

以上是对 HHRouter 的简单介绍和快速启动教程，希望对开发者们有所帮助。

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