Swift iOS开发：如何将文件保存到iCloud Drive实现多位置可见

你当前写入的是应用私有iCloud容器目录，默认该目录不会向iCloud Drive公开，因此只能在iCloud存储管理页看到，无法在系统文件App、其他支持iCloud Drive的位置访问。

1. 配置iCloud Drive公开权限 #

首先需要在项目配置中声明容器对iCloud Drive可见：

• 打开项目Signing & Capabilities页，确认已添加iCloud能力，且勾选了iCloud Documents选项，不要仅勾选键值存储选项。
• 打开项目的Info.plist文件，添加NSUbiquitousContainers字典配置，以你的iCloud容器ID（即路径中iCloud~project~iCloud字段）为key，在对应容器配置下添加三个字段：
  • NSUbiquitousContainerIsDocumentScopePublic：布尔值设为YES，声明容器Documents目录公开到iCloud Drive
  • NSUbiquitousContainerName：字符串值，设置iCloud Drive中显示的文件夹名称，一般填应用名即可
  • NSUbiquitousContainerSupportedFolderLevels：字符串值填Documents，指定公开的目录层级

注意：修改完上述配置后，需要提升应用Build版本号后重新安装到设备，系统才会刷新容器权限配置，旧版本安装的缓存不会自动生效。

2. 优化写入代码 #

原代码存在强制解包、主线程做文件IO的问题，参考修正后的代码：

guard let containerUrl = FileManager.default.url(forUbiquityContainerIdentifier: nil)?.appendingPathComponent("Documents") else {
    print("iCloud容器不可用，请检查iCloud登录状态与权限")
    return
}

do {
    if !FileManager.default.fileExists(atPath: containerUrl.path) {
        try FileManager.default.createDirectory(at: containerUrl, withIntermediateDirectories: true)
    }
    let fileUrl = containerUrl.appendingPathComponent("test.txt")
    
    guard let originalData = try? Data(contentsOf: file.fileURL),
          let accData = String(data: originalData, encoding: .utf8) else {
        print("源文件读取失败")
        return
    }
    print(accData)
    
    DispatchQueue.global(qos: .utility).async {
        do {
            try accData.data(using: .utf8)?.write(to: fileUrl)
            // 可选：标记文件为iCloud可用状态，触发系统同步
            var resValues = URLResourceValues()
            resValues.isUbiquitousItem = true
            try? fileUrl.setResourceValues(resValues)
        } catch {
            print("iCloud写入失败：\(error.localizedDescription)")
        }
    }
} catch {
    print("iCloud目录创建失败：\(error.localizedDescription)")
}

3. 验证注意事项 #

• 确认测试设备已开启iCloud Drive功能：设置->Apple ID->iCloud->iCloud Drive 开关处于打开状态
• 配置首次生效时，系统可能需要数分钟同步目录结构，若文件App中暂时看不到对应文件夹，可稍等或重启设备后再查看
• 生效后文件会出现在系统「文件」App的iCloud Drive路径下，以你配置的应用名命名的文件夹内，支持其他合规应用访问。

内容的提问来源于stack exchange，提问作者Henryk Borzymowski