如何在ContainerView中使用UIDocumentPickerViewController并触发代理方法？

问题根源 #

UIDocumentPickerViewController是苹果设计的模态专用视图控制器，它的选择完成回调（didPickDocumentsAt）依赖模态呈现的完整生命周期（present/dismiss）。直接将它作为子控制器嵌入容器视图时，会破坏其内部的导航逻辑与回调触发机制——选择文件后的完成动作需要通过模态 dismiss 流程来触发代理通知，而嵌入容器时这个流程不会执行，因此该回调无法触发。

可行解决方法 #

要同时实现「文件选择时可操作其他控件」和「正常触发选择回调」的需求，推荐以下两种方案：

方案1：非全屏模态呈现（推荐）

通过调整模态样式，让选择器以半屏/弹窗形式弹出，既保留原生回调逻辑，又允许用户操作背景控件：

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    
    let pickerViewController = UIDocumentPickerViewController(forOpeningContentTypes: [.item], asCopy: true)
    pickerViewController.delegate = self
    // 设置非全屏模态样式
    pickerViewController.modalPresentationStyle = .pageSheet
    // 允许背景控件交互，点击背景不会自动关闭选择器
    pickerViewController.isModalInPresentation = false
    // 适配iPhone端的半屏高度（可选）
    if let sheet = pickerViewController.sheetPresentationController {
        sheet.detents = [.medium(), .large()]
    }
    present(pickerViewController, animated: true)
}

方案2：自定义文件选择界面（完全可控）

如果必须将选择器嵌入容器视图，只能放弃UIDocumentPicker，基于FileManager自定义文件选择界面：

• 用UITableView/UICollectionView展示文件列表
• 手动处理文件类型过滤、权限申请、文件选择逻辑
• 自行实现选择完成的回调通知
  这种方式需要处理更多细节，但完全可控，能完美适配容器嵌入场景。

补充说明 #

为什么取消回调能正常触发？
documentPickerWasCancelled是选择器内部取消按钮直接调用的代理方法，不依赖模态生命周期，因此即使嵌入容器也能正常执行。

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