SwiftlyUI 开源项目最佳实践

1、项目介绍

SwiftlyUI 是一个开源项目，旨在通过链式语法和现代化的 API 设计，为 UIKit 开发注入 SwiftUI 的开发效率。它允许开发者以更简洁和高效的方式构建 UIKit 应用，同时保持对底层控件操作能力的完整控制权，实现了“零转换成本”的 SwiftUI 式开发体验。

SwiftlyUI 的主要特点包括：

• 渐进式迁移: 可以逐步改造现有的 UIKit 项目，无需重写现有代码。
• Swift 原生支持: 专为 Swift 设计的链式语法，类型安全且 IDE 友好。
• 完整 UIKit 能力: 保留底层控件操作能力，不引入额外的抽象层。
• 企业级兼容: 支持 iOS 13+，完美适配存量项目。

2、项目快速启动

要快速启动 SwiftlyUI 项目，您需要首先将其集成到您的 Swift 项目中。以下是如何使用 CocoaPods 和 Swift Package Manager 进行集成的方法：

使用 CocoaPods

# 核心组件
pod 'SwiftlyUI'

如果 pod 安装失败，请使用以下方式：

pod 'SwiftlyUI', :git => 'https://github.com/CoderLineChan/SwiftlyUI.git', :tag => '1.1.2'

使用 Swift Package Manager

在 Package.swift 文件中添加：

dependencies: [
    .package(url: "https://github.com/CoderLineChan/SwiftlyUI.git", from: "1.1.4")
]

安装成功后，您需要在 AppDelegate.swift 文件中添加以下代码来设置全局导入：

@_exported import SwiftlyUI

3、应用案例和最佳实践

SwiftlyUI 提供了多种特性，使得构建 UIKit 应用更加高效和简便。以下是一些应用案例和最佳实践：

链式语法：属性设置增强

使用链式语法可以大大简化代码，减少冗余字符，并使属性设置更加直观。例如：

let stackView = UIStackView()
    .axis(.vertical)
    .spacing(10)
    .alignment(.center)
    .distribution(.fillEqually)
    .padding(.top, 20)
    .padding(.left, 20)
    .padding(.horizontal, 16)
    .padding(16)
    .separator(color: .red, size: CGSize(width: 20, height: 2))

现代化交互封装：手势识别事件简化

SwiftlyUI 提供了对 UIKit 所有手势类型的支持，并且以更简洁的方式封装了手势识别事件。例如，为视图添加点击手势：

let view = UIView()
    .onGesture(.tap) { _ in
        print("tapAction")
    }

声明式动画引擎：像 SwiftUI 一样驱动 UIKit

使用 SwiftlyUI，您可以像 SwiftUI 一样轻松地驱动 UIKit 动画：

withAnimation(.easeInOut) {
    self.view.transform = CGAffineTransform(scaleX: 1.2, y: 1.2)
}

智能布局系统 Auto Layout：前置约束 + 自适应布局

SwiftlyUI 的智能布局系统允许您在添加父控件之前设置约束，并支持自适应布局：

let view = UIView()
    .frame(width: 20)
    .frame(height: 100)
    .left(to: superView.leftAnchor, offset: 30)
    .top(to: superView, offset: 30)
    .fill(to: superView)
    .fill(to: brother, UIEdge Insets(top: 10, left: 10, bottom: 10, right: 10))
    .leading(to: superView)
    .bottom(to: superView)
    .width(20)
    .width(to: view, multiplier: 1.2)
superView.addSubview(view)

4、典型生态项目

SwiftlyUI 的生态项目包括但不限于 UIKit Plus，它为 UIKit 注入了 SwiftUI 的开发效率。通过使用 UIKit Plus，开发者可以享受到 SwiftUI 的开发效率，同时保持对 UIKit 的完整控制权。