SGNavigationProgress源码解读：从SGProgressView到分类实现的完整架构

SGNavigationProgress源码解读：从SGProgressView到分类实现的完整架构

【免费下载链接】SGNavigationProgressA category for showing a Messages like progress view on a UINavigationBar项目地址: https://gitcode.com/gh_mirrors/sg/SGNavigationProgress

想要为你的iOS应用添加类似Safari浏览器的导航栏进度条效果吗？SGNavigationProgress是一个轻量级、易用的Objective-C库，专门为UINavigationController设计的进度指示器组件。这个开源项目通过分类（Category）的方式，为iOS开发者提供了一种优雅的方式在导航栏上显示进度条，无论是文件上传、下载还是其他耗时操作的进度展示，都能让你的应用体验更加专业。

🎯 项目核心功能与架构设计

SGNavigationProgress的核心设计理念是简单易用、高度可定制。项目采用分类（Category）设计模式，在不修改UINavigationController原有代码的基础上，为其添加了进度条功能。这种设计模式的优势在于：

1. 零侵入性：不需要继承或修改系统类
2. 即插即用：导入即可使用，无需复杂配置
3. 内存安全：自动管理进度条的生命周期

整个项目的架构非常清晰，主要包含两个核心文件：

• SGProgressView：自定义的进度条视图组件
• UINavigationController+SGProgress：为导航控制器添加进度条功能的分类

🔍 SGProgressView：轻量级进度条组件解析

SGProgressView是整个项目的视觉核心，它是一个高度仅为2.5pt的轻量级视图组件。在SGProgressView.m文件中，我们可以看到其简洁而高效的设计：

// 关键属性设置 @property (nonatomic, assign) float progress; @property (nonatomic, strong) UIView *progressBar;

SGProgressView的进度更新机制非常巧妙：通过重写setProgress:方法，根据进度值动态计算进度条的宽度，并平滑地更新UI。这种设计确保了进度更新的流畅性和性能效率。

核心特点：

• 自动裁剪超出边界的部分（clipsToBounds = YES）
• 支持自定义颜色（通过tintColor属性）
• 进度值自动限制在0-1范围内
• 帧更新时的自动重绘机制

🏗️ UINavigationController+SGProgress：分类实现的艺术

这是项目的核心创新点，通过分类为系统类添加新功能。在UINavigationController+SGProgress.m中，我们可以看到完整的实现逻辑：

1. 进度条管理机制

- (SGProgressView *)progressView { // 智能查找或创建进度条视图 for (UIView *subview in [self.navigationBar subviews]) { if ([subview isKindOfClass:[SGProgressView class]]) { return (SGProgressView *)subview; } } // 如果不存在，则创建新的进度条 // ... }

这种方法确保了单例模式的效果：每个导航栏最多只有一个进度条实例，避免了重复创建和内存泄漏问题。

2. 遮罩层设计

SGNavigationProgress提供了遮罩模式，可以在显示进度条的同时，为屏幕其他部分添加半透明遮罩，增强用户的注意力集中效果。遮罩层的实现同样采用智能查找机制：

- (BOOL)hasSGProgressMask { for (UIView *subview in [self.view subviews]) { if (subview.tag == SGProgressMiniMasktagId || subview.tag == SGProgressMasktagId) { return YES; } } return NO; }

3. 丰富的API设计

项目提供了多种使用方式，满足不同场景需求：

定时进度模式：

// 3秒自动完成的进度条 [self.navigationController showSGProgress]; // 自定义时长和颜色 [self.navigationController showSGProgressWithDuration:5 andTintColor:[UIColor blueColor]];

百分比控制模式：

// 手动控制进度百分比 [self.navigationController setSGProgressPercentage:75]; // 带标题和遮罩的百分比控制 [self.navigationController setSGProgressMaskWithPercentage:50 andTitle:@"正在上传..."];

🚀 快速集成指南

安装方式

CocoaPods安装（推荐）：

pod 'SGNavigationProgress'

手动集成：

1. 将UINavigationController+SGProgress.h和UINavigationController+SGProgress.m添加到项目
2. 导入头文件：#import "UINavigationController+SGProgress.h"

基础使用示例

// 显示3秒自动完成的进度条 [self.navigationController showSGProgress]; // 显示带遮罩和自定义标题的进度条 [self.navigationController showSGProgressWithMaskAndDuration:3 andTitle:@"加载中..."]; // 手动控制进度（适合文件上传/下载） [self.navigationController setSGProgressPercentage:currentProgress];

💡 最佳实践与使用技巧

1. 选择合适的进度模式

• 定时模式：适合已知时长的操作，如页面加载
• 百分比模式：适合文件上传、下载等可变时长的操作

2. 标题动态更新

SGNavigationProgress支持在显示进度条时动态更新导航栏标题，这在需要显示状态信息的场景中非常有用：

// 显示进度条并更新标题 [self.navigationController showSGProgressWithDuration:3 andTintColor:[UIColor blueColor] andTitle:@"正在发送..."];

3. 旋转适配

项目已经考虑了设备旋转的情况，在willRotateToInterfaceOrientation:方法中自动更新遮罩层的位置，确保在不同方向下都能正确显示。

4. 内存管理

进度条和遮罩层都有完善的自动清理机制，在进度完成后会自动从视图层级中移除，避免内存泄漏。

🔧 高级定制与扩展

自定义颜色方案

// 使用自定义颜色 [self.navigationController showSGProgressWithDuration:3 andTintColor:[UIColor colorWithRed:0.2 green:0.6 blue:0.8 alpha:1.0]];

进度完成回调

虽然项目本身没有直接提供完成回调，但你可以结合动画完成块来实现：

[self.navigationController showSGProgressWithDuration:3]; // 3秒后执行完成操作 dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(3 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{ // 进度完成后的操作 NSLog(@"进度完成！"); });

📊 性能优化建议

1. 避免频繁更新：对于百分比模式，建议不要过于频繁地调用setSGProgressPercentage:，可以适当降低更新频率
2. 合理使用遮罩：遮罩层会增加视图层级，在不需要时尽量避免使用
3. 及时清理：使用finishSGProgress或cancelSGProgress及时结束进度显示

🎨 设计理念总结

SGNavigationProgress的成功之处在于其简洁而强大的设计：

1. 分类设计模式：不修改系统类，保持代码的纯净性
2. 智能视图管理：自动查找和重用现有视图，提高性能
3. 灵活的API：提供多种使用方式，满足不同场景需求
4. 完善的动画：流畅的进度动画和渐入渐出效果
5. 良好的兼容性：支持iOS各种版本和设备旋转

🚀 实际应用场景

这个库特别适合以下应用场景：

1. 网络请求进度：文件上传/下载的进度展示
2. 页面加载指示：网页或内容加载时的进度提示
3. 表单提交：表单数据提交时的进度反馈
4. 多步骤操作：多步骤流程的进度指示
5. 后台任务：后台处理任务的进度可视化

结语

SGNavigationProgress是一个设计精良、使用简单的iOS进度条组件，通过深入分析其源码，我们不仅学到了如何实现一个优雅的进度指示器，更重要的是理解了分类设计模式在实际项目中的应用价值。无论是新手开发者还是有经验的iOS工程师，都能从这个项目中获得启发和实用的代码实现思路。

通过合理的架构设计和简洁的API，SGNavigationProgress为iOS应用提供了专业级的进度指示解决方案，值得在需要进度展示功能的应用中采用和借鉴。

【免费下载链接】SGNavigationProgressA category for showing a Messages like progress view on a UINavigationBar项目地址: https://gitcode.com/gh_mirrors/sg/SGNavigationProgress