自己在Swift项目中使用或者看到的好用的框架

今年年初跳槽，顺便也从 OC 转为了 Swift ，所以之前 OC 版的框架就暂时不更新了，重新写了这篇文章，是我在 Swift 开发过程中用到、或者看到，个人觉得比较好用的框架，有新的偶遇，也会更新的，有兴趣的可以去瞄一眼

• CocoaDebug
  iOS APP 内置调试工具，支持log日志查看、网络抓包、沙盒查看等功能，代码零入侵。
  Appdelegate类里面设置：

private func customCocoaDebug() {
    //--- If want to custom CocoaDebug settings ---
//        CocoaDebug.serverURL = "google.com"
//        CocoaDebug.ignoredURLs = ["aaa.com", "bbb.com"]
//        CocoaDebug.onlyURLs = ["ccc.com", "ddd.com"]
//        CocoaDebug.ignoredPrefixLogs = ["aaa", "bbb"]
//        CocoaDebug.onlyPrefixLogs = ["ccc", "ddd"]
//        CocoaDebug.emailToRecipients = ["aaa@gmail.com", "bbb@gmail.com"]
//        CocoaDebug.emailCcRecipients = ["ccc@gmail.com", "ddd@gmail.com"]
    CocoaDebug.mainColor = "#fd9727"
//        CocoaDebug.additionalViewController = TestController.init()
    
    //Deprecated! If want to support protobuf, check branch: origin/protobuf_support
    //--- If use Google's Protocol buffers ---
//        CocoaDebug.protobufTransferMap = [
//            "your_api_keywords_1": ["your_protobuf_className_1"],
//            "your_api_keywords_2": ["your_protobuf_className_2"],
//            "your_api_keywords_3": ["your_protobuf_className_3"]
//        ]
    
    //--- If want to manual enable App logs (Take effect the next time when app starts) ---
    CocoaDebugSettings.shared.enableLogMonitoring = true
}

记得在didFinishLaunchingWithOptions 内调用

重写一下打印方法，这个不要写在Appdelegate类里面，平级写

//MARK: - override Swift `print` method
public func MYLog<T>(file: String = #file, function: String = #function, line: Int = #line, _ message: T, color: UIColor = .white) {
#if DEBUG
    Swift.print(message)
    _SwiftLogHelper.shared.handleLog(file: file, function: function, line: line, message: message, color: color)
#endif
}

而在需要观察打印log的地方这样写：

MYLog("测试cocoaDebug有没有用", color: .red)

• ZXKitSwift
  是一个iOS端的调试工具的集合，跟上面的 CocoaDebug 类似

• XHLaunchAd
  开屏广告、启动广告解决方案-支持静态/动态图片广告/mp4视频广告

private func setupLaunchAd() {
      XHLaunchAd.setLaunch(.launchScreen)

      let imageAdConfiguration = XHLaunchImageAdConfiguration()
      imageAdConfiguration.frame = CGRectMake(0, 0, UIScreen.main.bounds.size.width, UIScreen.main.bounds.size.height)
      imageAdConfiguration.imageNameOrURLString = "转场动画.gif"
      imageAdConfiguration.gifImageCycleOnce = false
      imageAdConfiguration.imageOption = .refreshCached
      imageAdConfiguration.contentMode = .scaleAspectFill
      imageAdConfiguration.openModel = "https://www.xxxx.com"
      imageAdConfiguration.showFinishAnimate = .fadein
      imageAdConfiguration.showFinishAnimateTime = 0.8
      imageAdConfiguration.skipButtonType = .roundProgressText
      imageAdConfiguration.showEnterForeground = true

      XHLaunchAd.imageAd(with: imageAdConfiguration, delegate: self)
}

• HandyJSON
  HandyJSON 是一个用于 Swift 语言中的 JSON 序列化/反序列化库

class DeviceToolModel: HandyJSON {
    
    var toolTitle: String = ""
    var toolSubtitle: [String] = [String]()
    
    required init() {
        
    }
    
    init(toolTitle: String, toolSubtitle: [String]) {
        self.toolTitle = toolTitle
        self.toolSubtitle = toolSubtitle
    }
    
}

• SwifterSwift
  SwifterSwift 是 500 多个原生Swift 扩展的集合，为 iOS、macOS、tvOS、watchOS和 Linux 提供了（超过 500 个）适用于各种原生数据类型、UIKit和 Cocoa 类的便捷方法、语法糖和性能改进

• lottie-ios
  动画库，我是用来加载本地json 动画的，可以动态修改 json 内动画元素的颜色哦
  

  加载json动画.png

• SVGKit
  用来渲染 SVG 的，可以根据在 SVG 文件内添加的id来动态修改颜色
  

  svg文件内元素加id.png

这是用法：

setupSVGColors(svgName: "c0301", configs: self.setupSVGModel(colors: ["#FF0000", "#00FA9A", "#FF0000", "#FF0000"]), view: self.imageView)
setupSVGColors(svgName: "c0302", configs: self.setupSVGModel(colors: ["#FF0000", "#00FA9A", "#FF0000", "#FF0000"]), view: imageView1)
setupSVGColors(svgName: "c0303", configs: self.setupSVGModel(colors: ["#FF0000", "#00FA9A", "#FF0000", "#FF0000"]), view: imageView2)
setupSVGColors(svgName: "c0304", configs: self.setupSVGModel(colors: ["#FF0000", "#00FA9A", "#FF0000", "#FF0000"]), view: imageView3)
setupSVGColors(svgName: "c0305", configs: self.setupSVGModel(colors: ["#FF0000", "#00FA9A", "#FF0000", "#FF0000"]), view: imageView4)

这是当时为 SVG 改颜色写的一个简单的 model

class svgTintColorModel {
    var layerId: String = ""
    var color: String = ""
}

因为我们的 SVG 加了不同透明度，所以层级会变得很多，遍历的层级也要同步

private func setupSVGModel(colors: [String]) -> [svgTintColorModel] {
        var models = [svgTintColorModel]()
        colors.enumerated().forEach { (index, color) in
            let model = svgTintColorModel()
            model.layerId = "0\(colors.count)0\(index + 1)00"
            model.color = color
            models.append(model)
        }
        return models
    }

private func setupSVGColors(svgName: String, configs: [svgTintColorModel], view: UIImageView) {
        let svgImage = SVGKImage.init(named: svgName)
        configs.enumerated().forEach { index, config in
            svgImage?.caLayerTree.sublayers?.enumerated().forEach({ layer in
                autoreleasepool {
                    log.debug("第一层name是：\(layer.element.name ?? "")")
                    if (layer.element.name?.contains(config.layerId)) == true {
                        let shapeLayer = layer.element as! CAShapeLayer
                        shapeLayer.fillColor = UIColor.init(hex: config.color).cgColor
                        log.debug("第一层找到一个")
                    }
                    
                    layer.element.sublayers?.enumerated().forEach({ secondLayer in
                        log.debug("第二层name是：\(secondLayer.element.name ?? "")")
                        if (secondLayer.element.name?.contains(config.layerId)) == true {
                            let shapeLayer = secondLayer.element as! CAShapeLayer
                            shapeLayer.fillColor = UIColor.init(hex: config.color).cgColor
                            log.debug("第二层找到一个")
                        }
                        
                        secondLayer.element.sublayers?.enumerated().forEach({ thirdLayer in
                            log.debug("第三层name是：\(thirdLayer.element.name ?? "")")
                            if (thirdLayer.element.name?.contains(config.layerId)) == true {
                                let shapeLayer = thirdLayer.element as! CAShapeLayer
                                shapeLayer.fillColor = UIColor.init(hex: config.color).cgColor
                                log.debug("第三层找到一个")
                            }

                            thirdLayer.element.sublayers?.enumerated().forEach({ fourthLayer in
                                log.debug("第四层name是：\(fourthLayer.element.name ?? "")")
                                if (fourthLayer.element.name?.contains(config.layerId)) == true {
                                    let shapeLayer = fourthLayer.element as! CAShapeLayer
                                    shapeLayer.fillColor = UIColor.init(hex: config.color).cgColor
                                    log.debug("第四层找到一个")
                                }
                            })
                        })
                    })
                }
            })
        }
        let svgImageView = SVGKLayeredImageView.init(svgkImage: svgImage)
        view.image = svgImageView?.image.uiImage
    }

• LookinServer
  您可以通过 Lookin 检查和修改iOS 应用程序中的视图，就像 Xcode 中的UI 检查器或其他名为 Reveal 的应用程序一样。
  简单来说就是，集成以后，可以通过对应的软件查看你正在运行的项目当前的层级以及控件。
  

  Lookin使用效果.png

• Hue
  UIColor 的扩展

• SwiftEntryKit
  一个可自定义的可以带蒙版的弹窗

private func popupCustomView() {
      var attributes = EKAttributes.centerFloat
      attributes.entryBackground = .color(color: EKColor(UIColor(white: 1, alpha: 1)))
      attributes.screenBackground = .color(color: EKColor(UIColor(white: 1, alpha: 1)))
      //遮罩层触摸是忽略、转发到窗口还是退出
      attributes.screenInteraction = .absorbTouches
      attributes.entryInteraction = .forward
      attributes.entranceAnimation = .translation
      attributes.exitAnimation = .translation
      attributes.displayDuration = .infinity
      let view = UIView()
      view.addSubview(self.poupView)
      self.poupView.snp.makeConstraints { make in
          make.center.equalToSuperview()
          make.width.equalTo(UIScreen.main.bounds.width)
          make.height.equalTo(UIScreen.main.bounds.height)
      }
      self.poupView.startAnimation()
      SwiftEntryKit.display(entry: self.poupView, using: attributes)
}

• SwiftDate
  在Swift中解析、验证、操作、比较和显示日期、时间和时区的工具包，很好用的！

• Hero
  用于构建iOS视图控制器过渡的库,重点在过渡

• SwiftyTimer
  定时器，麻麻再也不担心我写个定时器一大串代码了

• ESTabBarController-swift
  高度自定义的TabBarController组件

• LifetimeTracker
  检测循环引用、内存泄漏

• FLEX
  Star很高的在线调试工具，主要是可以不用连着Xcode实时看数据库的数据，Log 的话有一堆不需要的，但是很多需要的却没有，暂时我还不知道怎么用这个框架的 Log。cash 我写了一个数组越界，但是并不知道在哪里可以看。以下是集成：

pod 'FLEX', :configurations => ['Debug']

FLEXManager.shared.showExplorer()

• CocoaDebug
  也是一个在线看log、crash、文件、网络请求等的框架，但是我写了很多 Log，他几乎只会显示他自己的 CocoaDebugTool.log(with: "446633")，crash 我写了一个数组越界，但是并没有抓到。以下是集成方法：

pod 'CocoaDebug', :configurations => ['Debug']

extension AppDelegate {
    
    private func customCocoaDebug() {
        //--- If want to custom CocoaDebug settings ---
//        CocoaDebug.serverURL = "google.com"
//        CocoaDebug.ignoredURLs = ["aaa.com", "bbb.com"]
//        CocoaDebug.onlyURLs = ["ccc.com", "ddd.com"]
//        CocoaDebug.ignoredPrefixLogs = ["aaa", "bbb"]
//        CocoaDebug.onlyPrefixLogs = ["ccc", "ddd"]
//        CocoaDebug.emailToRecipients = ["aaa@gmail.com", "bbb@gmail.com"]
//        CocoaDebug.emailCcRecipients = ["ccc@gmail.com", "ddd@gmail.com"]
        CocoaDebug.mainColor = "#fd9727"
//        CocoaDebug.additionalViewController = TestController.init()
        
        //Deprecated! If want to support protobuf, check branch: origin/protobuf_support
        //--- If use Google's Protocol buffers ---
//        CocoaDebug.protobufTransferMap = [
//            "your_api_keywords_1": ["your_protobuf_className_1"],
//            "your_api_keywords_2": ["your_protobuf_className_2"],
//            "your_api_keywords_3": ["your_protobuf_className_3"]
//        ]
        
        //--- If want to manual enable App logs (Take effect the next time when app starts) ---
        CocoaDebugSettings.shared.enableLogMonitoring = true
    }
    
}

• LLDebugTool
  这个跟上面两个类似，都是可以看 Crash、Log、网络请求、文件等，比较特别的就是
  ：手机的CPU等使用情况、虚拟定位。这个框架的 crash 确实是可以看到的，但是同时，他的 Log 也是只能看到自己的 LLog.log(message: "123456789")。以下是集成：

pod 'LLDebugToolSwift' , :configurations => ['Debug']

extension AppDelegate {
    
    func setupLLDebug() {
        LLDebugTool.shared().startWorking{ config in
            config.logStyle = .detail
        }
    }
    
}

• LifetimeTracker
  检查项目的内存泄漏问题，但是我没弄懂怎么使用。以下为集成方法：

pod 'LifetimeTracker'

• LifetimeTracker
  腾讯也出品了一个检测内存泄漏的。

• SkeletonView
  这是一种向用户展示某事正在发生并让他们为正在等待的内容做好准备的优雅方式

class SkeletonViewDemoController: UIViewController {
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        self.view.addSubview(self.label)
        self.label.snp.makeConstraints { make in
            make.leading.equalTo(20)
            make.centerX.equalToSuperview()
            make.top.equalTo(100)
            make.height.equalTo(40)
        }
        
        self.view.addSubview(self.imageView)
        self.imageView.snp.makeConstraints { make in
            make.top.equalTo(self.label.snp.bottom).offset(20)
            make.width.height.equalTo(100)
            make.centerX.equalToSuperview()
        }
        
        self.label.showAnimatedGradientSkeleton()
        self.imageView.showAnimatedGradientSkeleton()
        
        Timer.after(5) {
            self.label.hideSkeleton()
            self.imageView.hideSkeleton()
        }
    }
    
    //MARK: - lazy load -
    private lazy var label: UILabel = {
        let label = UILabel()
        label.font = .systemFont(ofSize: 20)
        label.textColor = .red
        label.isSkeletonable = true
        label.text = "1f1wfagwagwag12512t3t1g1g"
        return label
    }()
    
    private lazy var imageView: UIImageView = {
        let imageView = UIImageView()
        imageView.isSkeletonable = true
        imageView.contentMode = .scaleAspectFit
        imageView.image = UIImage(named: "ic_art")
        return imageView
    }()
}

效果：

SkeletonView效果.gif

• WCDB
  基于 SQLite 和 SQLCipher 开发的数据库，TX爸爸出品的，看起来很好用，正在接入试试

pod 'WCDB.cpp'

• SwiftMessages
  提供多种丰富的消息弹窗样式的控件

var config = SwiftMessages.Config()
config.presentationStyle = .center
config.presentationContext = .window(windowLevel: .alert)
config.prefersStatusBarHidden = true
config.duration = .forever
config.dimMode = .gray(interactive: true)
config.interactiveHide = false
SwiftMessages.show(config: config, view: self.popupView)

效果：

SwiftMessagesSegue.gif

• Instructions
  引导视图
  目前使用的过程中有点问题，我给控制器中央的一个view设置了引导，但是引导View却出现在了状态栏位置，被遮挡住了一部分
  QQ20230411-0.jpg