Swift中如何将PDF文档保存至「Files」应用

我之前也碰到过完全一样的需求，折腾了好一阵才找到正确的实现方式！要让你生成的PDF能像Safari下载的那样被「Files」应用访问，核心是借助iOS系统提供的UIDocumentPickerViewController来实现系统级的保存选择界面，下面是一步步的具体操作：

步骤1：准备PDF临时文件 #

假设你已经通过代码生成了PDF的Data对象（比如命名为pdfData），首先我们需要把它写入到临时目录的一个文件中，方便后续导出：

guard let tempDir = FileManager.default.temporaryDirectory else { 
    print("获取临时目录失败")
    return 
}
let tempFileURL = tempDir.appendingPathComponent("generated.pdf")
do {
    try pdfData.write(to: tempFileURL)
} catch {
    print("写入临时文件出错：\(error.localizedDescription)")
    return
}

步骤2：弹出系统保存选择器 #

用UIDocumentPickerViewController的导出模式初始化，这样就能弹出和Safari完全一致的保存界面，用户可以选择存到「Files」里的任意位置（包括iCloud Drive或本地存储）：

let documentPicker = UIDocumentPickerViewController(
    forExporting: [tempFileURL], 
    asCopy: true
)
documentPicker.delegate = self
documentPicker.allowsMultipleSelection = false
// 可选：设置默认打开的目录，比如iCloud Drive的Documents文件夹
// if let iCloudDir = FileManager.default.url(forUbiquityContainerIdentifier: nil)?.appendingPathComponent("Documents") {
//     documentPicker.directoryURL = iCloudDir
// }
present(documentPicker, animated: true)

步骤3：处理保存结果 #

记得让你的ViewController遵守UIDocumentPickerDelegate协议，然后实现代理方法来处理保存成功或取消的情况：

extension YourViewController: UIDocumentPickerDelegate {
    func documentPicker(_ controller: UIDocumentPickerViewController, didPickDocumentsAt urls: [URL]) {
        // 用户成功保存PDF，这里可以给用户一个提示
        print("PDF已成功保存到：\(urls.first?.absoluteString ?? "")")
        // 清理临时文件
        try? FileManager.default.removeItem(at: tempFileURL)
    }
    
    func documentPickerWasCancelled(_ controller: UIDocumentPickerViewController) {
        // 用户取消了保存，同样清理临时文件
        try? FileManager.default.removeItem(at: tempFileURL)
    }
}

额外注意事项 #

• iCloud权限配置：如果需要支持保存到iCloud Drive，要在Xcode的「Signing & Capabilities」里添加iCloud服务，并勾选「iCloud Documents」；或者手动在Info.plist中添加NSUbiquitousContainers相关配置。
• 后台处理：如果你的PDF文件较大，建议把写入临时文件的操作放到后台线程执行，避免阻塞主线程导致界面卡顿。
• 沙盒限制：不要尝试直接写入应用沙盒内的Documents目录，这个目录默认是应用私有，「Files」应用无法直接访问，必须通过系统文档选择器让用户主动选择保存位置，才能让文件出现在「Files」的可访问区域。

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