无需新建项目，如何将Swift iOS应用转至UIDocumentBrowserViewController架构？

当然不用新建项目或者Target就能搞定！我之前帮朋友完成过类似的迁移，完全可以在现有代码基础上逐步调整，不用推倒重来。下面是具体的操作步骤和关键注意点：

1. 先配置Info.plist的必要项 #

UIDocumentBrowser需要系统识别你的应用支持的文档类型，以及开启文档浏览器的支持：

• 打开Xcode中Target的「Info」标签页，找到「Custom iOS Target Properties」，添加UISupportsDocumentBrowser并设置为YES；
• 在「Document Types」里添加你应用支持的文档格式（比如自定义的.myapp格式，或者通用的.txt等），填写对应的UTI类型、文件扩展名等；
• 如果需要支持iCloud文档，还要确保在「Signing & Capabilities」里添加iCloud能力，并勾选「iCloud Documents」。

2. 替换根ViewController #

原来的根是UINavigationController，现在要把它换成UIDocumentBrowserViewController：

• 如果你用的是SceneDelegate，找到scene(_:willConnectTo:options:)方法，替换原来的根VC初始化代码：

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
    guard let windowScene = (scene as? UIWindowScene) else { return }
    let window = UIWindow(windowScene: windowScene)
    self.window = window
    
    // 初始化文档浏览器
    let documentBrowser = UIDocumentBrowserViewController(forOpeningFilesWithContentTypes: ["com.yourcompany.yourapp"])
    documentBrowser.delegate = self
    window.rootViewController = documentBrowser
    window.makeKeyAndVisible()
}

• 如果还在用AppDelegate，就在application(_:didFinishLaunchingWithOptions:)里做类似的替换。

3. 实现UIDocumentBrowserDelegate核心方法 #

这部分是衔接原有业务的关键，你需要处理用户选择/新建文档的逻辑：

• 处理文档选择：实现documentBrowser(_:didPickDocumentsAt:)方法，拿到用户选择的文档URL后，就可以用你原来的逻辑打开文档（比如初始化你的文档编辑VC，放到UINavigationController里再push/present）：

func documentBrowser(_ controller: UIDocumentBrowserViewController, didPickDocumentsAt documentURLs: [URL]) {
    guard let selectedURL = documentURLs.first else { return }
    // 注意安全范围URL的处理
    guard selectedURL.startAccessingSecurityScopedResource() else {
        // 处理权限失败的情况
        return
    }
    defer { selectedURL.stopAccessingSecurityScopedResource() }
    
    // 用你原来的方式打开文档，比如：
    let editorVC = DocumentEditorViewController(documentURL: selectedURL)
    let navVC = UINavigationController(rootViewController: editorVC)
    controller.present(navVC, animated: true)
}

• 处理新建文档：实现documentBrowser(_:didRequestDocumentCreationWithHandler:)方法，让用户选择保存位置后，创建新文档并打开编辑页面：

func documentBrowser(_ controller: UIDocumentBrowserViewController, didRequestDocumentCreationWithHandler importHandler: @escaping (URL?, UIDocumentBrowserViewController.ImportMode) -> Void) {
    // 创建临时新文档
    let tempURL = FileManager.default.temporaryDirectory.appendingPathComponent("NewDocument.myapp")
    // 写入初始内容（比如空的文档结构）
    try? Data().write(to: tempURL)
    
    // 调用importHandler让用户选择保存位置
    importHandler(tempURL, .move)
}

4. 适配原有文档逻辑 #

• 如果原来的应用用的是自定义的文档存储，需要调整为兼容UIDocument类（或者至少确保能正确处理安全范围的URL，记得调用startAccessingSecurityScopedResource()和stopAccessingSecurityScopedResource()）；
• 原来的导航逻辑可以保留：比如打开文档后，还是用你熟悉的UINavigationController来管理后续的页面，文档浏览器只是作为入口。

5. 测试与细节调整 #

• 测试新建、打开、导入、保存文档的全流程，确保没有权限问题；
• 如果原来的应用有启动引导页，可以先显示引导页，完成后再切换到文档浏览器；
• 适配不同设备的尺寸，确保文档浏览器的布局符合iOS的设计规范。

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