此仓库包含 isowords 的完整源代码，这是一款在消失的立方体上玩的 iOS 单词搜索游戏。连接触摸到的字母以组成单词，越长越好，并且当第三次使用某个字母时，其立方体将被移除，从而显示更多内部的字母！

现已在 App Store 上架！

• 关于
• 开始使用
• 了解更多
• 相关项目
• 许可证

isowords 是一个大型且复杂的应用程序，完全使用 Swift 构建。iOS 客户端的逻辑构建于 Composable Architecture 之上，UI 主要使用 SwiftUI 构建，少量使用 SceneKit。服务器也使用 Swift 和我们实验性的 Web 服务器库构建。

我们在 Point-Free 上发布了一个包含 4 部分视频的系列，涵盖了这些主题以及更多内容。Point-Free 是一个探索函数式编程和 Swift 语言的视频系列，由 Brandon Williams 和 Stephen Celis 主持。

您可能会觉得有趣的一些事情

整个应用程序都由 Composable Architecture 驱动，这是一个我们在 Point-Free 上从头开始构建的库，它提供了用于构建应用程序的工具，重点关注可组合性、模块化和可测试性。这意味着

• 整个应用程序的状态都保存在一个单一的事实来源中，称为 Store。
• 整个应用程序的行为都由一个单一的单元实现，称为 Reducer，它由许多其他 reducer 组成。
• 所有有副作用的操作都显式地表示为从 reducer 返回的值。
• 依赖项被显式地表示为简单的数据类型，封装了它们的实时实现以及各种模拟实例。

以这种方式设计应用程序有很多好处

• 大型、复杂的功能可以分解为更小的子域，这些子域可以通过简单的状态突变进行通信。通常，这在 SwiftUI 中通过访问 ObservableObject 实例内部的单例来完成，但在 Composable Architecture 中则不是必需的。
• 我们控制依赖项，而不是让它们控制我们。仅仅因为您在代码中使用了 StoreKit、GameCenter、UserNotifications 或任何其他第三方 API，并不意味着您应该牺牲在模拟器、SwiftUI 预览中运行应用程序或编写简洁测试的能力。
• 可以非常快速地编写详尽的测试。我们测试非常详细的用户流程，捕获细微的边缘情况，并断言效果如何执行以及它们的输出如何反馈到应用程序中。
• 编写集成测试以练习应用程序的多个独立部分非常简单。

该应用程序以超模块化的风格构建。在编写此 README 时，客户端和服务器被拆分为 86 个模块。这使我们能够在不构建整个应用程序的情况下开发功能，从而缩短编译时间并提高 SwiftUI 预览的稳定性。这也使我们能够轻松地发布 App Clip，其大小必须小于 10 MB未压缩，通过选择构建所需的最低限度的代码和资源。

iOS 客户端和服务器的代码都包含在这个单一的仓库中。这使得同时运行客户端和服务器变得容易，我们甚至可以同时调试它们，例如，在模拟器发出 API 请求时在服务器中设置断点。

我们还在客户端和服务器之间共享大量代码

• 描述玩家、谜题、移动等的核心类型。
• 游戏逻辑，例如随机谜题生成器、谜题验证、字典等等。
• 用于处理服务器上请求的路由器与 iOS 客户端用于向服务器发出 API 请求的代码完全相同。新的路由只需指定一次，即可立即供客户端和服务器使用。
• 我们编写集成测试，同时测试服务器和 iOS 客户端。在测试期间，客户端发出的 API 请求实际上是在底层运行真正的服务器代码。
• 以及更多...

我们上传到此应用的 App Store 的屏幕截图和预览视频是自动生成的。

• 屏幕截图是由 测试套件 使用我们的 SnapshotTesting 库生成的，并且完成了构建非常特定的状态片段的工作，我们将其加载到屏幕中，以及框架 UI 和提供周围的图形。

• 预览视频是通过屏幕录制运行 精简版本 的应用程序生成的，该应用程序将特定字母嵌入到立方体上并运行一系列操作来模拟用户玩游戏。该应用程序可以通过在 Xcode 中选择 TrailerPreview 目标并在模拟器中运行来本地运行。

有时我们希望在不构建整个应用程序的情况下隔离测试某个功能。SwiftUI 预览非常适合此目的，但它们也有其局限性，例如，如果您需要使用预览不可用的 API，或者如果您需要调试更复杂的流程等等。

因此，我们创建了 迷你应用程序，它们构建了组成整个应用程序的 86+ 个模块 的一个小子集。设置这些应用程序只需要最少的工作量。您只需在 Xcode 项目中指定您需要的依赖项，然后创建一个入口点来启动该功能。

例如，这里是创建预览应用程序以隔离运行 onboarding 流程所需的所有代码。如果我们受限于完整的应用程序来测试此功能，我们将需要不断地删除和重新安装该应用程序，因为此屏幕仅在首次启动时显示。

此仓库包含运行整个 isowords 应用程序的客户端和服务器代码，以及广泛的测试套件。要使程序运行，请执行以下操作

1. 确保安装了 git-lfs，以便可以获取应用程序资源（图像等）。例如，使用 Homebrew

   $ brew install git-lfs  # Download and install Git LFS
   $ git lfs install       # Set up Git LFS for your user

2. 获取代码

   git clone https://github.com/pointfreeco/isowords
   cd isowords

3. 引导应用程序

   1. 如果您只对构建 iOS 客户端感兴趣，请运行以下引导命令

      make bootstrap-client

   2. 如果您想构建客户端和服务器，请确保已安装并运行 PostgreSQL，然后运行以下引导命令

      make bootstrap

4. 打开 Xcode 项目 App/isowords.xcodeproj。

5. 要在本地运行客户端，请在 Xcode 中选择 isowords 目标并运行 (⌘R)。

6. 要在本地运行服务器，请在 Xcode 中选择 server 目标并运行 (⌘R)。

本 README 中讨论的大部分概念都在 Point-Free 上进行了深入探讨，这是一个探索函数式编程和 Swift 语言的视频系列，由 Brandon Williams 和 Stephen Celis 主持。

此应用程序使用了许多由我们构建并在 Point-Free 上讨论的开源项目，包括

• Case Paths
• Composable Architecture
• Custom Dump
• Gen
• Identified Collections
• Overture
• Tagged
• SnapshotTesting

本仓库中的源代码仅可出于教育目的运行和更改，不得用于商业目的。有关更多信息，请参阅我们的完整许可证。