SwiftUI Redux 工具集

Twitter: @cypher_poet

一个工具集合,用于以 Redux/Elm 风格(Reducer、Action、副作用和中间件)构建 SwiftUI 应用程序。

安装

Xcode 项目

选择 File -> Swift Packages -> Add Package Dependency 并输入 https://github.com/CypherPoet/SwiftUIReduxUtils

Swift Package Manager 项目

您可以在您的 Package.swift 文件中添加 CypherPoetSwiftUIReduxUtils 作为包依赖项。

let package = Package(
    //...
    dependencies: [
        .package(
            name: "CypherPoetSwiftUIReduxUtils",
            url: "https://github.com/CypherPoet/SwiftUIReduxUtils",
            .upToNextMinor(from: "0.5.0")
        ),
    ],
    //...
)

从那里,在您项目的任何目标依赖项中引用由 CypherPoetSwiftUIReduxUtils “包”提供的 SwiftUIReduxUtils “产品”。

targets: [
    .target(
        name: "YourLibrary",
        dependencies: [
            .product(
                name: "SwiftUIReduxUtils",
                package: "CypherPoetSwiftUIReduxUtils"
            ),
        ],
        ...
    ),
    ...
]

然后,只需在任何您想使用它的地方 import SwiftUIReduxUtils 即可。

用法

这些工具的目标是作为基础,用于以 Redux/Elm 风格(Reducer、Action、副作用和中间件)构建 SwiftUI 应用程序。

0.2.2 版本 有一个示例应用程序展示了这一点,但在 0.3.0 的并发重构之后,它不再起作用。 尽管如此,在我找到新的示例之前,它在某种程度上仍然可能有用。

贡献

目前这里没有太多的待办事项,但绝对不鼓励反馈和建议。 查看一些 问题模板 以获取更多信息。

开发

要求

📜 创建和构建文档

文档使用 Xcode 的 DocC 构建。 有关如何构建、运行和创建 DocC 内容,请参阅 Apple 的指南

目前,查看文档的最佳方式是在 Xcode 中打开项目并运行 Build Documentation 命令。 在未来的某个时候,我希望利用这些工具来生成/托管 DocC 文档。 (如果您对此有任何想法或工具建议,请随时告诉我 🙂)。

致谢

如果没有 Swift 社区中其他人的一些具有启发性的项目、文章和教程,这个项目是不可能实现的,他们都致力于在 SwiftUI 中使用这些模式。 以下是其中一些主要灵感来源:

许可

CypherPoetSwiftUIReduxUtils 在 MIT 许可下可用。 有关更多信息,请参见 LICENSE 文件