YYUIKit 是我在开发中总结的一套 UI 类库


License
MIT
Install
pod try YYUIKit

Documentation

XYUIKit

使用 Swift 写的一些小控件、工作中某些组件的雏形

慢慢积累,逐渐形成自己的一套开发工具包

NOTE 本项目从最初就想叫 XYUIKit, 无奈名称早已被占用 想来想去, 最终决定使用 YYUIKit 命名

使用 CocoaPods 安装

pod YYUIKit                     #全部功能, 主要基于 UIKit 平台
pod YYUIKit/Foundation          #Foundation功能分类, 此部分平台无关, 可用于 Apple 全平台开发

近期 TODOs

  1. XYLoger: 一套 log 读写工具, 目标: 日志写入文件, 便于调试,查看日志, 无需断点调试, 尤其是避免一些启动等特殊场景下的断点调试
  2. XYImageEditor: 一个简易的图片编辑器, 裁剪,旋转,翻转,缩放... 参考微信图片裁剪
  3. XYQrCodeManager: 一个二维码/条码, 生成 / 扫描识别 / 图片二维码识别工具, 参考微信扫码
  4. gif 动图加载( UIKit / SwiftUI)
  5. ...

功能介绍

YYUIKit 分 Foundation 分类 / UIKit 两部分, 具体 UI 欢迎下载 Demo 体验, 如果对你有帮助, 欢迎点赞🌟🌟🌟🌟支持 💪🎉

Foundation 分类

此部分平台无关, 可用于 Apple 全平台开发, 可单独导入

常用 Foundation 分类/工具如下

1. String / NSAttributeString
2. Date
3. DispatchQueue
4. UIColor / NSColor
5. Optional
6. Runlooper
7. UIImage
8. 键盘监听工具 KeyboardMonitor 和键盘上方工具栏 XYKeyboardToolbar, 支持收起键盘
9. XYNetTool, 一套简单的网络请求工具/ Post/Get/DataTask/ 前期开发阶段网络调试利器
10. NetworkMonitor 和 NetworkReachability 网络状态监听工具类

UIKit

此部分主要依赖 UIKit, 可用于 UIKit 项目开发

(1). Categories: 
CGFloat / Label / Control / View / ViewController / Responder / ScrollView / Application ....

(2). 自定义控制器
1. XYAlertSheetController, 便捷的 alertSheet 弹框, 封装框的各种效果, 仅需要专注于弹框内容
2. XYSpeedMatchController, 便捷的快速匹配控制器, 类似探探快速匹配心动女孩页面

(3) 文件系统 FileSystem
1. FileSystem 核心就是提供一套 iOS 下的文件夹查看/预览系统

(4) Global
1. 各种公共函数, 如 doOnce / doOnce(forKey:) / doSth(forKey: forCount)
2. 一些公共常量, 如 状态栏高度 / 导航栏高度 / 底部安全区高度 ...

(5) Toast
1. 提供一套全局的 Toast 工具, 支持 文本 + activity

(6) 系统工具
1. XYAlert 系统 UIAlertController 的封装, 方便使用
2. XYAlertManager, 弹框管理器, 比如 App 启动后需要按指定顺序弹框各种提示/功能
3. XYDebugTool, 提供一些调试常用小工具/函数
4. XYFileManager, 分装一套便捷的文件读写工具, 支持 Model 快速读写 / 持久化 / 文档查看
5. XYUtils - 各种系统工具, 提供别名 AppUtils, 所有功能类方法调用即可
	1. XYDatePicker 日期选择器 (yyyy-MM-dd)
	2. XYColorPicker 颜色选择器
	3. XYImagePicker 图片/音频(从视频截取)/视频选取工具
	4. XYMediaPlayer 音视频播放器
	5. XYImageEditor 图片编辑器: in doing

(7) Views
1. XYBadgeView: 红点 / 各种消息提示的红点, 做过 IM 应该比较有体会
2. XYDebugView: 一套悬浮小球的解决方案, 各种小球, 各种场景自定义
3. XYTagsView: 一套标签视图工具, 类似于商品标签 / 简易的 CollectionView / 九宫格布局 / 自定义样式 / 点击事件
4. XYIndexBar: UITableView.indexView 的自定义实现
5. XYPickerView: 一个 PickerView 的快捷实现, 可高度自定义
6. XYStackView / XYBoxView: 对 UIStackView 便捷封装, 对 UIView 快速拓展边框区域的实现
7. XYPagingScrollView: 可用于自定义分页大小的 scrollView, 可用于各种自定义 banner,分页选择器如约车软件选择车型的分页视图

持续增加中...

版本记录(重要功能版本)

v0.4.1 - v0.5.0 (2024/6/4 - 2024/7/8)

  1. XYAlertSheetController 多项功能优化, 支持手势取消
  2. 新增 Console 工具类,支持打印日志
  3. XYTagsView.config 新增 tagMarginV 属性, 控制多行 tags 行间距
  4. CGFloat.isDynamicIsland 属性 bugfix
  5. UIApplication+XYAdd 方法更新
  6. XYTagsView 暴露当前实例最大宽度, 提供 ‘updateCustomViews’ 函数更新内容
  7. XYFileManager 新增删除 file 方法, 完善文件的 CURD 操作
  8. 新增键盘监听工具 KeyboardMonitor, 监听键盘弹起/关闭状态
  9. 新增键盘上方工具栏, 当前支持关闭键盘 XYKeyboardToolbar
  10. Runlooper 工具函数完善, 新增指定 loopcount 的函数
  11. 增加 XYTextChangeMonitor 工具类, 用来监听 UITextfield / UITextView 的开始编辑, 编辑中, 结束编辑状态
  12. 增加 XYKeyboardToolbar 工具类, 用于监听键盘弹出时候在键盘上增加一个工具条, 当前版本提供收起键盘功能, 仅需设置全局配置类即可 KeyboardToolbarConfig.shared.showToolBar = true
  13. 增加 NetworkMonitor 和 NetworkReachability 网络状态监听工具类, 可以实时监听网络的连接状态以及连接类型.
  14. 网络工具优化, 网络请求异步处理, 并增加网络请求的业务超时时间, 即发起请求到收到完整回调时间, 用户指定超时时间之外的回调均视为超时, [系统的超时时间指连接超时时间, 指定时间内能连到服务器则不算超时]
  15. XYPagingScrollView 支持内部内容随滑动缩放, 内存优化

v0.3.3 - v0.4.0 (2024/4/2 - 2024/5/15)

  1. 优化 XYScrollPagingView
  2. CGFloat+XYAdd / UIDevice+XYAdd / Date+XYAdd 增加便利 get 变量
  3. 增加 Scaleable 协议, 由 CGSize / CGRect 实现, 可指定缩放比缩放 size / rect
  4. 调整 Runlooper 全部方法为 public
  5. 从视频中音频提取功能优化,修复手机录屏视频音频的提取
  6. XYAlertSheetController 多项功能优化
  7. XYPagingScrollView 新增默认选中 index 属性,优化内部图层逻辑,修复可能事件传递出错的bug

v0.3.2 (2024/3/25)

  1. NetTool 返回值格式调整, 支持更多网络请求场景
  2. 新增 XYScrollPagingView, 支持自定义一个滚动分页视图, 类似可自定义页面大小 banner

v0.3.0 (2024/2/22)

  1. 新增文件系统 FileSystem, 可快捷查看指定目录下的文件结构, 支持文件的查看和预览功能
  2. 提供 AppUtils 的快捷调用函数

v0.2.5 (2024/2/10)

  1. 增加 XYDebugView, 可用于创建各种悬浮小球 XYDebugView

    • 提供一套默认实现
    • 支持悬浮小球的尺寸, 手势, 添加父容器, 视图内容全面自定义
  2. 增加 Runlooper 工具类, 模拟 runloop 机制提供特定用途的循环

older versions

基础常用分类工具 & 自定义工具类 & 自定义 UIViews