iOS 16.1下UIDocumentPickerViewController的ModalPresentationStyle无法修改咨询

问题背景 #

在Xcode14.0.1搭配iOS16.1的iPad设备上，无论是Xamarin.iOS还是原生Swift项目，设置UIDocumentPickerViewController的ModalPresentationStyle为Popover后，属性值会被强制重置为FormSheet，导致文档选择器无法以Popover样式展示。该问题仅出现在iOS16.1真机，iOS16.0模拟器及Xcode13环境下正常。

解决办法 #

1. 显式配置PopoverPresentationController的源视图和位置 #

iOS16.1中，即使设置了ModalPresentationStyle为Popover，系统仍需要显式指定弹出的触发源才能生效，否则会 fallback 到FormSheet样式。

Xamarin.iOS示例代码：

// 创建文档选择器
var picker = new UIDocumentPickerViewController(
    new string[] { UTType.PlainText }, 
    UIDocumentPickerMode.Import
);

// 设置模态样式为Popover
picker.ModalPresentationStyle = UIModalPresentationStyle.Popover;

// 必须配置Popover的触发源
if (picker.PopoverPresentationController != null)
{
    // 替换为你实际的触发控件（比如按钮）
    picker.PopoverPresentationController.SourceView = yourTriggerButton;
    picker.PopoverPresentationController.SourceRect = yourTriggerButton.Bounds;
    // 可选：设置弹出箭头方向
    picker.PopoverPresentationController.PermittedArrowDirections = UIPopoverArrowDirection.Any;
}

// 呈现控制器
PresentViewController(picker, true, null);

Swift示例代码：

let picker = UIDocumentPickerViewController(forOpeningContentTypes: [.plainText])
picker.modalPresentationStyle = .popover

if let popoverController = picker.popoverPresentationController {
    popoverController.sourceView = yourTriggerButton
    popoverController.sourceRect = yourTriggerButton.bounds
}

present(picker, animated: true)

2. 确认场景(Scene)上下文的正确性 #

如果你的应用使用了iOS13+的SceneDelegate模式，确保在正确的场景窗口中呈现文档选择器，避免因为上下文错误导致样式失效。可以通过当前场景的Window或RootViewController来获取正确的控制器上下文。

3. 版本分支适配 #

针对iOS16.1及以上版本启用专属适配逻辑，旧版本保持原有代码：

if (UIDevice.CurrentDevice.CheckSystemVersion(16, 1))
{
    // iOS16.1+强制配置触发源
    if (picker.PopoverPresentationController != null)
    {
        picker.PopoverPresentationController.SourceView = yourTriggerButton;
        picker.PopoverPresentationController.SourceRect = yourTriggerButton.Bounds;
    }
}
else
{
    // 旧版本直接设置样式
    picker.ModalPresentationStyle = UIModalPresentationStyle.Popover;
}

说明 #

该问题属于iOS16.1的未公开行为变更，苹果暂未在官方文档中提及。目前显式配置PopoverPresentationController的源视图是最可靠的解决方式，后续苹果可能会在iOS更新中修复属性重置的问题。

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