如何在Swift中将文件保存至自定义扩展名的文档包

嘿，作为Swift新手想要实现Logic或Final Cut那样的文档包功能确实有点摸不着头绪，我来一步步帮你搞定这个需求——本质上就是让系统把一个文件夹伪装成单个带自定义扩展名的文件，同时支持后续打开修改内部内容。

一、先搞懂文档包的本质 #

macOS的“文档包”其实就是被系统标记为“单个文件”的文件夹。要让你的自定义扩展名（比如.cust）被识别为文档包，第一步得在应用的Info.plist里做关键配置，告诉系统“这个扩展名对应的是个包”。

二、配置Info.plist，让系统认你的自定义包 #

打开Xcode里的Info.plist（或者通过项目设置的Info标签页可视化配置），添加以下内容：

1. 声明自定义UTI（统一类型标识符） #

每个文档类型都需要一个唯一的UTI，比如我们定义com.yourcompany.cust-bundle：

<key>UTExportedTypeDeclarations</key>
<array>
    <dict>
        <key>UTTypeIdentifier</key>
        <string>com.yourcompany.cust-bundle</string>
        <key>UTTypeDescription</key>
        <string>Custom Document Bundle</string>
        <key>UTTypeConformsTo</key>
        <array>
            <string>public.folder</string> <!-- 本质是文件夹，所以继承这个类型 -->
            <string>public.data</string>
        </array>
        <key>UTTypeTagSpecification</key>
        <dict>
            <key>public.filename-extension</key>
            <array>
                <string>cust</string> <!-- 绑定你的自定义扩展名 -->
            </array>
        </dict>
    </dict>
</array>

2. 配置应用支持的文档类型 #

接着添加CFBundleDocumentTypes，让你的应用能处理这个自定义包：

<key>CFBundleDocumentTypes</key>
<array>
    <dict>
        <key>CFBundleTypeName</key>
        <string>Custom Document Bundle</string>
        <key>CFBundleTypeRole</key>
        <string>Editor</string> <!-- 你的应用是这个类型文档的编辑器 -->
        <key>LSHandlerRank</key>
        <string>Owner</string>
        <key>LSItemContentTypes</key>
        <array>
            <string>com.yourcompany.cust-bundle</string> <!-- 关联刚才的UTI -->
        </array>
        <key>LSTypeIsPackage</key>
        <true/> <!-- 核心！告诉系统这是一个包，不是普通文件夹 -->
    </dict>
</array>

三、Swift代码实现：创建自定义文档包 #

用FileManager就能完成创建逻辑——本质是创建一个带.cust扩展名的目录，然后把需要的文件复制进去：

示例创建函数 #

import Foundation

func createCustomBundle(at outputURL: URL, withSourceFiles sourceFiles: [URL]) throws {
    let fileManager = FileManager.default
    
    // 1. 创建带.cust扩展名的目录（这就是我们的文档包）
    try fileManager.createDirectory(at: outputURL, withIntermediateDirectories: true)
    
    // 2. 逐个复制源文件到包内
    for sourceFile in sourceFiles {
        let destURL = outputURL.appendingPathComponent(sourceFile.lastPathComponent)
        // 如果目标已存在，先删除避免冲突
        if fileManager.fileExists(atPath: destURL.path) {
            try fileManager.removeItem(at: destURL)
        }
        try fileManager.copyItem(at: sourceFile, to: destURL)
    }
    
    // 可选：确保系统正确识别为包（Info.plist配置正确的话，这步其实可以省略）
    try fileManager.setAttributes([.extensionHidden: true], ofItemAtPath: outputURL.path)
}

// 调用示例
do {
    // 替换成你实际的源文件路径
    let movFile = URL(fileURLWithPath: "/Users/You/Desktop/quicktime.mov")
    let txtFile = URL(fileURLWithPath: "/Users/You/Desktop/text.txt")
    let plistFile = URL(fileURLWithPath: "/Users/You/Desktop/info.plist")
    
    // 输出的文档包路径
    let bundleURL = URL(fileURLWithPath: "/Users/You/Documents/mybundle.cust")
    
    try createCustomBundle(at: bundleURL, withSourceFiles: [movFile, txtFile, plistFile])
    print("文档包创建成功！Finder里看它是单个文件，右键选「显示包内容」就能看到内部文件")
} catch {
    print("创建失败：\(error.localizedDescription)")
}

四、Swift代码实现：打开并修改文档包 #

要修改包内的内容，直接把它当作普通目录处理就行——读取内部文件、修改后保存：

示例修改函数 #

func modifyCustomBundle(at bundleURL: URL) throws {
    let fileManager = FileManager.default
    
    // 先验证是不是有效的目录（文档包）
    guard fileManager.isDirectory(atPath: bundleURL.path) else {
        throw NSError(domain: "CustomBundleError", code: 1, userInfo: [NSLocalizedDescriptionKey: "这不是一个有效的自定义文档包"])
    }
    
    // 示例：修改text.txt内容
    let txtURL = bundleURL.appendingPathComponent("text.txt")
    var content = try String(contentsOf: txtURL, encoding: .utf8)
    content += "\n最后修改时间：\(Date())"
    try content.write(to: txtURL, atomically: true, encoding: .utf8)
    
    // 示例：修改info.plist
    let plistURL = bundleURL.appendingPathComponent("info.plist")
    if var plistDict = try? [String: Any](contentsOf: plistURL) {
        plistDict["lastModified"] = Date().description
        try plistDict.write(to: plistURL)
    }
    
    print("文档包修改完成！")
}

// 调用示例
do {
    let bundleURL = URL(fileURLWithPath: "/Users/You/Documents/mybundle.cust")
    try modifyCustomBundle(at: bundleURL)
} catch {
    print("修改失败：\(error.localizedDescription)")
}

五、进阶提示：文档型应用适配 #

如果你的应用是基于NSDocument的文档型应用（比如Xcode新建的“Document App”模板），可以直接在NSDocument子类里处理文档包：

• 重写read(from:ofType:)方法，从包目录里读取文件内容
• 重写write(to:ofType:)方法，把内容写入包内的对应文件
  这样系统自带的打开、保存、版本管理、自动恢复等功能都会自动支持，和Logic/Final Cut的体验完全一致。

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