使用PDFKit时，如何为iOS Files App保存的PDF指定默认文件名？

这个问题我之前也碰到过！直接传Data对象给UIActivityViewController时，系统没有足够的信息来确定你想要的默认文件名，所以才会用通用的“PDF Document.pdf”。这里有两种实用的解决办法，你可以根据自己的场景选择：

方法一：将PDF数据写入临时文件，分享文件URL #

这是最直接的方案——把你的PDF数据写入一个带自定义文件名的临时文件，然后分享这个文件的URL，系统会自动读取URL里的文件名作为默认名。

@objc func shareAction(_ sender: UIBarButtonItem) {
    guard let documentData = documentData else { return }
    
    // 定义你的自定义文件名
    let customFileName = "我的专属文档.pdf"
    // 获取临时目录路径
    let tempDirectory = NSTemporaryDirectory()
    // 拼接临时文件的完整路径
    let tempFilePath = tempDirectory.appending(customFileName)
    let tempFileURL = URL(fileURLWithPath: tempFilePath)
    
    do {
        // 将PDF数据写入临时文件
        try documentData.write(to: tempFileURL)
        
        // 用文件URL初始化分享控制器
        let shareVC = UIActivityViewController(activityItems: [tempFileURL], applicationActivities: nil)
        present(shareVC, animated: true)
        
        // 分享完成后记得清理临时文件，避免占用设备空间
        shareVC.completionWithItemsHandler = { _, _, _, _ in
            do {
                try FileManager.default.removeItem(at: tempFileURL)
            } catch {
                print("清理临时文件失败: \(error.localizedDescription)")
            }
        }
    } catch {
        print("写入临时文件出错: \(error.localizedDescription)")
    }
}

优点： #

• 代码简单直观，容易理解和实现
• 几乎适配所有分享活动，系统会自动处理文件名

方法二：自定义UIActivityItemProvider（更灵活） #

如果你的场景需要针对不同的分享活动做不同处理（比如给邮件设置主题，给保存到文件设置文件名），可以自定义UIActivityItemProvider，它能让你更精细地控制分享内容。

首先创建自定义的Provider类：

class CustomPDFItemProvider: UIActivityItemProvider {
    private let pdfData: Data
    private let targetFileName: String
    
    init(pdfData: Data, fileName: String) {
        self.pdfData = pdfData
        self.targetFileName = fileName
        // 初始化时传入占位对象，这里用文件名即可
        super.init(placeholderItem: fileName)
    }
    
    // 当分享活动需要数据时，返回PDF的Data
    override func item() -> Any {
        return pdfData
    }
    
    // 指定PDF的UTI类型，确保系统正确识别文件格式
    override func activityViewController(_ activityViewController: UIActivityViewController, dataTypeIdentifierForActivityType activityType: UIActivity.ActivityType?) -> String {
        return "com.adobe.pdf"
    }
    
    // 给需要主题的活动（比如邮件）设置主题内容
    override func activityViewController(_ activityViewController: UIActivityViewController, subjectForActivityType activityType: UIActivity.ActivityType?) -> String {
        return targetFileName
    }
    
    // 针对「保存到文件」活动，返回带自定义文件名的临时URL
    override func activityViewController(_ activityViewController: UIActivityViewController, itemForActivityType activityType: UIActivity.ActivityType?) -> Any? {
        guard activityType == .saveToFiles else {
            // 其他活动直接返回Data
            return pdfData
        }
        
        let tempDir = NSTemporaryDirectory()
        let tempFilePath = tempDir.appending(targetFileName)
        let tempFileURL = URL(fileURLWithPath: tempFilePath)
        
        do {
            try pdfData.write(to: tempFileURL)
            return tempFileURL
        } catch {
            // 写入失败时 fallback 到Data
            return pdfData
        }
    }
}

然后在分享方法里使用这个Provider：

@objc func shareAction(_ sender: UIBarButtonItem) {
    guard let documentData = documentData else { return }
    
    let customFileName = "我的专属文档.pdf"
    let pdfItemProvider = CustomPDFItemProvider(pdfData: documentData, fileName: customFileName)
    
    let shareVC = UIActivityViewController(activityItems: [pdfItemProvider], applicationActivities: nil)
    present(shareVC, animated: true)
    
    // 分享完成后清理临时文件
    shareVC.completionWithItemsHandler = { _, _, _, _ in
        let tempDir = NSTemporaryDirectory()
        let tempFilePath = tempDir.appending(customFileName)
        try? FileManager.default.removeItem(at: URL(fileURLWithPath: tempFilePath))
    }
}

优点： #

• 可以针对不同的分享活动定制行为
• 扩展性强，后续如果需要添加其他分享逻辑很方便

两种方法都能解决你的问题，如果你只是需要简单修改默认文件名，方法一足够用了；如果有更复杂的分享需求，方法二更合适。

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