/JKSwiftExtension

Swift常用扩展、组件、协议,方便项目快速搭建,提供完整清晰的Demo示例,不断的完善中......

Primary LanguageSwiftApache License 2.0Apache-2.0

CI Status Version License Platform

组成部分

FoundationExtension:Foundation 类型的扩展
UIKitExtension:UIKit类型的扩展
Protocol:协议工具
SmallTools:其他小工具

使用说明

每一个 Extension 都会对应一个测试用例的类,如果没有的说明还没有完善,如: String 的分类 String+Extension 的测试用例在 StringExtensionViewController.swift 里面 WechatIMG160.jpeg

导入方式

 platform :ios, '9.0'
 
 target '项目名字' do
   use_frameworks!
   pod 'JKSwiftExtension'

 end

Requirements

Swift5.0+

这个基础库的目的:快速开发,不重复再去查找资料,如果觉得此项目对您的Swift学习有帮助,欢迎点赞...

版本说明

  • 1.9.2、版本:常量增加前缀jk_

  • 1.9.1、版本:mark注释更新

  • 1.9.0、版本:1.9.0之后的版本去除JKEKEvent.swift和JKContactsKit.swift,原因是:对于日历和通讯录的API使用,苹果机身需要在:info.plist中添加对用的key和value

  • 1.8.9、版本:去除依赖库

  • 1.8.8、版本:kTabbatBottom 改为 kTabbarBottom

  • 1.8.7、版本:CALayer+Extension.swift中baseBasicAnimation动画repeatNumber: 重复的次数的使用

  • 1.8.6、版本:去除Kingfisher依赖

  • 1.8.5、版本:UIView+Extension新增内阴影

  • 1.8.2、版本:扩展更新

  • 1.8.0、版本:新增智能换肤 用户可以设置时间来定义:浅色和深色的切换时间,到时间自动切换模式,需要开发者自己去找触发机制,具体的测试用例在:JKDarkModeUtilViewController

    智能换肤

  • 1.7.8、版本:部分扩展的新增

  • 1.7.7、版本:暗黑模式的完善

  • 1.7.6、版本:暗黑模式适配iOS 13以上和iOS 13以下的:浅色和深色

    • iOS 13以上使用系统的暗黑模式:JKDarkModeUtil,默认跟随系统 使用方式:在设置 windowrootViewController 后需要调用 JKDarkModeUtil.defaultDark(),颜色调用如下:

      self.view.backgroundColor = JKDarkModeUtil.colorLightDark(light: UIColor.yellow, dark: UIColor.green)
      
    • iOS 13以下使用主题色:JKThemeProvider,默认是浅色 使用方式:

      • 1.1、遵守协议 JKThemeable (遵守UITraitEnvironment协议的均可使用)

        extension lViewController: JKThemeable {
           func apply() {
              self.view.backgroundColor = JKDarkModeUtil.colorLightDark(light: UIColor.yellow, dark: UIColor.green)
           }
        }
        
      • 1.2、注册监听模式变化

        themeProvider.register(observer: self)
        
      • 1.3、模式变化通知

        JKDarkModeUtil.setDarkModeCustom(isLight: true) 
        
    • 建议使用业务色

      extension UIColor {
         /// 背景色
         private(set) static var cA1 = JKDarkModeUtil.colorLightDark(light: UIColor.yellow, dark: UIColor.green)
      }
      
  • 1.7.2、暗黑模式的添加:JKDarkModeUtil

    • 在设置 windowrootViewController 后需要调用 JKDarkModeUtil.defaultDark()
    • 主要方法是:
      • 开启跟随模式:setDarkModeFollowSystem
      • 自定义模式:setDarkModeCustom
      • 是否是跟随模式:JKDarkModeUtil.isFloorSystem
      • 是否是浅色模式:JKDarkModeUtil.isLight
  • 1.7.1、版本

    WKWebView+Extension.swift 扩展内容的补充

    • WKWebViewConfiguration默认配置
    • js注入
    • js交互
    • 调整字体的比例
    • 加载网页
    • 获取WKWebView视图(长截图)
  • 1.7.0、版本

    DispatchQueue+Extension.swift 扩展内容的补充

    • 函数只被执行一次
    • 异步做一些任务
    • 异步做任务后回到主线程做任务
    • 异步延迟(子线程执行任务)
    • 异步延迟回到主线程(子线程执行任务,然后回到主线程执行任务)
  • 1.6.9、版本

    Date+Extension.swift 新增两个Date之间的关系,如下

    获取两个日期之间的数据
    获取两个日期之间的天数
    获取两个日期之间的小时
    获取两个日期之间的分钟
    获取两个日期之间的秒数
    
  • 1.6.8、版本

    获取字体的名字由 font.fontName 替换为 font.fontName == ".SFUI-Regular" ? "TimesNewRomanPSMT" : font.fontName

  • 1.6.7、版本 UIColor+Extension.swift 增加暗黑模式颜色适配,方法如下

    public extension UIColor {
    
      // MARK: 6.1、深色模式和浅色模式颜色设置,非layer颜色设置
      /// 深色模式和浅色模式颜色设置,非layer颜色设置
      /// - Parameters:
      ///   - lightColor: 浅色模式的颜色
      ///   - darkColor: 深色模式的颜色
      /// - Returns: 返回一个颜色(UIColor)
      static func darkModeColor(lightColor: UIColor, darkColor: UIColor) -> UIColor {
         if #available(iOS 13.0, *) {
           return UIColor { (traitCollection) -> UIColor in
              if traitCollection.userInterfaceStyle == .dark {
                 return darkColor
              } else {
                 return lightColor
              }
           }
         } else {
           return lightColor
         }
      }
    }
    

    使用,建议设置一个业务颜色的扩展,在使用的时候调用业务的颜色,如下

    // MARK: - 业务颜色的使用
    extension UIColor {
       /// 颜色
       private(set) static var cB1: UIColor = UIColor.darkModeColor(lightColor: UIColor.green, darkColor: UIColor.blue)
    }
    

    具体的调用

     self.view.backgroundColor = .cB1
    
  • 1.6.2、版本 String+Extension.swift 新增String或者String HTML标签转富文本设置,方法如下

    func setHtmlAttributedString(font: UIFont? = UIFont.systemFont(ofSize: 16), lineSpacing: CGFloat? = 10) -> NSMutableAttributedString {
        省略......
    }
    
  • 1.6.1、版本 JKContentSize 新增指定宽度的文本:行数和每行的内容(可缩放后的文本)

  • 1.6.0、版本 修复枚举 JKViewGradientDirectionverticalreturn (CGPoint(x: 0, y: 0), CGPoint(x: 0, y: 1))

  • 1.5.9、版本

    • UITableView+Extension 新增 UITableViewCell的注册和使用的方法
    • UICollectionView+Extension 新增 UICollectionViewCell的注册和使用的方法
  • 1.5.7、版本

    • UIFont+Extension新增PingFangSC-字体
  • 1.5.6、版本

    • 修复UITextView+Extension和UITextFiled+Extension 限制字符正则的bug
  • 1.5.5、版本

    • UITextView 限制行数、限制字符、自动变化高度的去除
  • 1.5.2、版本

    • JKValidateHelper内容合并到JKRegexHelper
    • JKRegexHelper:新增JKRegexCharacterType(校验字符的表达式)和JKRegexDigitalType(校验数字的表达式)
    • WeakTimer->改为JKWeakTimer
    • UITextView&UITextField 扩展新增方法(inputRestrictions),限制字数的输入(考虑了九宫格键盘和高亮状态)
  • 1.5.1、版本 新增 Range+Extension.swift ,Range 转 NSRange,String+Extension 新增任意位置插入字符串

  • 1.5.0、版本 新增 JKContactsKit 获取通讯录的联系人

    在iOS9.0 之前, 我们只能通过 AddressBook 框架来获取通讯录联系人信息。但 AddressBook framework 语法很奇怪,同时也十分难用。所以苹果从 iOS9.0 开始推出的全新的联系人框架 Contacts FrameWork 作为替代,同时将原来的 AddressBook 给废弃掉。
    Contacts FrameWork 同样包含两种访问通讯录的方式:
    ContactsUI.framework 框架 : 通过系统提供的通讯录交互界面来访问(替代原先的 AddressBookUI.framework)
    Contacts.framework 框架 : 没有界面,通过代码来获取所有联系人信息(替代原先的 AddressBook.framework)
    
  • 1.3.9、版本 修复 UIViewController+Extension.swift 1.3 和 1.4 找不到 rootViewController 的问题

  • 1.3.8、版本 JKEKEvent.swift 回到主线程优化

    /// 事件主线程
    /// - Parameters:
    ///   - parameter: 返回的参数
    ///   - eventsClosure: 闭包
    private static func resultMain<T>(parameter: T, eventsClosure: @escaping ((T) -> Void)) {
       DispatchQueue.main.async {
          eventsClosure(parameter)
       }
    }
    
  • 1.3.7、版本 新增JKEKEvent日历和提醒事件的基本使用

  • 1.3.6、版本 优化JKPhotoAlbumUtil相册管理

  • 1.3.5、版本 新增小工具JKPhotoAlbumUtil,管理相册

  • 1.3.2、版本 UITextView+Extension 新增:添加链接文本(链接为空时则表示普通文本)、转换特殊符号标签字段

  • 1.3.1、版本 String+ExtensionNumberFormatter+Extension 部分内容代码优化

  • 1.3.0、版本 新增 NumberFormatter+Extension.swift:NumberFormatter进行数字格式化显示

  • 1.2.9、版本 UIFont+Extension 字体的调整

  • 1.2.8、版本 新增具有内边距的label:JKPaddingLabel

  • 1.2.7、版本

    • URL+Extension.swift 增加 检测应用是否能打开这个URL实例
    • JKJSON.swift 小组件的新增:将数据转成可用的JSON模型
    • String+Extension.swift 新增 提取出字符串中所有的URL链接
    • JKDrawSignatureView.swift 签名板
  • 1.2.6、版本
    UIImage+Extension.swift

    • 图片中二维码的识别
    • 分析图片中二维码的具体数据
    • 图片打马赛克
    • 识别图片中的人脸位置
    • 图片中的人脸打马赛克

    String+Extension.swift 新增 字符值引用 (numeric character reference, NCR)与普通字符串的转换

  • 1.2.5、版本 CLLocation+Extension.swift 和 NSRange+Extension.swift 扩展的新增

  • 1.2.2、版本 FileManager+Extension.swift 新增部分扩展

  • 1.2.1、版本 去除 SmallTools 中的 JKVerticalCarousel、MaskingManager、JKLoadingView 删除,也去除依赖SnapKit

  • 1.1.9、版本 UIDevice+Extension.swift 扩展新增:有关设备运营商的信息

    • sim卡信息
    • 数据业务对应的通信技术
    • 设备网络制式
    • 运营商名字
    • 移动国家码(MCC)
    • 移动网络码(MNC)
    • ISO国家代码
    • 是否允许VoIP
  • 1.1.8、版本 调整状态栏的高度

    public var kStatusBarFrameH: CGFloat {
       guard isIPhoneX else {
         return 20
       }
       return UIApplication.shared.statusBarFrame.height > 0 ? UIApplication.shared.statusBarFrame.height : 44
    }
    
  • 1.1.7、版本

    gif图片的:本地、asset、网络 的分解
    
  • 1.1.6、版本

    UIView+Extension:新增背景颜色渐变和colors变化渐变动画
    UIButton+Extension:新增点击区域的扩展设置
    CAGradientLayer+Extension:新增渐变扩展
    
  • 1.1.5、版本

    UIApplication+Extension 新增打开系统应用和第三方APP的方法,如打开微信
    UIApplication.jk.openThirdPartyApp(type: .weixin) { (result) in
       JKPrint("结果:\(result)")
    }
    
  • 1.1.2、版本

    UIApplication+Extension 新增判断是否拥有权限,目前支持 照相机、相册、麦克风、定位,提示:这里判断是这些权限有没有被用户手动关闭
    JKGlobalTools 新增打开设置界面
    
  • 1.1.1、版本

    音视频压缩 AVAssetExportSession+Extension.swift 扩展的新增
    
  • 1.1.0、版本

    FileManager+Extension 新增有关网络和本地视频缩略图获取的扩展
    Date+Extension 新增时间条显示的格式,主要是针对播放时间条
    
  • 1.0.8、版本:UIViewController扩展新增一些内容

  • 1.0.7、版本:UIView有关手势的扩展

  • 1.0.1、版本:新增中间协议,使用绝大部分方法的时候需要先调用 jk,然后才可以使用,在 1.0.1 版本之前是没有使用协议的

Author

JoanKing, jkironman@163.com

License

JKSwiftExtension is available under the MIT license. See the LICENSE file for more info.