SwiftUI: 将数据写入文档目录

之前，我们研究了如何向UserDefaults读取和写入数据，该方法非常适合用户偏好设置或者是少量的 JSON。但是，那通常不是存储数据的好地方，特别是如果您认为将来会开始存储更多数据。

在此应用中，我们将允许用户创建所需数量的数据，这意味着我们希望有一个更好的存储解决方案，并希望获得最佳结果，而不仅仅是将其放入UserDefaults中。幸运的是，iOS使从设备存储中读取和写入数据变得非常容易，实际上，所有应用程序都有一个目录来存储我们想要的任何类型的文档。此处的文件会自动与 iCloud 备份同步，因此，如果用户使用新设备，则我们的数据将与所有其他系统数据一起还原——我们甚至无需考虑它。

有一个陷阱——该目录总是存在吗？——所有iOS应用程序都经过沙盒处理，这意味着它们在带有难以猜测目录名称的容器中运行。因此，我们不能（也不应尝试）猜测应用程序的安装目录，而需要依靠Apple的API查找应用程序的文档目录。

没有很好的方法，所以我几乎总是将相同的帮助程序方法复制并粘贴到我的项目中，现在我们将做完全相同的事情。这使用了一个称为FileManager的新类，该类可以为我们提供当前用户的文档目录。从理论上讲，它可以返回几个路径URL，但是我们只关心第一个。

因此，将此方法添加到ContentView中：

func getDocumentsDirectory() -> URL {
    // 查找该用户的所有可能的文档目录
    let paths = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)

    // 只需返回第一个，应该是唯一的一个
    return paths[0]
}

该文档目录是我们自己需要处理的，并且由于它属于该应用程序，因此如果该应用程序本身被删除，它将自动被删除。除了物理设备限制外，我们没有多少存储空间限制，尽管请记住，用户可以使用``设置''应用程序查看您的应用程序占用了多少存储空间——谨记！

现在我们有了一个可以使用的目录，我们可以在那里自由地读写文件。您已经见过了用于读取数据的String(contentsOf:)和Data(contentsOf :)，但是对于写入数据，我们需要使用write(to:)方法。与字符串一起使用时，它需要三个参数：

要写入的URL。
是否使写入原子化，这意味着“全部一次性”。
使用什么字符编码。

可以通过将文档目录URL与文件名（例如myfile.txt）组合来创建其中的第一个。

第二个几乎应该始终设置为 true。如果将其设置为false并且我们尝试写入大文件，则我们应用的另一部分可能会尝试在仍在写入文件的同时读取该文件。这不会导致崩溃或其他任何事情，但这确实意味着它将仅读取部分数据，因为尚未写入其他部分。原子写入会导致系统将完整文件写入一个临时文件名（而不是我们要求的文件名），完成后，它会简单地重命名为目标文件名。这意味着要么整个文件都存在，要么什么都没有。

第三个参数是我们在项目5中简要介绍的内容，因为我们必须将 Swift 字符串与 Objective-C API 结合使用。那时我们使用了字符编码 UTF-16，这是 Objective-C 所使用的，但是 Swift 的本机编码是 UTF-8，因此我们将改用它。

为了将所有这些代码付诸实践，我们将修改模板的默认文本视图，以便将测试字符串写入documents目录中的文件，再将其读回新字符串，然后将其打印出来——完成读写数据的周期。

将ContentView 的 body 属性更改为如下代码：

Text("Hello World")
    .onTapGesture {
        let str = "测试消息"
        let url = self.getDocumentsDirectory().appendingPathComponent("message.txt")

        do {
            try str.write(to: url, atomically: true, encoding: .utf8)
            let input = try String(contentsOf: url)
            print(input)
        } catch {
            print(error.localizedDescription)
        }
    }

运行该程序后，您应该可以点击标签以查看“测试消息”，该消息已打印到 Xcode 的调试输出区域。

在继续之前，这对您来说是一个小挑战：在项目8中，我们研究了如何在 Bundle 上创建通用扩展，该扩展使我们能够查找，加载和解码应用程序包中的所有可编码数据。您是否可以为documents目录编写类似的内容，也许可以将其作为FileManager的一个扩展？