如何在.NET MAUI中读取并打开本地PDF文件

以下是经过生产环境验证的可落地方案，按改造成本从低到高排序：

• 方案1：调用系统默认PDF查看器打开
  这是改造成本最低的过渡方案，适合不需要在App内部嵌入PDF浏览页面、仅需支持用户查看本地PDF的场景。直接使用MAUI内置的启动器API即可实现，不需要引入任何第三方依赖：
  1. 先确认本地PDF文件存放在应用有权限访问的路径下，Android平台需提前配置FileProvider相关权限，避免跨应用文件访问报错；iOS端需将待打开的PDF放到应用沙盒的共享目录下。
  2. 核心调用代码如下：

  string localPdfPath = Path.Combine(FileSystem.Current.AppDataDirectory, "your_file.pdf");
  await Launcher.Default.OpenAsync(new OpenFileRequest
  {
      File = new ReadOnlyFile(localPdfPath)
  });
  

  后续如果Syncfusion推出正式适配MAUI的PdfViewer控件，只需要把上述启动逻辑替换为控件加载逻辑即可，业务层代码几乎不需要调整。
• 方案2：替换为已稳定适配MAUI的PDF查看控件
  如果需要在App内嵌入PDF浏览能力、支持自定义交互（页码跳转、缩放、批注、表单填写等），可以直接替换为已经完成MAUI适配的PDF控件：
  • 开源类控件：基于Android Pdfium、iOS PdfKit封装的开源MAUI PdfViewer控件，无商业授权成本，覆盖基础浏览、缩放、翻页等通用需求，安装对应的Nuget包后，直接传入本地文件流即可加载：

    // 页面XAML中挂载控件后，后台直接加载本地文件
    pdfViewer.LoadDocument(File.OpenRead(localPdfPath));
    

  • 商业类控件：如果原有项目依赖PDF批注、表单编辑、数字签名等高级能力，可以选择其他已经完成MAUI适配的商业PDF控件，迁移时仅需要做API层面的适配，核心业务逻辑不需要重构。
• 方案3：通过BlazorWebView内嵌PDF.js实现自托管渲染
  适合对跨平台渲染一致性要求高、不想引入原生控件依赖的场景。实现逻辑很简单：在MAUI页面中嵌入BlazorWebView控件，挂载本地存储的PDF.js静态资源，将本地PDF文件转为流或base64格式传递给PDF.js完成渲染。这个方案在Android、iOS、Windows、macOS端的渲染效果完全一致，还可以按需自定义PDF.js的工具栏、交互逻辑，无授权成本。需要注意加载100M以上的大体积PDF时，要做好WebView的内存回收，避免出现OOM闪退。
• 方案4：自定义跨平台控件桥接原生渲染能力
  如果对包体积、渲染性能、原生交互体验要求极高，可以自行实现MAUI自定义Handler：Android端对接原生PdfRenderer或Pdfium库做页面渲染，iOS/macOS端直接调用系统内置的PdfKit框架，Windows端对接系统自带的PDF渲染API，将各平台的渲染逻辑封装为统一的MAUI控件，对外暴露加载本地文件、翻页、缩放等统一接口。这个方案灵活性最高，包体积增量最小，缺点是初期需要自行处理各平台的权限适配、手势交互、内存回收逻辑，开发成本稍高。

选型建议：如果只是做临时版本过渡，等待Syncfusion官方的MAUI适配版本发布，优先选择方案1，改造成本极低，后续切换回Syncfusion控件的成本也极低；如果已经确认短期内不会推出适配版本，再根据自身的功能需求从剩下三个方案里选择即可。

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