Swiftlet 实用工具 提供了一系列有用的函数，这些函数在用 SwiftUI 和 Xcode 编写的许多应用程序中都很常见。 这些函数包括测试应用程序是否可以连接到互联网等功能。

注意：Swiftlet 实用工具 是我们 Action Utilities 库的替代品，专门用于与 SwiftUI 配合使用。 许多其他功能也已现代化和改进。

此外，许多内置类型（例如 Color、String 和 Data）都已扩展了有用的功能，例如将颜色转换为十六进制字符串或从十六进制字符串转换颜色，以及在 Data 和 String 类型之间轻松移动图像以支持 Swift 的 Codable 协议。

Swiftlet 实用工具 支持 iOS、tvOS、watchOS 和 macOS。

如果您发现 SwiftletUtilities 很有用，并希望帮助支持其持续开发和维护，请考虑进行少量捐赠，尤其是在商业产品中使用它时。

正是通过像您这样的贡献者的支持，我才能继续免费构建、发布和维护像 SwiftletUtilities 这样高质量、文档完善的 Swift 包。

Swift Package Manager (Xcode 11 及以上)

1. 在 Xcode 中，选择 File > Add Package Dependency… 菜单项。
2. 在对话框中粘贴 https://github.com/Appracatappra/SwiftletUtilities.git。
3. 按照 Xcode 的说明完成安装。

为什么不是 CocoaPods 或 Carthage 或空白？

支持多个依赖项管理器会使维护库的复杂度呈指数级增长，并且非常耗时。

由于 Swift Package Manager 与 Xcode 11（及更高版本）集成，因此它是进一步支持的最简单选择。

通用实用工具 提供了一些通用的实用工具类，用于处理诸如网络连接之类的事情。

提供以下扩展

• HTMLEntity - 解码给定的字符串，将任何 HTML 实体代码转换为其结果字符。
• Reachability - 测试我们是否具有活动的网络连接。

硬件实用工具 提供有关应用程序运行设备的一些常用信息，例如设备类型（例如 iPhoneX）、操作系统版本（例如 iOS 11.1）以及应用程序是否可以连接到互联网。

提供以下扩展

• AppleHardwareType - [已弃用] 用于将 Apple 设备型号名称（以 iPhone10,3 形式）转换为人类可读的形式（例如 iPhoneX）。 此枚举与 HardwareInformation 类一起使用，以获取应用程序运行的设备类型。
• HardwareInformation - 定义了一组在 Apple 设备上工作时的便捷属性和函数，例如检查设备型号名称 (iPhone10,3)、获取设备类型 (iPhoneX)、获取操作系统版本 (iOS 11.1)、当前设备方向和互联网连接状态
  • isPhone - 如果应用程序在 iPhone 上运行，则返回 true，否则返回 false。
  • isPad - 如果应用程序在 iPad 上运行，则返回 true，否则返回 false。
  • isTV - 如果应用程序在 Apple TV 上运行，则返回 true，否则返回 false。
  • isCar - 如果应用程序在连接到 CarPlay 的设备上运行，则返回 true，否则返回 false。
  • isWatch - 如果应用程序在 Apple Watch 上运行，则返回 true，否则返回 false。
  • isMac - 如果应用程序在 Mac 笔记本电脑或台式机上运行，则返回 true，否则返回 false。
  • modelName - 返回应用程序运行的设备的型号名称。 例如，iPhone X 的 iPhone10,3 或 iPhone10,6。
  • deviceType - 返回应用程序运行的设备的人类可读类型（例如 iPhoneX），如果无法发现该类型，则返回 unknown。
  • osVersion - 返回安装在应用程序运行的设备上的操作系统的版本号（例如 iOS 11.1）。

Swiftlet 扩展 为常见的内置 SwiftUI 和 Swift 数据类型提供了一些有用的功能，例如在 Color 和十六进制字符串（例如 #FF0000）之间进行转换、从存储在 Data 对象中的 Base64 编码字符串创建 Image 实例以及将 Images 编码为 Base64 字符串或 Data 对象。

// Assign a color from a string
let color: Color ~= "#FF0000"

// Initialize a color from a hex string
let green = Color(fromHex: "00FF00")

// Convert color to a hex string
let white = Color.white.toHex()

提供以下扩展

• Color - 扩展 Color 以支持 Action Data 控件，并添加便捷方法以在 Codable、Encodable 或 Decodable 类中使用颜色。
• Data - 扩展 Data 以支持 Action Data 控件，并添加便捷方法以在 Codable、Encodable 或 Decodable 类中使用数据属性。
• Image - 扩展 Image 以支持 Action Data 控件，并添加便捷方法以在 Codable、Encodable 或 Decodable 类中使用图像属性。
• String - 扩展 String 以支持 Action Data 控件，并添加便捷方法以在 Codable、Encodable 或 Decodable 类中使用 Image 和 Color 属性。
• Array - 使用用于处理集合的新函数扩展 Array。
• Double - 使用一些有用的特性扩展 Double。
• Int - 使用一些有用的特性扩展 Int。
• @Published - 允许标记为 @Published 的属性，并允许它们通过 Encode 和 Decode 一致性进行 Codable。
• View - 根据目标操作系统有条件地应用修饰符。

Package 包含所有功能的完整 DocC 文档。