iOS 17中Swift无法在系统Files应用保存文件的求助

问题原因 #

iOS 17对应用容器存储策略做了调整：默认情况下，应用的Documents目录不再自动显示在Files应用的「我的iPhone」列表中。你的代码实际上已经成功将文件保存到了应用私有容器的Documents目录（控制台输出的路径可佐证），但这个目录现在默认对用户不可见，导致你在Files里找不到文件。

解决方案 #

有两种可行方案，可根据需求选择：

方案一：让用户自主选择保存位置（苹果推荐） #

使用UISaveToDocumentsPickerViewController，引导用户将文件保存到Files应用的公共目录（如「我的iPhone」根目录、iCloud Drive等），这更符合iOS 17的隐私与用户控制设计原则。

替换原有saveFile方法的示例代码：

func saveFileToUserSelectedLocation(_ name: String, fileExtension: String, url: URL, progressHandler: ((Float) -> Void)? = nil, completionHandler: ((Error?) -> Void)? = nil) {
    let downloadTask = URLSession.shared.downloadTask(with: url) { tempURL, response, error in
        if let error = error {
            DispatchQueue.main.async {
                completionHandler?(error)
            }
            return
        }
        
        guard let tempURL = tempURL else {
            let downloadError = NSError(domain: "Download error", code: 0, userInfo: [NSLocalizedDescriptionKey: "临时文件获取失败"])
            DispatchQueue.main.async {
                completionHandler?(downloadError)
            }
            return
        }
        
        // 重命名临时文件为目标文件名
        let targetTempURL = tempURL.deletingPathExtension().appendingPathExtension(fileExtension)
        do {
            try FileManager.default.moveItem(at: tempURL, to: targetTempURL)
            
            DispatchQueue.main.async {
                // 弹出文件保存选择器
                let savePicker = UISaveToDocumentsPickerViewController(forExporting: [targetTempURL], asCopy: true)
                savePicker.delegate = self
                // 替换为你的视图控制器实例
                self.present(savePicker, animated: true)
                
                completionHandler?(nil)
            }
        } catch {
            DispatchQueue.main.async {
                completionHandler?(error)
            }
        }
    }
    
    let progressObserver = downloadTask.progress.observe(\.fractionCompleted, options: [.new]) { progress, _ in
        DispatchQueue.main.async {
            progressHandler?(Float(progress.fractionCompleted))
        }
    }
    
    downloadTask.resume()
}

// 实现文件选择器代理方法
extension YourViewController: UISaveToDocumentsPickerViewControllerDelegate {
    func documentPicker(_ controller: UIDocumentPickerViewController, didPickDocumentsAt urls: [URL]) {
        print("文件已保存至: \(urls.first?.path ?? "")")
    }
    
    func documentPickerWasCancelled(_ controller: UIDocumentPickerViewController) {
        print("用户取消保存")
    }
}

方案二：开启应用文件共享，让Documents目录可见 #

若需继续保存到应用私有Documents目录并让其在Files中显示，需修改Info.plist添加两个配置项：

• 添加UIFileSharingEnabled（对应描述：Application supports iTunes file sharing），值设为YES
• 添加LSSupportsOpeningDocumentsInPlace（对应描述：Supports opening documents in place），值设为YES

配置完成后，你的应用专属目录会重新出现在Files应用的「我的iPhone」列表中，用户可直接查看、管理该目录下的文件。

注意事项 #

• 方案一更贴合iOS 17的设计理念，让用户掌握文件存储控制权；方案二更适合需要用户直接访问应用私有文件的场景。
• 无论哪种方案，你的原始代码都已成功保存文件，只是iOS 17默认隐藏了未配置共享的应用私有目录。

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