.NET MAUI在macOS/iOS上使用Launcher打开文件失败求助

问题回顾 #

原Xamarin应用通过DependencyService调用PresentViewController打开QLPreviewController，可正常预览PDF和Office文件；切换到MAUI后使用Launcher.Default.OpenAsync，在Windows正常，但在macOS弹出无响应窗口，iPad上无对应应用时直接失败，无法像Xamarin那样调用系统预览。

解决方案 #

方案1：修复Launcher在Apple平台的异常 #

• 检查文件路径与沙盒权限
  Apple平台应用受沙盒限制，若文件在沙盒外（如系统下载目录），需先将文件复制到应用沙盒内的可访问目录（如FileSystem.CacheDirectory或FileSystem.AppDataDirectory），再调用Launcher。示例：

  var targetPath = Path.Combine(FileSystem.CacheDirectory, Path.GetFileName(filePath));
  File.Copy(filePath, targetPath, overwrite: true);
  await Launcher.Default.OpenAsync(new OpenFileRequest("预览文件", new ReadOnlyFile(targetPath)));
  

• 显式指定MIME类型
  自动MIME检测可能存在偏差，手动指定对应类型可提升兼容性：

  string mimeType = Path.GetExtension(filePath).ToLower() switch
  {
      ".docx" => "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
      ".pdf" => "application/pdf",
      ".xlsx" => "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
      ".pptx" => "application/vnd.openxmlformats-officedocument.presentationml.presentation",
      _ => ""
  };
  
  var request = new OpenFileRequest("预览文件", new ReadOnlyFile(filePath))
  {
      ContentType = mimeType
  };
  await Launcher.Default.OpenAsync(request);
  

方案2：复用Xamarin时期的系统预览控制器（推荐） #

直接通过MAUI平台特定代码调用Apple原生的QLPreviewController，和Xamarin逻辑一致，支持无对应应用时的系统预览：

1. 共享项目定义接口

public interface IFilePreviewService
{
    Task PreviewFileAsync(string filePath, string title);
}

2. iOS/macOS项目实现服务

using UIKit;
using QuickLook;
using Foundation;
using System.Threading.Tasks;

public class FilePreviewService : IFilePreviewService
{
    public Task PreviewFileAsync(string filePath, string title)
    {
        var tcs = new TaskCompletionSource<bool>();
        var previewController = new QLPreviewController();
        previewController.DataSource = new PreviewDataSource(filePath, title);

        // 获取当前顶层视图控制器
        var rootVC = UIApplication.SharedApplication.KeyWindow.RootViewController;
        while (rootVC.PresentedViewController != null)
        {
            rootVC = rootVC.PresentedViewController;
        }

        rootVC.PresentViewController(previewController, animated: true, completion: () => tcs.SetResult(true));
        return tcs.Task;
    }
}

public class PreviewDataSource : QLPreviewControllerDataSource
{
    private readonly string _filePath;
    private readonly string _title;

    public PreviewDataSource(string filePath, string title)
    {
        _filePath = filePath;
        _title = title;
    }

    public override nint PreviewItemCount(QLPreviewController controller) => 1;

    public override IQLPreviewItem GetPreviewItem(QLPreviewController controller, nint index)
    {
        var fileUrl = NSUrl.FromFilename(_filePath);
        return new PreviewItem(fileUrl, _title);
    }
}

public class PreviewItem : NSObject, IQLPreviewItem
{
    public NSUrl PreviewItemUrl { get; }
    public string PreviewItemTitle { get; }

    public PreviewItem(NSUrl url, string title)
    {
        PreviewItemUrl = url;
        PreviewItemTitle = title;
    }
}

3. 注册服务与调用
   在Program.cs中注册：

builder.Services.AddSingleton<IFilePreviewService, FilePreviewService>();

在共享项目中调用：

var previewService = App.Current.Services.GetRequiredService<IFilePreviewService>();
await previewService.PreviewFileAsync(filePath, "文件预览");

方案3：macOS沙盒权限配置 #

若需访问应用沙盒外的文件，需在macOS项目的Entitlements.plist中添加权限：

<key>com.apple.security.files.user-selected.read-only</key>
<true/>

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