在Xamarin Forms中通过依赖服务使用UIDocumentPickerViewController的问题

我来给你梳理一套完整的实现方案，同时覆盖你可能遇到的坑——毕竟之前踩过不少Xamarin.Forms iOS文件操作的坑😉

一、先在共享项目定义依赖服务接口 #

首先得统一跨平台的调用契约，在共享项目里写一个简单的接口：

public interface IFilePickerService
{
    // 选择文档并保存到应用Documents目录，返回存储后的本地路径
    Task<string> PickAndSaveDocumentAsync();
}

二、iOS平台的具体实现 #

这部分是核心，要处理UIDocumentPickerViewController的初始化、文件选择回调，以及关键的文件复制逻辑：

[assembly: Dependency(typeof(IOSFilePickerService))]
namespace YourAppName.iOS.Services
{
    public class IOSFilePickerService : IFilePickerService
    {
        private TaskCompletionSource<string> _tcs;

        public async Task<string> PickAndSaveDocumentAsync()
        {
            _tcs = new TaskCompletionSource<string>();

            // 初始化文档选择器，允许选择所有类型文件
            var documentPicker = new UIDocumentPickerViewController(
                UTType.CreateAllTypes(), 
                UIDocumentPickerMode.Import);
            documentPicker.Delegate = new DocumentPickerDelegate(this);
            documentPicker.AllowsMultipleSelection = false; // 先实现单文件选择，多文件可以后续扩展

            // 这里要注意：必须获取当前最顶层的ViewController，否则选择器弹不出来
            var window = UIApplication.SharedApplication.KeyWindow;
            var viewController = window.RootViewController;
            while (viewController.PresentedViewController != null)
            {
                viewController = viewController.PresentedViewController;
            }

            viewController.PresentViewController(documentPicker, true, null);

            return await _tcs.Task;
        }

        // 内部委托类处理选择结果
        private class DocumentPickerDelegate : UIDocumentPickerDelegate
        {
            private readonly IOSFilePickerService _service;

            public DocumentPickerDelegate(IOSFilePickerService service)
            {
                _service = service;
            }

            public override void DidPickDocuments(UIDocumentPickerViewController controller, NSUrl[] urls)
            {
                if (urls == null || urls.Length == 0)
                {
                    _service._tcs.SetResult(null);
                    return;
                }

                var selectedUrl = urls[0];
                // 敲黑板！iOS 11+必须调用这个方法才能临时访问沙盒外的文件
                selectedUrl.StartAccessingSecurityScopedResource();

                try
                {
                    // 获取应用的Documents目录路径
                    var documentsPath = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
                    var fileName = Path.GetFileName(selectedUrl.Path);
                    var destinationPath = Path.Combine(documentsPath, fileName);

                    // 复制文件到Documents目录，允许覆盖同名文件
                    File.Copy(selectedUrl.Path, destinationPath, overwrite: true);

                    // 用完一定要释放权限！
                    selectedUrl.StopAccessingSecurityScopedResource();

                    // 返回存储后的本地路径给上层调用
                    _service._tcs.SetResult(destinationPath);
                }
                catch (Exception ex)
                {
                    selectedUrl.StopAccessingSecurityScopedResource();
                    _service._tcs.SetException(ex);
                }
                finally
                {
                    controller.DismissViewController(true, null);
                }
            }

            public override void WasCancelled(UIDocumentPickerViewController controller)
            {
                _service._tcs.SetResult(null);
                controller.DismissViewController(true, null);
            }
        }
    }
}

必须配置的Info.plist权限 #

没有这两个配置，要么崩溃要么被App Store拒，一定要加上：

<key>NSFileProviderDomainUsageDescription</key>
<string>需要访问文件应用以选择和存储文档</string>
<key>UIFileSharingEnabled</key>
<true/> <!-- 可选：如果需要让用户通过iTunes或文件应用查看你存储的文件，就加这个 -->

三、SQLite存储文档路径 #

假设你已经有SQLite的基础配置（比如用sqlite-net-pcl），先定义一个存储模型：

public class StoredDocument
{
    [PrimaryKey, AutoIncrement]
    public int Id { get; set; }
    public string LocalPath { get; set; }
    public string FileName { get; set; }
    public DateTime AddedDate { get; set; }
}

然后在Entry的点击事件里完成调用和存储：

// 先确保你已经初始化了SQLite连接
private SQLiteAsyncConnection _sqliteConnection;

private async void Entry_Clicked(object sender, EventArgs e)
{
    var filePickerService = DependencyService.Get<IFilePickerService>();
    try
    {
        var localPath = await filePickerService.PickAndSaveDocumentAsync();
        if (!string.IsNullOrEmpty(localPath))
        {
            // 构造存储对象
            var document = new StoredDocument
            {
                LocalPath = localPath,
                FileName = Path.GetFileName(localPath),
                AddedDate = DateTime.Now
            };
            // 插入到SQLite
            await _sqliteConnection.InsertAsync(document);

            // 刷新UI展示列表
            await LoadStoredDocuments();
        }
    }
    catch (Exception ex)
    {
        await DisplayAlert("操作失败", $"处理文档时出错：{ex.Message}", "确定");
    }
}

// 示例：加载已存储的文档列表
private async Task LoadStoredDocuments()
{
    var documents = await _sqliteConnection.Table<StoredDocument>().ToListAsync();
    // 绑定到你的ListView或其他控件
    YourDocumentListView.ItemsSource = documents;
}

四、常见问题排查 #

我猜你遇到的问题大概率是下面这些中的一个，提前给你排雷：

• 选择器弹不出来：检查是否正确获取了最顶层的ViewController，模态窗口嵌套时一定要循环拿到PresentedViewController；
• 文件复制失败：有没有调用StartAccessingSecurityScopedResource()？iOS 11+必须用这个临时授权才能访问沙盒外的文件；
• 路径无效：确保存储的是Documents目录的完整路径，而不是临时路径；
• 权限被拒：Info.plist里的权限描述一定要写，否则用户拒绝后再也无法打开文件应用；
• SQLite存储异常：检查模型的主键和字段定义，确保连接初始化正确。

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