RZUtils
一组用于 iOS 开发的实用工具和组件。
安装
CocoaPods
RZUtils 的 podspec 已完全按照目录(每个单独的分类类型或组件一个 subspec)划分。以下是一些示例。
RZUtils 的所有内容
pod 'RZUtils'
所有类别
pod 'RZUtils/Categories'
所有组件
pod 'RZUtils/Components'
所有实用工具或测试实用工具
pod 'RZUtils/Utilities'
pod 'RZUtils/TestUtilities'
特定类
如果要导入特定的类别、组件或实用工具,子规范应与目录结构相对应。例如
pod 'RZUtils/Categories/NSString'
pod 'RZUtils/Categories/KVO'
pod 'RZUtils/Components/RZProgressView'
手动安装
只需将相关文件复制到您的项目中。如果文件导入了任何框架,则链接到这些框架。
类别概述
CoreAnimation
-
CAAnimation+RZBlocks
CAAnimation
的完成块
KVO
-
NSObject+RZBlockKVO
使用块实现KVO和自动移除观察者在dealloc上
NSDate
-
NSDate+RZExtensions
常用的日期操作
NSDictionary
-
NSDictionary+RZExtensions
为
NSDictionary
提供的便利方法(如NSNull
检查等)
NSString
-
NSAttributedString+RZExtensions
简化后的属性字符串初始化器和其他工具
-
NSString+RZStringFormatting
常用的字符串格式化方法
-
NSString+RZStringSize
用于替换在iOS 7中弃用的字符串大小方法。
NSUndoManager
-
NSUndoManager+RZBlockUndo
基于块撤销管理器的接口。
UIAlertView
-
UIAlertView+RZCompletionBlocks
针对
UIAlertView
行为的块API
UIColor
-
UIColor+RZExtensions
创建 UIColor 的实用工具
UIFont
-
UIFont+RZExtensions
有趣的字体特性
UIImage
-
UIImage+RZAverageColor
计算 UIImage 实例的平均颜色。
-
UIImage+RZResize
根据宽高比调整图像大小的方法
-
UIImage+RZSnapshotHelpers
使用 iOS7 的
drawViewHierarchyInRect
来快照和创建一个UIImage
的方法。包含 iOS7(带有视图截图)更快版本 Apple 的图像模糊方法。仅限 iOS7 及以上版本。 -
UIImage+RZSolidColor
在
UIImage
上的类别,可以返回指定大小的纯色图像。特别适用于设置UIButton
的状态相关背景颜色,如同:[aButton setBackgroundImage:[UIImage rz_solidColorImageWithSize:CGSizeMake(1.0f, 1.0f) color:[UIColor redColor]]]
。 -
UIImage+RZStretchHelpers
UIImage
的拉伸和填充内边距方法
UITableViewCell
-
UITableViewCell+RZCellStyling
为组对表格视图的顶部、底部和中间表格单元格设置样式的函数
UIView
-
UIView+RZAutoLayoutHelpers
使代码级别的自动布局任务更简单。
-
UIView+RZBorders
在任意
UIView
的任意边设置边框 -
UIView+RZFrameUtils
轻松调整
UIView
的帧
UIViewController
-
UIViewController+RZKeyboardWatcher
键盘出现/消失通知的脚本动画块实用工具。
组件概述
RZAnimatedCountingLabel
UILabel
子类,可以将文本从一个值动画到另一个值,可选自定义格式化块。
RZAbout
一套用于展示各种“关于”元素的实用工具,如“由RZ构建”标志和反馈。
RZAnimatedImageView
基于 UIImageView
的动画 .png 序列的替代品,当动画完成时调用完成块。信不信由你,没有其他方法可以做到这一点。
RZButtonView
UIControl
子类,类似于 UIButton,但允许添加和布局任意子视图。
RZCollectionTableView
它是一个集合视图或表格视图?世界可能永远不会知道... (剧透:它是一个集合视图)
RZCollectionTableView
是一种集合视图布局及其伴随的集合视图和集合视图单元格子类,模仿了UITableView
的类/委托接口、外观和感觉,增加了一些增强功能,如可自定义章节内边距、行间距等。
RZCollectionViewAnimationAssistant
制作集合视图项目插入/删除动画的实用程序。
RZDelayedOperation
基本的并发NSOperation类,接受一个块并在给定的时间间隔后执行。可以被取消或重置。
RZLocationService
简化了CoreLocation的实现。
RZProgressView
UIProgressView
在iOS 7.0中有点破损(动画和调整大小时有奇怪的错误),在iOS 7.1中是非常破损的(无法设置自定义图片;在这里查找雷达)。RZProgressView
是一个可以替换的方案,修复了这些问题。
RZRevealViewController
地下/展开菜单组件。
RZSegmentedViewController
UIViewController
容器,使用段控件在多个 UIViewControllers
之间切换。
RZSingleChildContainerViewController
一个用于管理父视图容器内任意子视图中包含的单个子视图控制器的 UIViewController
子类。在保持一个视图静态的同时,另一个视图可以包含多个潜在子视图控制器之一。iOS7+。
RZSplitViewController
扩展了 UISplitViewController
的功能,包括允许以模态方式呈现。
RZTelprompt
使用 telprompt 通过向静态 UIWebView 发出 tel 请求来进行手机通话,UIWebView 依次私有地调用 telprompt。这使您能够在 Apple 未特别支持的情况下使用 telprompt。
RZViewFactory
对 UIView
的扩展,便于从 XIB 文件加载子类。
RZWebviewController
UIViewController
用于管理具有相关界面的网页视图。
实用工具概述
RZCommonUtils
有用的宏、数学函数等。
RZDispatch
用于处理 GCD/libdispatch 的实用扩展。
RZLogHelper
一个包含日志宏的头部,这些宏扩展了 NSLog
,包括详细级别。
测试实用工具概述
此目录中的所有实用工具仅适用于测试代码使用。
RZWaiter
用于辅助测试异步操作的实用工具。
许可证
RZUtils遵照MIT许可证发布。有关更详细的信息,请参阅LICENSE文件。
贡献
欢迎贡献和pull请求。请遵循以下指南
- 请在
develop
分支上打开Pull Requests。我们定期将更新合并为具有语义版本号的标记版本,然后作为podspec更新推送,最后合并到master。 - 确保使用appledoc样式的注释进行头文件文档化。这将允许CocoaDocs在推送更新的podspec时自动创建文档。
- 积极使用前缀(用于类为
RZ
,用于方法为rz_
)以便于类别方法和类名的命名,以避免潜在的命名冲突。