dnrops/SwifterSwift

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

v5.3 有什么新功能?

要求

iOS 10.0+ / tvOS 9.0+ / watchOS 2.0+ / macOS 10.10+ / Ubuntu 14.04+
Swift 5.0+

希望将 SwifterSwift 用于旧版本的 Swift

SwifterSwift 从 v5 开始兼容 Swift v5.0+

要与 Swift 3 / Xcode 8.x 一起使用，请确保您使用的是 v3.1.1。
要与 Swift 3.2 / Xcode 9.x 一起使用，请确保您使用的是 v3.2.0。

安装

CocoaPods

要使用 CocoaPods 将 SwifterSwift 集成到您的 Xcode 项目，请在您的 Podfile 中设置:

- 集成所有扩展（推荐）:

pod 'SwifterSwift'

- 仅集成 SwiftStdlib 扩展:

pod 'SwifterSwift/SwiftStdlib'

- 仅集成 Foundation 扩展:

pod 'SwifterSwift/Foundation'

- 仅集成 UIKit 扩展:

pod 'SwifterSwift/UIKit'

- 仅集成 AppKit 扩展:

pod 'SwifterSwift/AppKit'

- 仅集成 MapKit 扩展:

pod 'SwifterSwift/MapKit'

- 仅集成 CoreGraphics 扩展:

pod 'SwifterSwift/CoreGraphics'

- 仅集成 CoreLocation 扩展:

pod 'SwifterSwift/CoreLocation'

- 仅集成 SpriteKit 扩展:

pod 'SwifterSwift/SpriteKit'

- 仅集成 SceneKit 扩展:

pod 'SwifterSwift/SceneKit'

- 仅集成 StoreKit 扩展:

pod 'SwifterSwift/StoreKit'

- 仅集成 Dispatch 扩展:

pod 'SwifterSwift/Dispatch'

- 仅集成 WebKit 扩展:

pod 'SwifterSwift/WebKit'

- 仅集成 HealthKit 扩展:

pod 'SwifterSwift/HealthKit'

Carthage

要使用 Carthage 将 SwifterSwift 集成到您的 Xcode 项目中，请在您的 Cartfile 中设置:

github "SwifterSwift/SwifterSwift" ~> 5.3

Swift Package Manager

你可以使用 The Swift Package Manager 来安装 SwifterSwift，请在你的 Package.swift 文件中添加正确的描述:

import PackageDescription
let package = Package(
    name: "YOUR_PROJECT_NAME",
    targets: [],
    dependencies: [
        .package(url: "https://github.com/SwifterSwift/SwifterSwift.git", from: "5.3.0")
    ]
)

接下来，将 SwifterSwift 添加到您的 targets 依赖项中，如下所示:

.target(
    name: "YOUR_TARGET_NAME",
    dependencies: [
        "SwifterSwift",
    ]
),

然后运行 swift package update。

请注意，Swift Package Manager 不支持为 iOS/tvOS/macOS/watchOS 应用程序编译 - 请参阅下一节中的 Accio。

Accio

Accio 是一个基于 SwiftPM 的依赖管理器，可以为 iOS/macOS/tvOS/watchOS 构建框架。因此，集成步骤与上述完全相同。一旦你的 Package.swift 文件被配置，你需要运行 accio update 而不是 swift package update。

手动

将 SwifterSwift 文件夹添加到您的 Xcode 项目以使用所有扩展或特定扩展。

对于您的 test targets，您还可以添加 XCTest 文件夹。

所有扩展列表

SwiftStdlib 扩展

Foundation 扩展

UIKit 扩展

AppKit 扩展

CoreGraphics 扩展

CoreLocation 扩展

CoreAnimation 扩展

CAGradientLayer extensions

MapKit 扩展

SpriteKit 扩展

SKNode extensions

SceneKit 扩展

StoreKit 扩展

SKProduct extensions

Dispatch 扩展

DispatchQueue extensions

WebKit 扩展

WKWebView extensions

HealthKit 扩展

HKActivitySummary extensions

XCTest 扩展

XCTest extensions

这有多酷？

SwifterSwift 是一个包含 500 多个属性和方法的库，旨在扩展 Swift 的功能和生产力，并忠实于原生的 Swift API 设计指南。

查看项目中的 Examples.playground 以获取一些很酷的示例！

文档

所有扩展的文档和示例都在 swifterswift.com/docs

参与其中

我们希望得到您的反馈。参与前请参阅 contributing guidelines。

Slack 频道:

使用 SwifterSwift 与其他人交谈并交流经验总是很愉快，所以加入我们的 Slack 频道吧。

鸣谢

特别感谢：

Steven Deutsch, Luciano Almeida 和 Guy Kogus 对扩展、文档和测试的最新贡献。
Paweł Urbanek 添加了 tvOS、watchOS 和 macOS 的初始化支持和帮助扩展。
Mert Akengin 和 Bashar Ghadanfar 设计了 project website 和 logo.
非常感谢这个项目的所有其他贡献者。

License 协议

SwifterSwift 在 MIT 许可协议下发布的。有关更多信息，请参阅 LICENSE。