Xamarin Forms Windows 8.1(WinRT)应用内置PDF渲染方案咨询

我之前在WinRT项目里折腾过PDF渲染，踩过不少坑，给你几个亲测可行的方案，应该能解决你的问题：

方案一：基于WinRT原生API的自定义渲染器 #

WinRT本身提供了PdfDocument和PdfPage类来处理PDF，通过Xamarin Forms的自定义渲染器封装这个能力，比依赖WebView的pdf.js更稳定，也不需要额外的前端资源。

步骤： #

1. 在共享项目创建自定义视图
   先做一个承载PDF逻辑的自定义控件：

   public class CustomPdfView : View
   {
       public static readonly BindableProperty PdfPathProperty =
           BindableProperty.Create(nameof(PdfPath), typeof(string), typeof(CustomPdfView));
   
       public string PdfPath
       {
           get => (string)GetValue(PdfPathProperty);
           set => SetValue(PdfPathProperty, value);
       }
   }
   

2. 在WinRT项目实现自定义渲染器
   写原生渲染逻辑，把PDF页面渲染到Image控件上：

   [assembly: ExportRenderer(typeof(CustomPdfView), typeof(CustomPdfViewRenderer))]
   namespace YourAppNamespace.WinRT
   {
       public class CustomPdfViewRenderer : ViewRenderer<CustomPdfView, Windows.UI.Xaml.Controls.Image>
       {
           protected override void OnElementChanged(ElementChangedEventArgs<CustomPdfView> e)
           {
               base.OnElementChanged(e);
   
               if (Control == null)
               {
                   SetNativeControl(new Windows.UI.Xaml.Controls.Image());
               }
   
               if (e.NewElement != null)
               {
                   _ = LoadAndRenderPdf(e.NewElement.PdfPath);
               }
           }
   
           private async Task LoadAndRenderPdf(string pdfPath)
           {
               try
               {
                   // 加载项目Assets目录下的PDF文件（需设置Build Action为Content）
                   var pdfFile = await Windows.ApplicationModel.Package.Current.InstalledLocation.GetFileAsync(pdfPath);
                   using (var fileStream = await pdfFile.OpenAsync(Windows.Storage.FileAccessMode.Read))
                   {
                       var pdfDoc = await Windows.Data.Pdf.PdfDocument.LoadFromStreamAsync(fileStream);
                       var targetPage = pdfDoc.GetPage(0); // 渲染第一页，分页功能可自行扩展
   
                       // 将PDF页面渲染到Bitmap
                       var renderBitmap = new Windows.UI.Xaml.Media.Imaging.RenderTargetBitmap();
                       await renderBitmap.RenderAsync(targetPage);
   
                       Control.Source = renderBitmap;
                   }
               }
               catch (Exception ex)
               {
                   Debug.WriteLine($"PDF加载失败：{ex.Message}");
               }
           }
       }
   }
   

3. 在XAML中使用自定义视图

   <local:CustomPdfView PdfPath="Assets/your_sample.pdf" />
   

注意事项： #

• 如果需要分页、缩放功能，可以给自定义视图添加页码、缩放比例等绑定属性，在渲染器中对应调整。
• 大体积PDF建议做异步加载和内存释放，避免UI阻塞。

方案二：使用Syncfusion PDF Viewer控件 #

Syncfusion的Xamarin Forms PDF Viewer对WinRT支持很完善，开箱即用自带分页、缩放、搜索等功能，适合快速开发。

步骤： #

1. 安装NuGet包
   在共享项目和WinRT项目中安装Syncfusion.Xamarin.SfPdfViewer（注意选择支持WinRT的版本）。

2. 在XAML中添加控件

   <pdfviewer:SfPdfViewer x:Name="pdfViewer" HorizontalOptions="FillAndExpand" VerticalOptions="FillAndExpand" />
   

3. 加载PDF文件
   在后台代码中加载本地或远程PDF：

   // 加载本地Assets目录的PDF
   var pdfFile = await Windows.ApplicationModel.Package.Current.InstalledLocation.GetFileAsync("Assets/your_sample.pdf");
   using (var stream = await pdfFile.OpenStreamForReadAsync())
   {
       pdfViewer.LoadDocument(stream);
   }
   

注意事项： #

• Syncfusion有免费社区版（适合个人/小团队项目），商业项目需要购买授权。
• 控件自带的交互功能可以省掉大量自定义开发工作。

方案三：修复pdf.js的WinRT加载问题（如果想继续用它） #

你之前用pdf.js失败大概率是WinRT WebView的本地资源访问规则导致的，试试以下调整：

1. 把pdf.js资源嵌入项目
   将pdf.js的web文件夹（包含viewer.html、viewer.js等）复制到WinRT项目的Assets目录，设置所有文件的Build Action为Content。

2. 用ms-appx-web协议加载
   WinRT WebView需要用特殊协议访问本地资源，设置WebView的Source：

   var viewerUrl = "ms-appx-web:///Assets/pdfjs/web/viewer.html?file=ms-appx-web:///Assets/your_sample.pdf";
   webView.Source = new UrlWebViewSource { Url = viewerUrl };
   

   这个协议能让WebView正确读取项目内的本地文件，解决之前的加载失败问题。

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