Categories

Objective-C

@interface UIView (FWAutoLayout)

Objective-C

@interface UIViewController (FWAdaptive)

/// 当前状态栏布局高度，导航栏隐藏时为0，推荐使用
@property (nonatomic, assign, readonly) CGFloat fw_statusBarHeight NS_REFINED_FOR_SWIFT;

/// 当前导航栏布局高度，隐藏时为0，推荐使用
@property (nonatomic, assign, readonly) CGFloat fw_navigationBarHeight NS_REFINED_FOR_SWIFT;

/// 当前顶部栏布局高度，导航栏隐藏时为0，推荐使用
@property (nonatomic, assign, readonly) CGFloat fw_topBarHeight NS_REFINED_FOR_SWIFT;

/// 当前标签栏布局高度，隐藏时为0，推荐使用
@property (nonatomic, assign, readonly) CGFloat fw_tabBarHeight NS_REFINED_FOR_SWIFT;

/// 当前工具栏布局高度，隐藏时为0，推荐使用
@property (nonatomic, assign, readonly) CGFloat fw_toolBarHeight NS_REFINED_FOR_SWIFT;

/// 当前底部栏布局高度，包含标签栏和工具栏，隐藏时为0，推荐使用
@property (nonatomic, assign, readonly) CGFloat fw_bottomBarHeight NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface UILabel (FWUIKit)

/// 快速设置attributedText样式，设置后调用setText:会自动转发到setAttributedText:方法
@property (nonatomic, copy, nullable) NSDictionary<NSAttributedStringKey, id> *fw_textAttributes NS_REFINED_FOR_SWIFT;

/// 快速设置文字的行高，优先级低于fwTextAttributes，设置后调用setText:会自动转发到setAttributedText:方法。小于0时恢复默认行高
@property (nonatomic, assign) CGFloat fw_lineHeight NS_REFINED_FOR_SWIFT;

/// 自定义内容边距，未设置时为系统默认。当内容为空时不参与intrinsicContentSize和sizeThatFits:计算，方便自动布局
@property (nonatomic, assign) UIEdgeInsets fw_contentInset NS_REFINED_FOR_SWIFT;

/// 纵向分布方式，默认居中
@property (nonatomic, assign) UIControlContentVerticalAlignment fw_verticalAlignment NS_REFINED_FOR_SWIFT;

/// 添加点击手势并自动识别NSLinkAttributeName|URL属性，点击高亮时回调链接，点击其它区域回调nil
- (void)fw_addLinkGestureWithBlock:(void (^)(id _Nullable link))block NS_REFINED_FOR_SWIFT;

/// 获取手势触发位置的文本属性，可实现行内点击效果等，allowsSpacing默认为NO空白处不可点击。为了识别更准确，attributedText需指定font
- (NSDictionary<NSAttributedStringKey, id> *)fw_attributesWithGesture:(UIGestureRecognizer *)gesture allowsSpacing:(BOOL)allowsSpacing NS_REFINED_FOR_SWIFT;

/// 快速设置标签
- (void)fw_setFont:(nullable UIFont *)font textColor:(nullable UIColor *)textColor NS_REFINED_FOR_SWIFT;

/// 快速设置标签并指定文本
- (void)fw_setFont:(nullable UIFont *)font textColor:(nullable UIColor *)textColor text:(nullable NSString *)text NS_REFINED_FOR_SWIFT;

/// 快速创建标签
+ (instancetype)fw_labelWithFont:(nullable UIFont *)font textColor:(nullable UIColor *)textColor NS_REFINED_FOR_SWIFT;

/// 快速创建标签并指定文本
+ (instancetype)fw_labelWithFont:(nullable UIFont *)font textColor:(nullable UIColor *)textColor text:(nullable NSString *)text NS_REFINED_FOR_SWIFT;

@end

extension UILabel: SkeletonViewDataSource

Objective-C

@interface UITextView (FWKeyboard)

extension UITextView: SkeletonViewDataSource

Objective-C

@interface UITableView (FWDynamicLayout)

extension UITableView: SkeletonViewDataSource

Objective-C

@interface UICollectionView (FWDynamicLayout)

extension UICollectionView: SkeletonViewDataSource

Objective-C

@interface UITableViewCell (FWDynamicLayout)

/// 如果用来确定Cell所需高度的View是唯一的，请把此值设置为YES，可提升一定的性能
@property (nonatomic, assign) BOOL fw_maxYViewFixed NS_REFINED_FOR_SWIFT;

/// 最大Y视图的底部内边距，可避免新创建View来撑开Cell，默认0
@property (nonatomic, assign) CGFloat fw_maxYViewPadding NS_REFINED_FOR_SWIFT;

/// 最大Y视图是否撑开布局，需布局约束完整。默认NO，无需撑开布局；YES时padding不起作用
@property (nonatomic, assign) BOOL fw_maxYViewExpanded NS_REFINED_FOR_SWIFT;

/// 免注册创建UITableViewCell，内部自动处理缓冲池，默认Default类型
+ (instancetype)fw_cellWithTableView:(UITableView *)tableView NS_REFINED_FOR_SWIFT;

/// 免注册alloc创建UITableViewCell，内部自动处理缓冲池，指定style类型
+ (instancetype)fw_cellWithTableView:(UITableView *)tableView
                                          style:(UITableViewCellStyle)style NS_REFINED_FOR_SWIFT;

/// 免注册alloc创建UITableViewCell，内部自动处理缓冲池，指定style类型，指定reuseIdentifier
+ (instancetype)fw_cellWithTableView:(UITableView *)tableView
                                          style:(UITableViewCellStyle)style
                                reuseIdentifier:(nullable NSString *)reuseIdentifier NS_REFINED_FOR_SWIFT;

/// 根据配置自动计算cell高度，不使用缓存，子类可重写
+ (CGFloat)fw_heightWithTableView:(UITableView *)tableView
                 configuration:(FWCellConfigurationBlock)configuration NS_REFINED_FOR_SWIFT;

@end

extension UITableViewCell: SkeletonViewDelegate

Objective-C

@interface UITableViewHeaderFooterView (FWDynamicLayout)

/// 如果用来确定HeaderFooterView所需高度的View是唯一的，请把此值设置为YES，可提升一定的性能
@property (nonatomic, assign) BOOL fw_maxYViewFixed NS_REFINED_FOR_SWIFT;

/// 最大Y视图的底部内边距，可避免新创建View来撑开HeaderFooterView，默认0
@property (nonatomic, assign) CGFloat fw_maxYViewPadding NS_REFINED_FOR_SWIFT;

/// 最大Y视图是否撑开布局，需布局约束完整。默认NO，无需撑开布局；YES时padding不起作用
@property (nonatomic, assign) BOOL fw_maxYViewExpanded NS_REFINED_FOR_SWIFT;

/// 免注册alloc创建UITableViewHeaderFooterView，内部自动处理缓冲池
+ (instancetype)fw_headerFooterViewWithTableView:(UITableView *)tableView NS_REFINED_FOR_SWIFT;

/// 免注册alloc创建UITableViewHeaderFooterView，内部自动处理缓冲池，指定reuseIdentifier
+ (instancetype)fw_headerFooterViewWithTableView:(UITableView *)tableView reuseIdentifier:(nullable NSString *)reuseIdentifier NS_REFINED_FOR_SWIFT;

/// 根据配置自动计算cell高度，不使用缓存，子类可重写
+ (CGFloat)fw_heightWithTableView:(UITableView *)tableView
                          type:(FWHeaderFooterViewType)type
                 configuration:(FWHeaderFooterViewConfigurationBlock)configuration NS_REFINED_FOR_SWIFT;

@end

extension UITableViewHeaderFooterView: SkeletonViewDelegate

Objective-C

@interface UICollectionReusableView (FWDynamicLayout)

/// 如果用来确定ReusableView所需尺寸的View是唯一的，请把此值设置为YES，可提升一定的性能
@property (nonatomic, assign) BOOL fw_maxYViewFixed NS_REFINED_FOR_SWIFT;

/// 最大Y尺寸视图的底部内边距(横向滚动时为X)，可避免新创建View来撑开ReusableView，默认0
@property (nonatomic, assign) CGFloat fw_maxYViewPadding NS_REFINED_FOR_SWIFT;

/// 最大Y视图是否撑开布局(横向滚动时为X)，需布局约束完整。默认NO，无需撑开布局；YES时padding不起作用
@property (nonatomic, assign) BOOL fw_maxYViewExpanded NS_REFINED_FOR_SWIFT;

/// 免注册alloc创建UICollectionReusableView，内部自动处理缓冲池
+ (instancetype)fw_reusableViewWithCollectionView:(UICollectionView *)collectionView
                                            kind:(NSString *)kind
                                       indexPath:(NSIndexPath *)indexPath NS_REFINED_FOR_SWIFT;

/// 免注册alloc创建UICollectionReusableView，内部自动处理缓冲池，指定reuseIdentifier
+ (instancetype)fw_reusableViewWithCollectionView:(UICollectionView *)collectionView
                                            kind:(NSString *)kind
                                       indexPath:(NSIndexPath *)indexPath
                                 reuseIdentifier:(nullable NSString *)reuseIdentifier NS_REFINED_FOR_SWIFT;

/// 根据配置自动计算view大小，子类可重写
+ (CGSize)fw_sizeWithCollectionView:(UICollectionView *)collectionView
                            kind:(NSString *)kind
                   configuration:(FWReusableViewConfigurationBlock)configuration NS_REFINED_FOR_SWIFT;

/// 根据配置自动计算view大小，固定宽度，子类可重写
+ (CGSize)fw_sizeWithCollectionView:(UICollectionView *)collectionView
                           width:(CGFloat)width
                            kind:(NSString *)kind
                   configuration:(FWReusableViewConfigurationBlock)configuration NS_REFINED_FOR_SWIFT;

/// 根据配置自动计算view大小，固定高度，子类可重写
+ (CGSize)fw_sizeWithCollectionView:(UICollectionView *)collectionView
                          height:(CGFloat)height
                            kind:(NSString *)kind
                   configuration:(FWReusableViewConfigurationBlock)configuration NS_REFINED_FOR_SWIFT;

@end

extension UICollectionReusableView: SkeletonViewDelegate

Objective-C

@interface UICollectionViewCell (FWDynamicLayout)

/// 如果用来确定Cell所需尺寸的View是唯一的，请把此值设置为YES，可提升一定的性能
@property (nonatomic, assign) BOOL fw_maxYViewFixed NS_REFINED_FOR_SWIFT;

/// 最大Y视图的底部内边距(横向滚动时为X)，可避免新创建View来撑开Cell，默认0
@property (nonatomic, assign) CGFloat fw_maxYViewPadding NS_REFINED_FOR_SWIFT;

/// 最大Y视图是否撑开布局(横向滚动时为X)，需布局约束完整。默认NO，无需撑开布局；YES时padding不起作用
@property (nonatomic, assign) BOOL fw_maxYViewExpanded NS_REFINED_FOR_SWIFT;

/// 免注册创建UICollectionViewCell，内部自动处理缓冲池
+ (instancetype)fw_cellWithCollectionView:(UICollectionView *)collectionView
                               indexPath:(NSIndexPath *)indexPath NS_REFINED_FOR_SWIFT;

/// 免注册创建UICollectionViewCell，内部自动处理缓冲池，指定reuseIdentifier
+ (instancetype)fw_cellWithCollectionView:(UICollectionView *)collectionView
                               indexPath:(NSIndexPath *)indexPath
                         reuseIdentifier:(nullable NSString *)reuseIdentifier NS_REFINED_FOR_SWIFT;

/// 根据配置自动计算view大小，子类可重写
+ (CGSize)fw_sizeWithCollectionView:(UICollectionView *)collectionView
                   configuration:(FWCollectionCellConfigurationBlock)configuration NS_REFINED_FOR_SWIFT;

/// 根据配置自动计算view大小，固定宽度，子类可重写
+ (CGSize)fw_sizeWithCollectionView:(UICollectionView *)collectionView
                           width:(CGFloat)width
                   configuration:(FWCollectionCellConfigurationBlock)configuration NS_REFINED_FOR_SWIFT;

/// 根据配置自动计算view大小，固定高度，子类可重写
+ (CGSize)fw_sizeWithCollectionView:(UICollectionView *)collectionView
                          height:(CGFloat)height
                   configuration:(FWCollectionCellConfigurationBlock)configuration NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface UIApplication (FWAdaptive)

/// 是否是调试模式
@property (class, nonatomic, assign, readonly) BOOL fw_isDebug NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface UIDevice (FWAdaptive)

/// 是否是模拟器
@property (class, nonatomic, assign, readonly) BOOL fw_isSimulator NS_REFINED_FOR_SWIFT;

/// 是否是iPhone
@property (class, nonatomic, assign, readonly) BOOL fw_isIphone NS_REFINED_FOR_SWIFT;
/// 是否是iPad
@property (class, nonatomic, assign, readonly) BOOL fw_isIpad NS_REFINED_FOR_SWIFT;
/// 是否是Mac
@property (class, nonatomic, assign, readonly) BOOL fw_isMac NS_REFINED_FOR_SWIFT;

/// 界面是否横屏
@property (class, nonatomic, assign, readonly) BOOL fw_isLandscape NS_REFINED_FOR_SWIFT;
/// 设备是否横屏，无论支不支持横屏
@property (class, nonatomic, assign, readonly) BOOL fw_isDeviceLandscape NS_REFINED_FOR_SWIFT;
/// 设置界面方向，支持旋转方向时生效
+ (BOOL)fw_setDeviceOrientation:(UIDeviceOrientation)orientation NS_REFINED_FOR_SWIFT;

/// iOS系统版本
@property (class, nonatomic, assign, readonly) double fw_iosVersion NS_REFINED_FOR_SWIFT;
/// 是否是指定iOS主版本
+ (BOOL)fw_isIos:(NSInteger)version NS_REFINED_FOR_SWIFT;
/// 是否是大于等于指定iOS主版本
+ (BOOL)fw_isIosLater:(NSInteger)version NS_REFINED_FOR_SWIFT;

/// 设备尺寸，跟横竖屏无关
@property (class, nonatomic, assign, readonly) CGSize fw_deviceSize NS_REFINED_FOR_SWIFT;
/// 设备宽度，跟横竖屏无关
@property (class, nonatomic, assign, readonly) CGFloat fw_deviceWidth NS_REFINED_FOR_SWIFT;
/// 设备高度，跟横竖屏无关
@property (class, nonatomic, assign, readonly) CGFloat fw_deviceHeight NS_REFINED_FOR_SWIFT;
/// 设备分辨率，跟横竖屏无关
@property (class, nonatomic, assign, readonly) CGSize fw_deviceResolution NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface UIScreen (FWAdaptive)

/// 屏幕尺寸
@property (class, nonatomic, assign, readonly) CGSize fw_screenSize NS_REFINED_FOR_SWIFT;
/// 屏幕宽度
@property (class, nonatomic, assign, readonly) CGFloat fw_screenWidth NS_REFINED_FOR_SWIFT;
/// 屏幕高度
@property (class, nonatomic, assign, readonly) CGFloat fw_screenHeight NS_REFINED_FOR_SWIFT;
/// 屏幕像素比例
@property (class, nonatomic, assign, readonly) CGFloat fw_screenScale NS_REFINED_FOR_SWIFT;
/// 是否是指定英寸屏幕
+ (BOOL)fw_isScreenInch:(FWScreenInch)inch NS_REFINED_FOR_SWIFT;
/// 是否是全面屏屏幕
@property (class, nonatomic, assign, readonly) BOOL fw_isNotchedScreen NS_REFINED_FOR_SWIFT;

/// 获取一像素的大小
@property (class, nonatomic, assign, readonly) CGFloat fw_pixelOne NS_REFINED_FOR_SWIFT;
/// 检查是否含有安全区域，可用来判断iPhoneX
@property (class, nonatomic, assign, readonly) BOOL fw_hasSafeAreaInsets NS_REFINED_FOR_SWIFT;
/// 获取安全区域距离
@property (class, nonatomic, assign, readonly) UIEdgeInsets fw_safeAreaInsets NS_REFINED_FOR_SWIFT;

/// 状态栏高度，与是否隐藏无关
@property (class, nonatomic, assign, readonly) CGFloat fw_statusBarHeight NS_REFINED_FOR_SWIFT;
/// 导航栏高度，与是否隐藏无关
@property (class, nonatomic, assign, readonly) CGFloat fw_navigationBarHeight NS_REFINED_FOR_SWIFT;
/// 顶部栏高度，包含状态栏、导航栏，与是否隐藏无关
@property (class, nonatomic, assign, readonly) CGFloat fw_topBarHeight NS_REFINED_FOR_SWIFT;
/// 标签栏高度，与是否隐藏无关
@property (class, nonatomic, assign, readonly) CGFloat fw_tabBarHeight NS_REFINED_FOR_SWIFT;
/// 工具栏高度，与是否隐藏无关
@property (class, nonatomic, assign, readonly) CGFloat fw_toolBarHeight NS_REFINED_FOR_SWIFT;

/// 指定等比例缩放参考设计图尺寸，默认{375,812}，宽度常用
@property (class, nonatomic, assign) CGSize fw_referenceSize NS_REFINED_FOR_SWIFT;
/// 获取当前屏幕宽度缩放比例，宽度常用
@property (class, nonatomic, assign, readonly) CGFloat fw_relativeScale NS_REFINED_FOR_SWIFT;
/// 获取当前屏幕高度缩放比例，高度不常用
@property (class, nonatomic, assign, readonly) CGFloat fw_relativeHeightScale NS_REFINED_FOR_SWIFT;

/// 获取相对设计图宽度等比例缩放值
+ (CGFloat)fw_relativeValue:(CGFloat)value NS_REFINED_FOR_SWIFT;

/// 获取相对设计图高度等比例缩放值
+ (CGFloat)fw_relativeHeight:(CGFloat)value NS_REFINED_FOR_SWIFT;

/// 获取相对设计图宽度等比例缩放时的固定宽度值
+ (CGFloat)fw_fixedValue:(CGFloat)value NS_REFINED_FOR_SWIFT;

/// 获取相对设计图高度等比例缩放时的固定高度值
+ (CGFloat)fw_fixedHeight:(CGFloat)value NS_REFINED_FOR_SWIFT;

/// 基于当前设备的屏幕倍数，对传进来的floatValue进行像素取整
+ (CGFloat)fw_flatValue:(CGFloat)value NS_REFINED_FOR_SWIFT;

/// 基于指定的倍数(0取当前设备)，对传进来的floatValue进行像素取整
+ (CGFloat)fw_flatValue:(CGFloat)value scale:(CGFloat)scale NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSObject (FWAppearance)

/// 从 appearance 里取值并赋值给当前实例，通常在对象的 init 里调用
- (void)fw_applyAppearance NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface UINavigationBar (FWBarAppearance)

Objective-C

@interface UITabBar (FWBarAppearance)

Objective-C

@interface UIToolbar (FWBarAppearance)

Objective-C

@interface NSTimer (FWBlock)

/**
 创建NSTimer，使用target-action，自动CommonModes添加到当前的运行循环中，避免ScrollView滚动时不触发
 
 @param seconds 时间
 @param target 目标
 @param selector 方法
 @param userInfo 参数
 @param repeats 是否重复
 @return 定时器
 */
+ (NSTimer *)fw_commonTimerWithTimeInterval:(NSTimeInterval)seconds target:(id)target selector:(SEL)selector userInfo:(nullable id)userInfo repeats:(BOOL)repeats NS_REFINED_FOR_SWIFT;

/**
 创建NSTimer，使用block，自动CommonModes添加到当前的运行循环中，避免ScrollView滚动时不触发
 
 @param seconds 时间
 @param block 代码块
 @param repeats 是否重复
 @return 定时器
 */
+ (NSTimer *)fw_commonTimerWithTimeInterval:(NSTimeInterval)seconds block:(void (^)(NSTimer *timer))block repeats:(BOOL)repeats NS_REFINED_FOR_SWIFT;

/**
 创建倒计时定时器
 
 @param seconds 倒计时描述
 @param block 每秒执行block，为0时自动停止
 @return 定时器，可手工停止
 */
+ (NSTimer *)fw_commonTimerWithCountDown:(NSInteger)seconds block:(void (^)(NSInteger countDown))block NS_REFINED_FOR_SWIFT;

/**
 创建NSTimer，使用block，需要调用addTimer:forMode:安排到当前的运行循环中(CommonModes避免ScrollView滚动时不触发)。
 @note 示例：[[NSRunLoop currentRunLoop] addTimer:timer forMode:NSRunLoopCommonModes]
 
 @param seconds 时间
 @param block 代码块
 @param repeats 是否重复
 @return 定时器
 */
+ (NSTimer *)fw_timerWithTimeInterval:(NSTimeInterval)seconds block:(void (^)(NSTimer *timer))block repeats:(BOOL)repeats NS_REFINED_FOR_SWIFT;

/**
 创建NSTimer，使用block，默认模式安排到当前的运行循环中
 
 @param seconds 时间
 @param block 代码块
 @param repeats 是否重复
 @return 定时器
 */
+ (NSTimer *)fw_scheduledTimerWithTimeInterval:(NSTimeInterval)seconds block:(void (^)(NSTimer *timer))block repeats:(BOOL)repeats NS_REFINED_FOR_SWIFT;

/// 暂停NSTimer
- (void)fw_pauseTimer NS_REFINED_FOR_SWIFT;

/// 开始NSTimer
- (void)fw_resumeTimer NS_REFINED_FOR_SWIFT;

/// 延迟delay秒后开始NSTimer
- (void)fw_resumeTimerAfterDelay:(NSTimeInterval)delay NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface UIGestureRecognizer (FWBlock)

/// 添加事件句柄，返回唯一标志
- (NSString *)fw_addBlock:(void (^)(id sender))block NS_REFINED_FOR_SWIFT;

/// 根据唯一标志移除事件句柄
- (void)fw_removeBlock:(nullable NSString *)identifier NS_REFINED_FOR_SWIFT;

/// 移除所有事件句柄
- (void)fw_removeAllBlocks NS_REFINED_FOR_SWIFT;

/// 从事件句柄初始化
+ (instancetype)fw_gestureRecognizerWithBlock:(void (^)(id sender))block NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface UIControl (FWBlock)

/// 添加事件句柄
- (NSString *)fw_addBlock:(void (^)(id sender))block forControlEvents:(UIControlEvents)controlEvents NS_REFINED_FOR_SWIFT;

/// 根据唯一标志移除事件句柄
- (void)fw_removeBlock:(nullable NSString *)identifier forControlEvents:(UIControlEvents)controlEvents NS_REFINED_FOR_SWIFT;

/// 移除所有事件句柄
- (void)fw_removeAllBlocksForControlEvents:(UIControlEvents)controlEvents NS_REFINED_FOR_SWIFT;

/// 添加点击事件
- (void)fw_addTouchTarget:(id)target action:(SEL)action NS_REFINED_FOR_SWIFT;

/// 添加点击句柄
- (NSString *)fw_addTouchBlock:(void (^)(id sender))block NS_REFINED_FOR_SWIFT;

/// 根据唯一标志移除点击句柄
- (void)fw_removeTouchBlock:(nullable NSString *)identifier NS_REFINED_FOR_SWIFT;

/// 移除所有点击句柄
- (void)fw_removeAllTouchBlocks NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface UIBarButtonItem (FWBlock)

Objective-C

@interface NSString (FWEncode)

#pragma mark - Json

/**
 Foundation对象编码为json字符串
 
 @param object 编码对象
 @return json字符串
 */
+ (nullable NSString *)fw_jsonEncode:(id)object NS_REFINED_FOR_SWIFT;

/**
 *  json字符串解码为Foundation对象
 *
 *  @return Foundation对象
 */
- (nullable id)fw_jsonDecode NS_REFINED_FOR_SWIFT;

#pragma mark - Base64

/**
 *  base64编码
 *
 *  @return base64字符串
 */
- (nullable NSString *)fw_base64Encode NS_REFINED_FOR_SWIFT;

/**
 *  base64解码
 *
 *  @return 原字符串
 */
- (nullable NSString *)fw_base64Decode NS_REFINED_FOR_SWIFT;

#pragma mark - Unicode

/**
 *  计算长度，中文为1，英文为0.5
 */
- (NSUInteger)fw_unicodeLength NS_REFINED_FOR_SWIFT;

/**
 *  截取字符串，中文为1，英文为0.5
 *
 *  @param length 截取长度
 */
- (NSString *)fw_unicodeSubstring:(NSUInteger)length NS_REFINED_FOR_SWIFT;

/**
 *  Unicode中文编码，将中文转换成Unicode字符串(如\u7E8C)
 *
 *  @return Unicode字符串
 */
- (NSString *)fw_unicodeEncode NS_REFINED_FOR_SWIFT;

/**
 *  Unicode中文解码，将Unicode字符串(如\u7E8C)转换成中文
 *
 *  @return 中文字符串
 */
- (NSString *)fw_unicodeDecode NS_REFINED_FOR_SWIFT;

#pragma mark - Url

/**
 *  url参数编码，适用于query参数编码
 *  示例：http://test.com?id=我是中文 =>
 *       http%3A%2F%2Ftest.com%3Fid%3D%E6%88%91%E6%98%AF%E4%B8%AD%E6%96%87
 *
 *  @return url编码字符串
 */
- (nullable NSString *)fw_urlEncodeComponent NS_REFINED_FOR_SWIFT;

/**
 *  url参数解码，适用于query参数解码
 *  示例：http%3A%2F%2Ftest.com%3Fid%3D%E6%88%91%E6%98%AF%E4%B8%AD%E6%96%87 =>
 *       http://test.com?id=我是中文
 *
 *  @return 原字符串
 */
- (nullable NSString *)fw_urlDecodeComponent NS_REFINED_FOR_SWIFT;

/**
 *  url编码，适用于整个url编码
 *  示例：http://test.com?id=我是中文 =>
 *       http://test.com?id=%E6%88%91%E6%98%AF%E4%B8%AD%E6%96%87
 *
 *  @return url编码地址
 */
- (nullable NSString *)fw_urlEncode NS_REFINED_FOR_SWIFT;

/**
 *  url解码，适用于整个url解码
 *  示例：http://test.com?id=%E6%88%91%E6%98%AF%E4%B8%AD%E6%96%87 =>
 *       http://test.com?id=我是中文
 *
 *  @return 原url地址
 */
- (nullable NSString *)fw_urlDecode NS_REFINED_FOR_SWIFT;

#pragma mark - Query

/**
 * 字典编码为URL参数字符串
 */
+ (NSString *)fw_queryEncode:(NSDictionary<NSString *, id> *)dictionary NS_REFINED_FOR_SWIFT;

/**
 * URL参数字符串解码为字典，支持完整URL
 */
- (NSDictionary<NSString *, NSString *> *)fw_queryDecode NS_REFINED_FOR_SWIFT;

#pragma mark - Md5

/**
 *  md5编码
 *
 *  @return md5字符串
 */
- (NSString *)fw_md5Encode NS_REFINED_FOR_SWIFT;

/**
 *  文件md5编码
 *
 *  @return md5字符串
 */
- (nullable NSString *)fw_md5EncodeFile NS_REFINED_FOR_SWIFT;

#pragma mark - Helper

/**
 去掉空白字符
 */
@property (nonatomic, copy, readonly) NSString *fw_trimString NS_REFINED_FOR_SWIFT;

/**
 首字母大写
 */
@property (nonatomic, copy, readonly) NSString *fw_ucfirstString NS_REFINED_FOR_SWIFT;

/**
 首字母小写
 */
@property (nonatomic, copy, readonly) NSString *fw_lcfirstString NS_REFINED_FOR_SWIFT;

/**
 驼峰转下划线
 */
@property (nonatomic, copy, readonly) NSString *fw_underlineString NS_REFINED_FOR_SWIFT;

/**
 下划线转驼峰
 */
@property (nonatomic, copy, readonly) NSString *fw_camelString NS_REFINED_FOR_SWIFT;

/**
 中文转拼音
 */
@property (nonatomic, copy, readonly) NSString *fw_pinyinString NS_REFINED_FOR_SWIFT;

/**
 过滤JSON解码特殊字符
 
 兼容\uD800-\uDFFF引起JSON解码报错3840问题，不报错时无需调用
 规则：只允许以\uD800-\uDBFF高位开头，紧跟\uDC00-\uDFFF低位；其他全不允许
 参考：https://github.com/SBJson/SBJson/blob/trunk/Classes/SBJson5StreamTokeniser.m
 */
@property (nonatomic, copy, readonly) NSString *fw_escapeJson NS_REFINED_FOR_SWIFT;

/**
 转换为UTF8编码数据
 */
@property (nonatomic, strong, readonly, nullable) NSData *fw_utf8Data NS_REFINED_FOR_SWIFT;

/**
 转换为NSURL
 */
@property (nonatomic, copy, readonly, nullable) NSURL *fw_url NS_REFINED_FOR_SWIFT;

/**
 转换为NSNumber
 */
@property (nonatomic, readonly, nullable) NSNumber *fw_number NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSData (FWEncode)

#pragma mark - Json

/**
 Foundation对象编码为json数据
 
 @param object 编码对象
 @return json数据
 */
+ (nullable NSData *)fw_jsonEncode:(id)object NS_REFINED_FOR_SWIFT;

/**
 json数据解码为Foundation对象

 @return Foundation对象
 */
- (nullable id)fw_jsonDecode NS_REFINED_FOR_SWIFT;

#pragma mark - Base64

/**
 *  base64编码
 *
 *  @return base64数据
 */
- (NSData *)fw_base64Encode NS_REFINED_FOR_SWIFT;

/**
 *  base64解码
 *
 *  @return 原数据
 */
- (nullable NSData *)fw_base64Decode NS_REFINED_FOR_SWIFT;

#pragma mark - Helper

/**
 转换为UTF8编码字符串
 
 @return UTF8编码字符串
 */
@property (nonatomic, copy, readonly, nullable) NSString *fw_utf8String NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSURL (FWEncode)

/// 获取当前query的参数字典，不含空值
@property (nonatomic, copy, readonly) NSDictionary<NSString *, NSString *> *fw_queryDictionary NS_REFINED_FOR_SWIFT;

/// 获取基准URI字符串，不含path|query|fragment等，包含scheme|host|port等
@property (nonatomic, copy, readonly, nullable) NSString *fw_baseURI NS_REFINED_FOR_SWIFT;

/// 获取路径URI字符串，不含scheme|host|port等，包含path|query|fragment等
@property (nonatomic, copy, readonly, nullable) NSString *fw_pathURI NS_REFINED_FOR_SWIFT;

/// 生成URL，中文自动URL编码
+ (nullable NSURL *)fw_urlWithString:(nullable NSString *)string NS_REFINED_FOR_SWIFT;

/// 生成URL，中文自动URL编码
+ (nullable NSURL *)fw_urlWithString:(nullable NSString *)string relativeTo:(nullable NSURL *)baseURL NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSObject (FWSafeType)

/**
 是否是非Null(nil, NSNull)
 
 @return 如果为非Null返回YES，为Null返回NO
 */
@property (nonatomic, assign, readonly) BOOL fw_isNotNull NS_REFINED_FOR_SWIFT;

/**
 是否是非空对象(nil, NSNull, count为0, length为0)
 
 @return 如果是非空对象返回YES，为空对象返回NO
 */
@property (nonatomic, assign, readonly) BOOL fw_isNotEmpty NS_REFINED_FOR_SWIFT;

/**
 检测并安全转换为NSInteger
 
 @return NSInteger
 */
@property (nonatomic, assign, readonly) NSInteger fw_safeInteger NS_REFINED_FOR_SWIFT;

/**
 检测并安全转换为Float
 
 @return Float
 */
@property (nonatomic, assign, readonly) float fw_safeFloat NS_REFINED_FOR_SWIFT;

/**
 检测并安全转换为Double
 
 @return Double
 */
@property (nonatomic, assign, readonly) double fw_safeDouble NS_REFINED_FOR_SWIFT;

/**
 检测并安全转换为Bool
 
 @return Bool
 */
@property (nonatomic, assign, readonly) BOOL fw_safeBool NS_REFINED_FOR_SWIFT;

/**
 检测并安全转换为NSNumber
 
 @return NSNumber
 */
@property (nonatomic, strong, readonly) NSNumber *fw_safeNumber NS_REFINED_FOR_SWIFT;

/**
 检测并安全转换为NSString
 
 @return NSString
 */
@property (nonatomic, copy, readonly) NSString *fw_safeString NS_REFINED_FOR_SWIFT;

/**
 检测并安全转换为NSDate
 
 @return NSDate
 */
@property (nonatomic, strong, readonly) NSDate *fw_safeDate NS_REFINED_FOR_SWIFT;

/**
 检测并安全转换为NSData
 
 @return NSData
 */
@property (nonatomic, strong, readonly) NSData *fw_safeData NS_REFINED_FOR_SWIFT;

/**
 检测并安全转换为NSArray
 
 @return NSArray
 */
@property (nonatomic, strong, readonly) NSArray *fw_safeArray NS_REFINED_FOR_SWIFT;

/**
 检测并安全转换为NSMutableArray
 
 @return NSMutableArray
 */
@property (nonatomic, strong, readonly) NSMutableArray *fw_safeMutableArray NS_REFINED_FOR_SWIFT;

/**
 检测并安全转换为NSDictionary
 
 @return NSDictionary
 */
@property (nonatomic, strong, readonly) NSDictionary *fw_safeDictionary NS_REFINED_FOR_SWIFT;

/**
 检测并安全转换为NSMutableDictionary
 
 @return NSMutableDictionary
 */
@property (nonatomic, strong, readonly) NSMutableDictionary *fw_safeMutableDictionary NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSString (FWSafeType)

/**
 从指定位置截取子串
 
 @param from 起始位置
 @return 子串
 */
- (nullable NSString *)fw_substringFromIndex:(NSInteger)from NS_REFINED_FOR_SWIFT;

/**
 截取子串到指定位置
 
 @param to 结束位置
 @return 子串
 */
- (nullable NSString *)fw_substringToIndex:(NSInteger)to NS_REFINED_FOR_SWIFT;

/**
 截取指定范围的子串
 
 @param range 指定范围
 @return 子串
 */
- (nullable NSString *)fw_substringWithRange:(NSRange)range NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSArray<__covariant ObjectType> (FWSafeType)

/**
 安全获取对象
 
 @param index 索引
 @return 对象
 */
- (nullable ObjectType)fw_objectAtIndex:(NSInteger)index NS_REFINED_FOR_SWIFT;

/**
 安全获取子数组
 
 @param range 范围
 @return 对象数组
 */
- (nullable NSArray<ObjectType> *)fw_subarrayWithRange:(NSRange)range NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSMutableArray<ObjectType> (FWSafeType)

/**
 安全添加对象
 
 @param object 对象
 */
- (void)fw_addObject:(nullable ObjectType)object NS_REFINED_FOR_SWIFT;

/**
 安全移除指定索引对象
 
 @param index 索引
 */
- (void)fw_removeObjectAtIndex:(NSInteger)index NS_REFINED_FOR_SWIFT;

/**
 安全插入对象到指定位置
 
 @param object 对象
 @param index 索引
 */
- (void)fw_insertObject:(nullable ObjectType)object atIndex:(NSInteger)index NS_REFINED_FOR_SWIFT;

/**
 安全替换对象到指定位置
 
 @param index 索引
 @param object 对象
 */
- (void)fw_replaceObjectAtIndex:(NSInteger)index withObject:(nullable ObjectType)object NS_REFINED_FOR_SWIFT;

/**
 安全移除子数组
 
 @param range 范围
 */
- (void)fw_removeObjectsInRange:(NSRange)range NS_REFINED_FOR_SWIFT;

/**
 安全插入数组到指定位置
 
 @param objects 要插入的数组
 @param index 索引
 */
- (void)fw_insertObjects:(nullable NSArray *)objects atIndex:(NSInteger)index NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSMutableSet<ObjectType> (FWSafeType)

/**
 安全添加对象
 
 @param object 对象
 */
- (void)fw_addObject:(nullable ObjectType)object NS_REFINED_FOR_SWIFT;

/**
 安全移除对象
 
 @param object 对象
 */
- (void)fw_removeObject:(nullable ObjectType)object NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSDictionary<__covariant KeyType, __covariant ObjectType> (FWSafeType)

/**
 安全读取对象（过滤NSNull）
 
 @param key 键名
 @return 键值
 */
- (nullable ObjectType)fw_objectForKey:(nullable KeyType)key NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSMutableDictionary<KeyType, ObjectType> (FWSafeType)

/**
 安全移除指定键名
 
 @param key 键名
 */
- (void)fw_removeObjectForKey:(nullable KeyType)key NS_REFINED_FOR_SWIFT;

/**
 安全设置对象（过滤NSNull）

 @param object 键值
 @param key 键名
 */
- (void)fw_setObject:(nullable ObjectType)object forKey:(nullable KeyType <NSCopying>)key NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSArray<__covariant ObjectType> (FWFoundation)

/// 过滤数组元素，返回YES的obj重新组装成一个数组
- (NSArray<ObjectType> *)fw_filterWithBlock:(BOOL (^)(ObjectType obj))block NS_REFINED_FOR_SWIFT;

/// 映射数组元素，返回的obj重新组装成一个数组
- (NSArray *)fw_mapWithBlock:(id _Nullable (^)(ObjectType obj))block NS_REFINED_FOR_SWIFT;

/// 匹配数组第一个元素，返回满足条件的第一个obj
- (nullable ObjectType)fw_matchWithBlock:(BOOL (^)(ObjectType obj))block NS_REFINED_FOR_SWIFT;

/// 从数组中随机取出对象，如@[@"a", @"b", @"c"]随机取出@"b"
@property (nullable, nonatomic, readonly) ObjectType fw_randomObject NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSAttributedString (FWFoundation)

Objective-C

@interface NSData (FWFoundation)

/// 使用NSKeyedUnarchiver解压数据
- (nullable id)fw_unarchiveObject:(Class)clazz NS_REFINED_FOR_SWIFT;

/// 使用NSKeyedArchiver压缩对象
+ (nullable NSData *)fw_archiveObject:(id)object NS_REFINED_FOR_SWIFT;

/// 保存对象归档
+ (BOOL)fw_archiveObject:(id)object toFile:(NSString *)path NS_REFINED_FOR_SWIFT;

/// 读取对象归档
+ (nullable id)fw_unarchiveObject:(Class)clazz withFile:(NSString *)path NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSDate (FWFoundation)

/// 转化为字符串，默认当前时区，格式：yyyy-MM-dd HH:mm:ss
@property (nonatomic, copy, readonly) NSString *fw_stringValue NS_REFINED_FOR_SWIFT;

/// 转化为字符串，默认当前时区，自定义格式
- (NSString *)fw_stringWithFormat:(NSString *)format NS_REFINED_FOR_SWIFT;

/// 转化为字符串，自定义格式和时区
- (NSString *)fw_stringWithFormat:(NSString *)format timeZone:(nullable NSTimeZone *)timeZone NS_REFINED_FOR_SWIFT;

/// 当前时间戳，没有设置过返回本地时间戳，可同步设置服务器时间戳，同步后调整手机时间不影响
@property (class, nonatomic, assign) NSTimeInterval fw_currentTime NS_REFINED_FOR_SWIFT;

/// 从字符串初始化日期，默认当前时区，格式：yyyy-MM-dd HH:mm:ss
+ (nullable NSDate *)fw_dateWithString:(NSString *)string NS_REFINED_FOR_SWIFT;

/// 从字符串初始化日期，默认当前时区，自定义格式
+ (nullable NSDate *)fw_dateWithString:(NSString *)string format:(NSString *)format NS_REFINED_FOR_SWIFT;

/// 从字符串初始化日期，自定义格式和时区
+ (nullable NSDate *)fw_dateWithString:(NSString *)string format:(NSString *)format timeZone:(nullable NSTimeZone *)timeZone NS_REFINED_FOR_SWIFT;

/// 格式化时长，格式"00:00"或"00:00:00"
+ (NSString *)fw_formatDuration:(NSTimeInterval)duration hasHour:(BOOL)hasHour NS_REFINED_FOR_SWIFT;

/// 格式化16位、13位时间戳为10位(秒)
+ (NSTimeInterval)fw_formatTimestamp:(NSTimeInterval)timestamp NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSDictionary<__covariant KeyType, __covariant ObjectType> (FWFoundation)

/// 过滤字典元素，如果block返回NO，则去掉该元素
- (NSDictionary<KeyType, ObjectType> *)fw_filterWithBlock:(BOOL (^)(KeyType key, ObjectType obj))block NS_REFINED_FOR_SWIFT;

/// 映射字典元素，返回的obj重新组装成一个字典
- (NSDictionary *)fw_mapWithBlock:(id _Nullable (^)(KeyType key, ObjectType obj))block NS_REFINED_FOR_SWIFT;

/// 匹配字典第一个元素，返回满足条件的第一个obj
- (nullable ObjectType)fw_matchWithBlock:(BOOL (^)(KeyType key, ObjectType obj))block NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSObject (FWFoundation)

/// 执行加锁(支持任意对象)，等待信号量，自动创建信号量
- (void)fw_lock NS_REFINED_FOR_SWIFT;

/// 执行解锁(支持任意对象)，发送信号量，自动创建信号量
- (void)fw_unlock NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSString (FWFoundation)

/// 计算单行字符串指定字体所占尺寸
- (CGSize)fw_sizeWithFont:(UIFont *)font NS_REFINED_FOR_SWIFT;

/// 计算多行字符串指定字体在指定绘制区域内所占尺寸
- (CGSize)fw_sizeWithFont:(UIFont *)font drawSize:(CGSize)drawSize NS_REFINED_FOR_SWIFT;

/// 计算多行字符串指定字体、指定属性在指定绘制区域内所占尺寸
- (CGSize)fw_sizeWithFont:(UIFont *)font drawSize:(CGSize)drawSize attributes:(nullable NSDictionary<NSAttributedStringKey, id> *)attributes NS_REFINED_FOR_SWIFT;

/// 是否匹配正则表达式，示例：^[a-zA-Z0-9_\u4e00-\u9fa5]{4,14}$
- (BOOL)fw_matchesRegex:(NSString *)regex NS_REFINED_FOR_SWIFT;

/// 格式化文件大小为".0K/.1M/.1G"
+ (NSString *)fw_sizeString:(NSUInteger)fileSize NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSUserDefaults (FWFoundation)

/// 读取对象，支持unarchive对象
- (nullable id)fw_objectForKey:(NSString *)key NS_REFINED_FOR_SWIFT;

/// 保存对象，支持archive对象
- (void)fw_setObject:(nullable id)object forKey:(NSString *)key NS_REFINED_FOR_SWIFT;

/// 从standard读取对象，支持unarchive对象
+ (nullable id)fw_objectForKey:(NSString *)key NS_REFINED_FOR_SWIFT;

/// 保存对象到standard，支持archive对象
+ (void)fw_setObject:(nullable id)object forKey:(NSString *)key NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface FWAutoloader (FWFramework_Swift_383)

Objective-C

@interface FWAutoloader (FWFramework_Swift_391)

Objective-C

@interface FWPromise (FWFramework_Swift_521)

Objective-C

@interface UIDevice (SWIFT_EXTENSION(FWFramework))
/// 获取或设置设备UUID，自动keychain持久化。默认获取IDFV(未使用IDFA，避免额外权限)，失败则随机生成一个
SWIFT_CLASS_PROPERTY(@property (nonatomic, class, copy) NSString * _Nonnull fw_deviceUUID;)
+ (NSString * _Nonnull)fw_deviceUUID SWIFT_WARN_UNUSED_RESULT;
+ (void)setFw_deviceUUID:(NSString * _Nonnull)newValue;
@end

Objective-C

@interface UITextField (FWKeyboard)

Objective-C

@interface NSBundle (FWLanguage)

Objective-C

@interface NSString (FWLanguage)

/// 快速读取本地化语言
@property (nonatomic, copy, readonly) NSString *fw_localized NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSObject (FWMessage)

#pragma mark - Observer

/**
 监听某个点对点消息，对象释放时自动移除监听，添加多次执行多次
 
 @param name  消息名称
 @param block 消息句柄
 @return 监听唯一标志
 */
- (NSString *)fw_observeMessage:(NSNotificationName)name block:(void (^)(NSNotification *notification))block NS_REFINED_FOR_SWIFT;

/**
 监听某个指定对象点对点消息，对象释放时自动移除监听，添加多次执行多次
 
 @param name   消息名称
 @param object 消息对象，值为nil时表示所有
 @param block  消息句柄
 @return 监听唯一标志
 */
- (NSString *)fw_observeMessage:(NSNotificationName)name object:(nullable id)object block:(void (^)(NSNotification *notification))block NS_REFINED_FOR_SWIFT;

/**
 监听某个点对点消息，对象释放时自动移除监听，添加多次执行多次
 
 @param name   消息名称
 @param target 消息目标
 @param action 目标动作，参数为通知对象
 @return 监听唯一标志
 */
- (NSString *)fw_observeMessage:(NSNotificationName)name target:(nullable id)target action:(SEL)action NS_REFINED_FOR_SWIFT;

/**
 监听某个指定对象点对点消息，对象释放时自动移除监听，添加多次执行多次
 
 @param name   消息名称
 @param object 消息对象，值为nil时表示所有
 @param target 消息目标
 @param action 目标动作，参数为通知对象
 @return 监听唯一标志
 */
- (NSString *)fw_observeMessage:(NSNotificationName)name object:(nullable id)object target:(nullable id)target action:(SEL)action NS_REFINED_FOR_SWIFT;

/**
 手工移除某个点对点消息指定监听
 
 @param name   消息名称
 @param target 消息目标
 @param action 目标动作
 */
- (void)fw_unobserveMessage:(NSNotificationName)name target:(nullable id)target action:(nullable SEL)action NS_REFINED_FOR_SWIFT;

/**
 手工移除某个指定对象点对点消息指定监听
 
 @param name   消息名称
 @param object 消息对象，值为nil时表示所有
 @param target 消息目标
 @param action 目标动作
 */
- (void)fw_unobserveMessage:(NSNotificationName)name object:(nullable id)object target:(nullable id)target action:(nullable SEL)action NS_REFINED_FOR_SWIFT;

/**
 手工移除某个指定对象点对点消息指定监听
 
 @param name       消息名称
 @param identifier 监听唯一标志
 */
- (void)fw_unobserveMessage:(NSNotificationName)name identifier:(NSString *)identifier NS_REFINED_FOR_SWIFT;

/**
 手工移除某个点对点消息所有监听
 
 @param name 消息名称
 */
- (void)fw_unobserveMessage:(NSNotificationName)name NS_REFINED_FOR_SWIFT;

/**
 手工移除某个指定对象点对点消息所有监听
 
 @param name   消息名称
 @param object 消息对象，值为nil时表示所有
 */
- (void)fw_unobserveMessage:(NSNotificationName)name object:(nullable id)object NS_REFINED_FOR_SWIFT;

/**
 手工移除所有点对点消息监听
 */
- (void)fw_unobserveAllMessages NS_REFINED_FOR_SWIFT;

#pragma mark - Subject

/**
 发送点对点消息
 
 @param name 消息名称
 @param receiver 消息接收者
 */
- (void)fw_sendMessage:(NSNotificationName)name toReceiver:(id)receiver NS_REFINED_FOR_SWIFT;

/**
 发送点对点消息，附带对象
 
 @param name   消息名称
 @param object 消息对象
 @param receiver 消息接收者
 */
- (void)fw_sendMessage:(NSNotificationName)name object:(nullable id)object toReceiver:(id)receiver NS_REFINED_FOR_SWIFT;

/**
 发送点对点消息，附带对象和用户信息
 
 @param name     消息名称
 @param object   消息对象
 @param userInfo 用户信息
 @param receiver 消息接收者
 */
- (void)fw_sendMessage:(NSNotificationName)name object:(nullable id)object userInfo:(nullable NSDictionary *)userInfo toReceiver:(id)receiver NS_REFINED_FOR_SWIFT;

/**
 发送类点对点消息
 
 @param name 消息名称
 @param receiver 消息接收者
 */
+ (void)fw_sendMessage:(NSNotificationName)name toReceiver:(id)receiver NS_REFINED_FOR_SWIFT;

/**
 发送类点对点消息，附带对象
 
 @param name   消息名称
 @param object 消息对象
 @param receiver 消息接收者
 */
+ (void)fw_sendMessage:(NSNotificationName)name object:(nullable id)object toReceiver:(id)receiver NS_REFINED_FOR_SWIFT;

/**
 发送类点对点消息，附带对象和用户信息
 
 @param name     消息名称
 @param object   消息对象
 @param userInfo 用户信息
 @param receiver 消息接收者
 */
+ (void)fw_sendMessage:(NSNotificationName)name object:(nullable id)object userInfo:(nullable NSDictionary *)userInfo toReceiver:(id)receiver NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSObject (FWNotification)

#pragma mark - Observer

/**
 监听某个广播通知，对象释放时自动移除监听，添加多次执行多次
 
 @param name  通知名称
 @param block 通知句柄
 @return 监听唯一标志
 */
- (NSString *)fw_observeNotification:(NSNotificationName)name block:(void (^)(NSNotification *notification))block NS_REFINED_FOR_SWIFT;

/**
 监听某个指定对象广播通知，对象释放时自动移除监听，添加多次执行多次
 
 @param name   通知名称
 @param object 通知对象，值为nil时表示所有
 @param block  通知句柄
 @return 监听唯一标志
 */
- (NSString *)fw_observeNotification:(NSNotificationName)name object:(nullable id)object block:(void (^)(NSNotification *notification))block NS_REFINED_FOR_SWIFT;

/**
 监听某个广播通知，对象释放时自动移除监听，添加多次执行多次
 
 @param name   通知名称
 @param target 通知目标
 @param action 目标动作，参数为通知对象
 @return 监听唯一标志
 */
- (NSString *)fw_observeNotification:(NSNotificationName)name target:(nullable id)target action:(SEL)action NS_REFINED_FOR_SWIFT;

/**
 监听某个指定对象广播通知，对象释放时自动移除监听，添加多次执行多次
 
 @param name   通知名称
 @param object 通知对象，值为nil时表示所有
 @param target 通知目标
 @param action 目标动作，参数为通知对象
 @return 监听唯一标志
 */
- (NSString *)fw_observeNotification:(NSNotificationName)name object:(nullable id)object target:(nullable id)target action:(SEL)action NS_REFINED_FOR_SWIFT;

/**
 手工移除某个广播通知指定监听
 
 @param name   通知名称
 @param target 通知目标
 @param action 目标动作
 */
- (void)fw_unobserveNotification:(NSNotificationName)name target:(nullable id)target action:(nullable SEL)action NS_REFINED_FOR_SWIFT;

/**
 手工移除某个指定对象广播通知指定监听
 
 @param name   通知名称
 @param object 通知对象，值为nil时表示所有
 @param target 通知目标
 @param action 目标动作
 */
- (void)fw_unobserveNotification:(NSNotificationName)name object:(nullable id)object target:(nullable id)target action:(nullable SEL)action NS_REFINED_FOR_SWIFT;

/**
 手工移除某个指定对象广播通知指定监听
 
 @param name       通知名称
 @param identifier 监听唯一标志
 */
- (void)fw_unobserveNotification:(NSNotificationName)name identifier:(NSString *)identifier NS_REFINED_FOR_SWIFT;

/**
 手工移除某个广播通知所有监听
 
 @param name 通知名称
 */
- (void)fw_unobserveNotification:(NSNotificationName)name NS_REFINED_FOR_SWIFT;

/**
 手工移除某个指定对象广播通知所有监听
 
 @param name   通知名称
 @param object 通知对象，值为nil时表示所有
 */
- (void)fw_unobserveNotification:(NSNotificationName)name object:(nullable id)object NS_REFINED_FOR_SWIFT;

/**
 手工移除所有广播通知监听
 */
- (void)fw_unobserveAllNotifications NS_REFINED_FOR_SWIFT;

#pragma mark - Subject

/**
 发送广播通知
 
 @param name 通知名称
 */
- (void)fw_postNotification:(NSNotificationName)name NS_REFINED_FOR_SWIFT;

/**
 发送广播通知，附带对象
 
 @param name   通知名称
 @param object 通知对象
 */
- (void)fw_postNotification:(NSNotificationName)name object:(nullable id)object NS_REFINED_FOR_SWIFT;

/**
 发送广播通知，附带对象和用户信息
 
 @param name     通知名称
 @param object   通知对象
 @param userInfo 用户信息
 */
- (void)fw_postNotification:(NSNotificationName)name object:(nullable id)object userInfo:(nullable NSDictionary *)userInfo NS_REFINED_FOR_SWIFT;

/**
 发送广播通知
 
 @param name 通知名称
 */
+ (void)fw_postNotification:(NSNotificationName)name NS_REFINED_FOR_SWIFT;

/**
 发送广播通知，附带对象
 
 @param name   通知名称
 @param object 通知对象
 */
+ (void)fw_postNotification:(NSNotificationName)name object:(nullable id)object NS_REFINED_FOR_SWIFT;

/**
 发送广播通知，附带对象和用户信息
 
 @param name     通知名称
 @param object   通知对象
 @param userInfo 用户信息
 */
+ (void)fw_postNotification:(NSNotificationName)name object:(nullable id)object userInfo:(nullable NSDictionary *)userInfo NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSObject (FWKvo)

/**
 监听对象某个属性，对象释放时自动移除监听，添加多次执行多次
 
 @param property 属性名称
 @param block    目标句柄，block参数依次为object、优化的change字典(不含NSNull)
 @return 监听唯一标志
 */
- (NSString *)fw_observeProperty:(NSString *)property block:(void (^)(id object, NSDictionary<NSKeyValueChangeKey, id> *change))block NS_REFINED_FOR_SWIFT;

/**
 监听对象某个属性，对象释放时自动移除监听，添加多次执行多次
 
 @param property 属性名称
 @param target   目标对象
 @param action   目标动作，action参数依次为object、优化的change字典(不含NSNull)
 @return 监听唯一标志
 */
- (NSString *)fw_observeProperty:(NSString *)property target:(nullable id)target action:(SEL)action NS_REFINED_FOR_SWIFT;

/**
 手工移除某个属性指定监听
 
 @param property 属性名称
 @param target   目标对象，值为nil时移除所有对象(同UIControl)
 @param action   目标动作，值为nil时移除所有动作(同UIControl)
 */
- (void)fw_unobserveProperty:(NSString *)property target:(nullable id)target action:(nullable SEL)action NS_REFINED_FOR_SWIFT;

/**
 手工移除某个属性指定监听
 
 @param property   属性名称
 @param identifier 监听唯一标志
 */
- (void)fw_unobserveProperty:(NSString *)property identifier:(NSString *)identifier NS_REFINED_FOR_SWIFT;

/**
 手工移除某个属性所有监听
 
 @param property 属性名称
 */
- (void)fw_unobserveProperty:(NSString *)property NS_REFINED_FOR_SWIFT;

/**
 手工移除所有属性所有监听
 */
- (void)fw_unobserveAllProperties NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface UIWindow (FWNavigation)

/// 获取最顶部的视图控制器
@property (nonatomic, readonly, nullable) UIViewController *fw_topViewController NS_REFINED_FOR_SWIFT;

/// 获取最顶部的导航栏控制器。如果顶部VC不含导航栏，返回nil
@property (nonatomic, readonly, nullable) UINavigationController *fw_topNavigationController NS_REFINED_FOR_SWIFT;

/// 获取最顶部的显示控制器
@property (nonatomic, readonly, nullable) UIViewController *fw_topPresentedController NS_REFINED_FOR_SWIFT;

/// 使用最顶部的导航栏控制器打开控制器
- (BOOL)fw_pushViewController:(UIViewController *)viewController animated:(BOOL)animated NS_REFINED_FOR_SWIFT;

/// 使用最顶部的导航栏控制器打开控制器，同时pop指定数量控制器
- (BOOL)fw_pushViewController:(UIViewController *)viewController pop:(NSUInteger)count animated:(BOOL)animated NS_REFINED_FOR_SWIFT;

/// 使用最顶部的显示控制器弹出控制器，建议present导航栏控制器(可用来push)
- (void)fw_presentViewController:(UIViewController *)viewController animated:(BOOL)animated completion:(nullable void (^)(void))completion NS_REFINED_FOR_SWIFT;

/// 使用最顶部的视图控制器打开控制器，自动判断push|present，完成时回调
- (void)fw_openViewController:(UIViewController *)viewController animated:(BOOL)animated options:(FWNavigationOptions)options completion:(nullable void (^)(void))completion NS_REFINED_FOR_SWIFT;

/// 关闭最顶部的视图控制器，自动判断pop|dismiss，返回是否成功，完成时回调
- (BOOL)fw_closeViewControllerAnimated:(BOOL)animated options:(FWNavigationOptions)options completion:(nullable void (^)(void))completion NS_REFINED_FOR_SWIFT;

/// 获取当前主window
@property (class, nonatomic, readonly, nullable) UIWindow *fw_mainWindow NS_REFINED_FOR_SWIFT;

/// 获取当前主场景
@property (class, nonatomic, readonly, nullable) UIWindowScene *fw_mainScene API_AVAILABLE(ios(13.0)) NS_REFINED_FOR_SWIFT;

/// 获取最顶部的视图控制器
@property (class, nonatomic, readonly, nullable) UIViewController *fw_topViewController NS_REFINED_FOR_SWIFT;

/// 获取最顶部的导航栏控制器。如果顶部VC不含导航栏，返回nil
@property (class, nonatomic, readonly, nullable) UINavigationController *fw_topNavigationController NS_REFINED_FOR_SWIFT;

/// 获取最顶部的显示控制器
@property (class, nonatomic, readonly, nullable) UIViewController *fw_topPresentedController NS_REFINED_FOR_SWIFT;

/// 使用最顶部的导航栏控制器打开控制器
+ (BOOL)fw_pushViewController:(UIViewController *)viewController animated:(BOOL)animated NS_REFINED_FOR_SWIFT;

/// 使用最顶部的导航栏控制器打开控制器，同时pop指定数量控制器
+ (BOOL)fw_pushViewController:(UIViewController *)viewController pop:(NSUInteger)count animated:(BOOL)animated NS_REFINED_FOR_SWIFT;

/// 使用最顶部的显示控制器弹出控制器，建议present导航栏控制器(可用来push)
+ (void)fw_presentViewController:(UIViewController *)viewController animated:(BOOL)animated completion:(nullable void (^)(void))completion NS_REFINED_FOR_SWIFT;

/// 使用最顶部的视图控制器打开控制器，自动判断push|present，完成时回调
+ (void)fw_openViewController:(UIViewController *)viewController animated:(BOOL)animated options:(FWNavigationOptions)options completion:(nullable void (^)(void))completion NS_REFINED_FOR_SWIFT;

/// 关闭最顶部的视图控制器，自动判断pop|dismiss，返回是否成功，完成时回调
+ (BOOL)fw_closeViewControllerAnimated:(BOOL)animated options:(FWNavigationOptions)options completion:(nullable void (^)(void))completion NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface UINavigationController (FWNavigation)

#pragma mark - Navigation

/// push新界面，完成时回调
- (void)fw_pushViewController:(UIViewController *)viewController animated:(BOOL)animated completion:(nullable void (^)(void))completion NS_REFINED_FOR_SWIFT;

/// pop当前界面，完成时回调
- (nullable UIViewController *)fw_popViewControllerAnimated:(BOOL)animated completion:(nullable void (^)(void))completion NS_REFINED_FOR_SWIFT;

/// pop到指定界面，完成时回调
- (nullable NSArray<__kindof UIViewController *> *)fw_popToViewController:(UIViewController *)viewController animated:(BOOL)animated completion:(nullable void (^)(void))completion NS_REFINED_FOR_SWIFT;

/// pop到根界面，完成时回调
- (nullable NSArray<__kindof UIViewController *> *)fw_popToRootViewControllerAnimated:(BOOL)animated completion:(nullable void (^)(void))completion NS_REFINED_FOR_SWIFT;

/// 设置界面数组，完成时回调
- (void)fw_setViewControllers:(NSArray<UIViewController *> *)viewControllers animated:(BOOL)animated completion:(nullable void (^)(void))completion NS_REFINED_FOR_SWIFT;

/// push新界面，同时pop指定数量界面，至少保留一个根控制器，完成时回调
- (void)fw_pushViewController:(UIViewController *)viewController pop:(NSUInteger)count animated:(BOOL)animated completion:(nullable void (^)(void))completion NS_REFINED_FOR_SWIFT;

/// pop指定数量界面，0不会pop，至少保留一个根控制器，完成时回调
- (nullable NSArray<__kindof UIViewController *> *)fw_popViewControllers:(NSUInteger)count animated:(BOOL)animated completion:(nullable void (^)(void))completion NS_REFINED_FOR_SWIFT;

#pragma mark - Workflow

/**
 当前最外层工作流名称，即topViewController的工作流名称
 
 @return 工作流名称
 */
@property (nonatomic, copy, readonly, nullable) NSString *fw_topWorkflowName NS_REFINED_FOR_SWIFT;

/**
 push控制器，并清理最外层工作流（不属于工作流则不清理），完成时回调
 @note 示例：1、（2、3）、4、（5、6）、（7、8），操作后为1、（2、3）、4、（5、6）、9
 
 @param viewController push的控制器
 @param animated 是否执行动画
 */
- (void)fw_pushViewController:(UIViewController *)viewController popTopWorkflowAnimated:(BOOL)animated completion:(nullable void (^)(void))completion NS_REFINED_FOR_SWIFT;

/**
 push控制器，并清理非根控制器（只保留根控制器），完成时回调
 @note 示例：1、（2、3）、4、（5、6）、（7、8），操作后为1、9
 
 @param viewController push的控制器
 @param animated 是否执行动画
 */
- (void)fw_pushViewController:(UIViewController *)viewController popToRootWorkflowAnimated:(BOOL)animated completion:(nullable void (^)(void))completion NS_REFINED_FOR_SWIFT;

/**
 push控制器，并从外到内清理指定工作流，直到遇到不属于指定工作流的控制器停止，完成时回调
 @note 示例：1、（2、3）、4、（5、6）、（7、8），操作后为1、（2、3）、4、9
 
 @param viewController push的控制器
 @param workflows 指定工作流
 @param animated 是否执行动画
 */
- (void)fw_pushViewController:(UIViewController *)viewController popWorkflows:(nullable NSArray<NSString *> *)workflows animated:(BOOL)animated completion:(nullable void (^)(void))completion NS_REFINED_FOR_SWIFT;

/**
 pop方式清理最外层工作流，至少保留一个根控制器（不属于工作流则不清理），完成时回调
 @note 示例：1、（2、3）、4、（5、6）、（7、8），操作后为1、（2、3）、4、（5、6）
 
 @param animated 是否执行动画
 */
- (void)fw_popTopWorkflowAnimated:(BOOL)animated completion:(nullable void (^)(void))completion NS_REFINED_FOR_SWIFT;

/**
 pop方式从外到内清理指定工作流，直到遇到不属于指定工作流的控制器停止，至少保留一个根控制器，完成时回调
 @note 示例：1、（2、3）、4、（5、6）、（7、8），操作后为1、（2、3）、4
 
 @param workflows 指定工作流
 @param animated  是否执行动画
 */
- (void)fw_popWorkflows:(nullable NSArray<NSString *> *)workflows animated:(BOOL)animated completion:(nullable void (^)(void))completion NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface CADisplayLink (FWQuartzCore)

Objective-C

@interface CAAnimation (FWQuartzCore)

/// 设置动画开始回调，需要在add之前添加，因为add时会自动拷贝一份对象
@property (nonatomic, copy, nullable) void (^fw_startBlock)(CAAnimation *animation) NS_REFINED_FOR_SWIFT;

/// 设置动画停止回调
@property (nonatomic, copy, nullable) void (^fw_stopBlock)(CAAnimation *animation, BOOL finished) NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface CALayer (FWQuartzCore)

/// 设置主题背景色，启用主题订阅后可跟随系统改变，清空时需置为nil
@property (nullable, nonatomic, strong) UIColor *fw_themeBackgroundColor NS_REFINED_FOR_SWIFT;

/// 设置主题边框色，启用主题订阅后可跟随系统改变，清空时需置为nil
@property (nullable, nonatomic, strong) UIColor *fw_themeBorderColor NS_REFINED_FOR_SWIFT;

/// 设置主题阴影色，启用主题订阅后可跟随系统改变，清空时需置为nil
@property (nullable, nonatomic, strong) UIColor *fw_themeShadowColor NS_REFINED_FOR_SWIFT;

/// 设置主题内容图片，启用主题订阅后可跟随系统改变，清空时需置为nil
@property (nullable, nonatomic, strong) UIImage *fw_themeContents NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface CAGradientLayer (FWQuartzCore)

/// 设置主题渐变色，启用主题订阅后可跟随系统改变，清空时需置为nil
@property (nullable, nonatomic, copy) NSArray<UIColor *> *fw_themeColors NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSObject (FWSwizzle)

Objective-C

@interface UIColor (FWTheme)

/// 动态创建主题色，分别指定浅色和深色
+ (UIColor *)fw_themeLight:(UIColor *)light dark:(UIColor *)dark NS_REFINED_FOR_SWIFT;

/// 动态创建主题色，指定提供句柄
+ (UIColor *)fw_themeColor:(UIColor * (^)(FWThemeStyle style))provider NS_REFINED_FOR_SWIFT;

/// 动态创建主题色，指定名称，兼容iOS11+系统方式(仅iOS13+支持动态颜色)和手工指定。失败时返回clear防止崩溃
+ (UIColor *)fw_themeNamed:(NSString *)name NS_REFINED_FOR_SWIFT;

/// 动态创建主题色，指定名称和bundle，兼容iOS11+系统方式(仅iOS13+支持动态颜色)和手工指定。失败时返回clear防止崩溃
+ (UIColor *)fw_themeNamed:(NSString *)name bundle:(nullable NSBundle *)bundle NS_REFINED_FOR_SWIFT;

/// 手工单个注册主题色，未配置主题色或者需兼容iOS11以下时可使用本方式
+ (void)fw_setThemeColor:(nullable UIColor *)color forName:(NSString *)name NS_REFINED_FOR_SWIFT;

/// 手工批量注册主题色，未配置主题色或者需兼容iOS11以下时可使用本方式
+ (void)fw_setThemeColors:(NSDictionary<NSString *, UIColor *> *)nameColors NS_REFINED_FOR_SWIFT;

/// 获取当前主题样式对应静态颜色，主要用于iOS13以下兼容主题切换
@property (nonatomic, readonly) UIColor *fw_color NS_SWIFT_NAME(__fw_color) NS_REFINED_FOR_SWIFT;

/// 指定主题样式获取对应静态颜色，iOS13+可跟随系统改变
- (UIColor *)fw_colorForStyle:(FWThemeStyle)style NS_REFINED_FOR_SWIFT;

/// 是否是主题颜色，仅支持判断使用fwTheme创建的颜色
@property (nonatomic, assign, readonly) BOOL fw_isThemeColor NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface UIImage (FWTheme)

Objective-C

@interface UIImageAsset (FWTheme)

/// 创建主题动态图片资源，分别指定浅色和深色，系统方式，推荐使用
+ (UIImageAsset *)fw_themeLight:(nullable UIImage *)light dark:(nullable UIImage *)dark NS_REFINED_FOR_SWIFT;

/// 创建主题动态图片资源，指定提供句柄，内部使用FWThemeObject实现
+ (UIImageAsset *)fw_themeAsset:(UIImage * _Nullable (^)(FWThemeStyle style))provider NS_REFINED_FOR_SWIFT;

/// 获取当前主题样式对应静态图片用于显示，iOS13+可跟随系统改变
@property (nullable, nonatomic, readonly) UIImage *fw_image NS_REFINED_FOR_SWIFT;

/// 指定主题样式获取对应静态图片用于显示，iOS13+可跟随系统改变
- (nullable UIImage *)fw_imageForStyle:(FWThemeStyle)style NS_REFINED_FOR_SWIFT;

/// 是否是主题图片资源，仅支持判断使用fwTheme创建的图片资源
@property (nonatomic, assign, readonly) BOOL fw_isThemeAsset NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface NSObject (FWTheme) <FWThemeObserver>

/// 订阅主题通知并指定主题上下文(如vc|view)，非UITraitEnvironment等需指定后才能响应系统主题
@property (nullable, nonatomic, weak) id<UITraitEnvironment> fw_themeContext NS_REFINED_FOR_SWIFT;

/// 添加iOS13主题改变通知回调，返回订阅唯一标志，需订阅后才生效
- (nullable NSString *)fw_addThemeListener:(void (^)(FWThemeStyle style))listener NS_REFINED_FOR_SWIFT;

/// iOS13根据订阅唯一标志移除主题通知回调
- (void)fw_removeThemeListener:(nullable NSString *)identifier NS_REFINED_FOR_SWIFT;

/// iOS13移除所有主题通知回调，一般用于cell重用
- (void)fw_removeAllThemeListeners NS_REFINED_FOR_SWIFT;

/// iOS13主题改变包装器钩子，如果父类有重写，记得调用super，需订阅后才生效
- (void)fw_themeChanged:(FWThemeStyle)style NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface UIImageView (FWTheme)

Objective-C

@interface UIColor (FWToolkit)

/// 获取当前颜色指定透明度的新颜色
- (UIColor *)fw_colorWithAlpha:(CGFloat)alpha NS_REFINED_FOR_SWIFT;

/// 读取颜色的十六进制值RGB，不含透明度
@property (nonatomic, assign, readonly) long fw_hexValue NS_REFINED_FOR_SWIFT;

/// 读取颜色的透明度值，范围0~1
@property (nonatomic, assign, readonly) CGFloat fw_alphaValue NS_REFINED_FOR_SWIFT;

/// 读取颜色的十六进制字符串RGB，不含透明度
@property (nonatomic, copy, readonly) NSString *fw_hexString NS_REFINED_FOR_SWIFT;

/// 读取颜色的十六进制字符串RGBA|ARGB(透明度为1时RGB)，包含透明度
@property (nonatomic, copy, readonly) NSString *fw_hexAlphaString NS_REFINED_FOR_SWIFT;

/// 设置十六进制颜色标准为ARGB|RGBA，启用为ARGB，默认为RGBA
@property (class, nonatomic, assign) BOOL fw_colorStandardARGB NS_REFINED_FOR_SWIFT;

/// 获取透明度为1.0的RGB随机颜色
@property (class, nonatomic, readonly) UIColor *fw_randomColor NS_REFINED_FOR_SWIFT;

/// 从十六进制值初始化，格式：0x20B2AA，透明度为1.0
+ (UIColor *)fw_colorWithHex:(long)hex NS_REFINED_FOR_SWIFT;

/// 从十六进制值初始化，格式：0x20B2AA，自定义透明度
+ (UIColor *)fw_colorWithHex:(long)hex alpha:(CGFloat)alpha NS_REFINED_FOR_SWIFT;

/// 从十六进制字符串初始化，支持RGB、RGBA|ARGB，格式：@"20B2AA", @"#FFFFFF"，透明度为1.0，失败时返回clear
+ (UIColor *)fw_colorWithHexString:(NSString *)hexString NS_REFINED_FOR_SWIFT;

/// 从十六进制字符串初始化，支持RGB、RGBA|ARGB，格式：@"20B2AA", @"#FFFFFF"，自定义透明度，失败时返回clear
+ (UIColor *)fw_colorWithHexString:(NSString *)hexString alpha:(CGFloat)alpha NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface UIFont (FWToolkit)

/// 全局自定义字体句柄，优先调用
@property (class, nonatomic, copy, nullable) UIFont * (^fw_fontBlock)(CGFloat size, UIFontWeight weight) NS_REFINED_FOR_SWIFT;

/// 是否自动等比例缩放字体，默认NO。启用后所有fw字体size都会自动*relativeScale
@property (class, nonatomic, assign) BOOL fw_autoScale NS_REFINED_FOR_SWIFT;

/// 返回系统Thin字体
+ (UIFont *)fw_thinFontOfSize:(CGFloat)size NS_REFINED_FOR_SWIFT;
/// 返回系统Light字体
+ (UIFont *)fw_lightFontOfSize:(CGFloat)size NS_REFINED_FOR_SWIFT;
/// 返回系统Regular字体
+ (UIFont *)fw_fontOfSize:(CGFloat)size NS_REFINED_FOR_SWIFT;
/// 返回系统Medium字体
+ (UIFont *)fw_mediumFontOfSize:(CGFloat)size NS_REFINED_FOR_SWIFT;
/// 返回系统Semibold字体
+ (UIFont *)fw_semiboldFontOfSize:(CGFloat)size NS_REFINED_FOR_SWIFT;
/// 返回系统Bold字体
+ (UIFont *)fw_boldFontOfSize:(CGFloat)size NS_REFINED_FOR_SWIFT;

/// 创建指定尺寸和weight的系统字体
+ (UIFont *)fw_fontOfSize:(CGFloat)size weight:(UIFontWeight)weight NS_REFINED_FOR_SWIFT;

@end

Objective-C

@interface UIImage (FWToolkit)

/// 从当前图片创建指定透明度的图片
- (nullable UIImage *)fw_imageWithAlpha:(CGFloat)alpha NS_REFINED_FOR_SWIFT;

/// 从当前图片混合颜色创建UIImage，默认kCGBlendModeDestinationIn模式，适合透明图标
- (nullable UIImage *)fw_imageWithTintColor:(UIColor *)tintColor NS_REFINED_FOR_SWIFT;

/// 从当前UIImage混合颜色创建UIImage，自定义模式
- (nullable UIImage *)fw_imageWithTintColor:(UIColor *)tintColor blendMode:(CGBlendMode)blendMode NS_REFINED_FOR_SWIFT;

/// 缩放图片到指定大小
- (nullable UIImage *)fw_imageWithScaleSize:(CGSize)size NS_REFINED_FOR_SWIFT;

/// 缩放图片到指定大小，指定模式
- (nullable UIImage *)fw_imageWithScaleSize:(CGSize)size contentMode:(UIViewContentMode)contentMode NS_REFINED_FOR_SWIFT;

/// 按指定模式绘制图片
- (void)fw_drawInRect:(CGRect)rect withContentMode:(UIViewContentMode)contentMode clipsToBounds:(BOOL)clipsToBounds NS_REFINED_FOR_SWIFT;

/// 裁剪指定区域图片
- (nullable UIImage *)fw_imageWithCropRect:(CGRect)rect NS_REFINED_FOR_SWIFT;

/// 指定颜色填充图片边缘
- (nullable UIImage *)fw_imageWithInsets:(UIEdgeInsets)insets color:(nullable UIColor *)color NS_REFINED_FOR_SWIFT;

/// 拉伸图片(平铺模式)，指定端盖区域（不拉伸区域）
- (UIImage *)fw_imageWithCapInsets:(UIEdgeInsets)insets NS_REFINED_FOR_SWIFT;

/// 拉伸图片(指定模式)，指定端盖区域（不拉伸区域）。Tile为平铺模式，Stretch为拉伸模式
- (UIImage *)fw_imageWithCapInsets:(UIEdgeInsets)insets resizingMode:(UIImageResizingMode)resizingMode NS_REFINED_FOR_SWIFT;

/// 生成圆角图片
- (nullable UIImage *)fw_imageWithCornerRadius:(CGFloat)radius NS_REFINED_FOR_SWIFT;

/// 按角度常数(0~360)转动图片，默认图片尺寸适应内容
- (nullable UIImage *)fw_imageWithRotateDegree:(CGFloat)degree NS_REFINED_FOR_SWIFT;

/// 按角度常数(0~360)转动图片，指定图片尺寸是否延伸来适应内容，否则图片尺寸不变，内容被裁剪
- (nullable UIImage *)fw_imageWithRotateDegree:(CGFloat)degree fitSize:(BOOL)fitSize NS_REFINED_FOR_SWIFT;

/// 生成mark图片
- (nullable UIImage *)fw_imageWithMaskImage:(UIImage *)maskImage NS_REFINED_FOR_SWIFT;

/// 图片合并，并制定叠加图片的起始位置
- (nullable UIImage *)fw_imageWithMergeImage:(UIImage *)image atPoint:(CGPoint)point NS_REFINED_FOR_SWIFT;

/// 图片应用CIFilter滤镜处理
- (nullable UIImage *)fw_imageWithFilter:(CIFilter *)filter NS_REFINED_FOR_SWIFT;

/// 压缩图片到指定字节，图片太大时会改为JPG格式。不保证图片大小一定小于该大小
- (nullable UIImage *)fw_compressImageWithMaxLength:(NSInteger)maxLength NS_REFINED_FOR_SWIFT;

/// 压缩图片到指定字节，图片太大时会改为JPG格式，可设置递减压缩率，默认0.1。不保证图片大小一定小于该大小
- (nullable NSData *)fw_compressDataWithMaxLength:(NSInteger)maxLength compressRatio:(CGFloat)compressRatio NS_REFINED_FOR_SWIFT;

/// 长边压缩图片尺寸，获取等比例的图片
- (nullable UIImage *)fw_compressImageWithMaxWidth:(NSInteger)maxWidth NS_REFINED_FOR_SWIFT;

/// 通过指定图片最长边，获取等比例的图片size
- (CGSize)fw_scaleSizeWithMaxWidth:(CGFloat)maxWidth NS_REFINED_FOR_SWIFT;

/// 获取原始渲染模式图片，始终显示原色，不显示tintColor。默认自动根据上下文
@property (nonatomic, readonly) UIImage *fw_originalImage NS_REFINED_FOR_SWIFT;

/// 获取模板渲染模式图片，始终显示tintColor，不显示原色。默认自动根据上下文
@property (nonatomic, readonly) UIImage *fw_templateImage NS_REFINED_FOR_SWIFT;

/// 判断图片是否有透明通道
@property (nonatomic, assign, readonly) BOOL fw_hasAlpha NS_REFINED_FOR_SWIFT;

/// 获取当前图片的像素大小，多倍图会放大到一倍
@property (nonatomic, assign, readonly) CGSize fw_pixelSize NS_REFINED_FOR_SWIFT;

/// 从视图创建UIImage，生成截图，主线程调用
+ (nullable UIImage *)fw_imageWithView:(UIView *)view NS_REFINED_FOR_SWIFT;

/// 从颜色创建UIImage，默认尺寸1x1
+ (nullable UIImage *)fw_imageWithColor:(UIColor *)color NS_REFINED_FOR_SWIFT;

/// 从颜色创建UIImage，指定尺寸
+ (nullable UIImage *)fw_imageWithColor:(UIColor *)color size:(CGSize)size NS_REFINED_FOR_SWIFT;

/// 从颜色创建UIImage，指定尺寸和圆角
+ (nullable UIImage *)fw_imageWithColor:(UIColor *)color size:(CGSize)size cornerRadius:(CGFloat)radius NS_REFINED_FOR_SWIFT;

/// 从block创建UIImage，指定尺寸
+ (nullable UIImage *)fw_imageWithSize:(CGSize)size block:(void (NS_NOESCAPE ^)(CGContextRef context))block NS_REFINED_FOR_SWIFT;

/// 保存图片到相册，保存成功时error为nil
- (void)fw_saveImageWithCompletion:(nullable void (^)(NSError * _Nullable error))completion NS_SWIFT_NAME(__fw_saveImage(completion:)) NS_REFINED_FOR_SWIFT;

// 保存视频到相册，保存成功时error为nil。如果视频地址为NSURL，需使用NSURL.path
+ (void)fw_saveVideo:(NSString *)videoPath withCompletion:(nullable void (^)(NSError * _Nullable error))completion NS_REFINED_FOR_SWIFT;

@end