如何在iOS Swift应用中读取iCloud Drive桌面文件夹内的PDF文件？

可能的原因及解决方案 #

1. 修正iCloud文件路径 #

你当前的路径拼接存在错误，iCloud Drive的用户桌面文件夹实际位于容器的Documents目录下，而非根目录。修改路径拼接代码：

guard let fileURL = FileManager.default.url(forUbiquityContainerIdentifier: nil)?
        .appendingPathComponent("Documents")
        .appendingPathComponent("Desktop")
        .appendingPathComponent("samplePIL1436.pdf") else {
    print("无法获取iCloud容器路径"); return
}

2. 检查模拟器iCloud同步状态 #

• 打开模拟器的「设置」，登录与Mac一致的Apple ID，确保「iCloud Drive」已开启
• 等待几分钟让模拟器完成iCloud文件同步（系统能看到文件不代表应用能立即访问到）

3. 完善iCloud权限配置 #

确认info.plist中的NSUbiquitousContainers字典配置正确，示例如下：

<key>NSUbiquitousContainers</key>
<dict>
    <key>iCloud.com.yourcompany.yourapp</key>
    <dict>
        <key>NSUbiquitousContainerIsDocumentScopePublic</key>
        <true/>
        <key>NSUbiquitousContainerName</key>
        <string>Your App Name</string>
        <key>NSUbiquitousContainerSupportedFolderLevels</key>
        <string>Any</string>
    </dict>
</dict>

替换iCloud.com.yourcompany.yourapp为你的实际容器ID（可在Xcode的Signing & Capabilities中查看）

4. 异步处理iCloud文件下载 #

iCloud文件是按需下载的，直接同步读取可能失败，需先触发下载并等待完成：

override func viewDidLoad() {
    super.viewDidLoad()
    
    guard let fileURL = FileManager.default.url(forUbiquityContainerIdentifier: nil)?
            .appendingPathComponent("Documents")
            .appendingPathComponent("Desktop")
            .appendingPathComponent("samplePIL1436.pdf") else {
        print("无法获取iCloud容器路径"); return
    }
    
    // 触发文件下载
    do {
        try FileManager.default.startDownloadingUbiquitousItem(at: fileURL)
        // 监听下载完成通知
        NotificationCenter.default.addObserver(self, selector: #selector(handleFileDownloaded(_:)), name: NSNotification.Name.NSUbiquitousItemDownloadCompleted, object: fileURL)
    } catch {
        print("触发下载失败：\(error)")
    }
}

@objc func handleFileDownloaded(_ notification: Notification) {
    guard let fileURL = notification.object as? URL else { return }
    do {
        let pdfFileData = try Data(contentsOf: fileURL)
        print(pdfFileData[0])
    } catch {
        print("读取文件失败：\(error)")
    }
}

5. 打印具体错误信息 #

把原代码中的try?改为do-catch，获取详细错误原因，这是排查问题的关键：

guard let fileURL = ... else { ... }
do {
    let pdfFileData = try Data(contentsOf: fileURL)
    print(pdfFileData[0])
} catch {
    print("读取错误：\(error.localizedDescription)")
    print("错误详情：\(error)")
}

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