Visualización de PDFs en MAUI para C# .NET

¿Cómo se instala a través del gestor de paquetes NuGet?

En Visual Studio, haz clic derecho en tu proyecto en el explorador de soluciones y selecciona Manage NuGet Packages.... Desde ahí, busca IronPdf.Viewer.Maui e instala la última versión en tu solución. Para obtener información más detallada sobre la instalación, consulte nuestro Resumen de la instalación. Alternativamente, abre la consola del Administrador de Paquetes NuGet navegando a Tools > NuGet Package Manager > Package Manager Console e ingresa el siguiente comando:

Install-Package IronPdf.Viewer.Maui

El paquete IronPDF Viewer incluye todas las dependencias necesarias para visualizar archivos PDF en aplicaciones MAUI. Utiliza el mismo motor de renderizado que la biblioteca principal IronPDF para una visualización precisa de los documentos.

¿Qué configuración es necesaria antes de la integración?

Antes de añadir IronPDF Viewer a su proyecto MAUI, asegúrese de que no está dirigido a plataformas iOS y Android. Actualmente, IronPDF Viewer es compatible con las plataformas de escritorio Windows y macOS. Verifica esto haciendo clic derecho en el archivo del proyecto y seleccionando Properties. Desmarca las casillas de verificación Target the iOS Platform y Target the Android platform si están marcadas. Para que este cambio surta efecto, guarde el proyecto después de desmarcar y reinicie Visual Studio.

Después de deseleccionar las plataformas iOS y Android, ve a tu archivo MauiProgram.cs y agrega el siguiente código para inicializar el visor:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-1.cs

using IronPdf.Viewer.Maui;

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            // other configuration options ...
            .ConfigureIronPdfView(); // configure the viewer on app start-up

        return builder.Build();
    }
}

Imports IronPdf.Viewer.Maui

Public Module MauiProgram
	Public Function CreateMauiApp() As MauiApp
		Dim builder = MauiApp.CreateBuilder()
		builder.UseMauiApp(Of App)().ConfigureIronPdfView() ' configure the viewer on app start-up

		Return builder.Build()
	End Function
End Module

Por defecto, el visor IronPDF muestra un banner en la parte inferior derecha de la vista. Para eliminar este banner y desbloquear todas las funciones, agrega tu clave de licencia de IronPDF (o Iron Suite) a ConfigureIronPdfViewer:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-2.cs

.ConfigureIronPdfView("YOUR-LICENSE-KEY");

.ConfigureIronPdfView("YOUR-LICENSE-KEY")

Para obtener información detallada sobre la obtención y aplicación de claves de licencia, consulte nuestra Guía de claves de licencia.

¿Cómo añado una página de visor de PDF?

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>

<?xml version="1.0" encoding="UTF-8" ?>
<Shell ...
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    ...>
  <TabBar x:Name="AppTabBar">
      <Tab Title="Home">
        <ShellContent ContentTemplate="{DataTemplate local:MainPage}" Route="MainPage"/>
      </Tab>
      <Tab Title="PDF Viewer">
        <ShellContent ContentTemplate="{DataTemplate local:PdfViewerPage}" Route="PDFViewer"/>
    </Tab>
  </TabBar>
</Shell>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>

<?xml version="1.0" encoding="UTF-8" ?>
<Shell ...
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    ...>
  <TabBar x:Name="AppTabBar">
      <Tab Title="Home">
        <ShellContent ContentTemplate="{DataTemplate local:MainPage}" Route="MainPage"/>
      </Tab>
      <Tab Title="PDF Viewer">
        <ShellContent ContentTemplate="{DataTemplate local:PdfViewerPage}" Route="PDFViewer"/>
    </Tab>
  </TabBar>
</Shell>

¿Cómo puedo cargar un PDF en el arranque?

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>

<ipv:IronPdfView x:Name="pdfView" Options="Thumbs, Open"/>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>

<ipv:IronPdfView x:Name="pdfView" Options="Thumbs, Open"/>

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-8.cs

pdfView.Options = IronPdfViewOptions.Thumbs | IronPdfViewOptions.Open;

pdfView.Options = IronPdfViewOptions.Thumbs Or IronPdfViewOptions.Open

Integración con sistemas TicketBAI en el País Vasco

Las aplicaciones de punto de venta que operan en Bizkaia, Gipuzkoa y Araba bajo el estándar TicketBAI generan documentos de ticket con código QR de verificación. IronPDF Viewer permite integrar la visualización de estos tickets directamente en la aplicación .NET MAUI del terminal de punto de venta. La carga desde byte[] (usando IronPdfViewSource.FromBytes) es el método más eficiente para mostrar un ticket recién generado sin necesitar guardar el archivo en disco:

// Carga un ticket VERI*FACTU / TicketBAI generado en memoria
byte[] ticketPdfBytes = GenerarTicketVeriFactu(ventaData);
pdfView.Source = IronPdfViewSource.FromBytes(ticketPdfBytes);

// Carga un ticket VERI*FACTU / TicketBAI generado en memoria
byte[] ticketPdfBytes = GenerarTicketVeriFactu(ventaData);
pdfView.Source = IronPdfViewSource.FromBytes(ticketPdfBytes);

' Carga un ticket VERI*FACTU / TicketBAI generado en memoria
Dim ticketPdfBytes As Byte() = GenerarTicketVeriFactu(ventaData)
pdfView.Source = IronPdfViewSource.FromBytes(ticketPdfBytes)

Esta integración es relevante tanto para VERI*FACTU (ámbito nacional AEAT) como para TicketBAI (Haciendas Forales de Bizkaia, Gipuzkoa y Araba), donde el operador del punto de venta puede verificar visualmente el documento antes de imprimirlo o enviarlo al cliente.

Preguntas frecuentes sobre IronPDF Viewer en España

¿Puedo usar IronPDF Viewer para visualizar facturas Facturae en formato PDF?

Sí. Las facturas Facturae en formato XML suelen ir acompañadas de una representación gráfica en PDF. IronPDF Viewer puede cargar y mostrar estos PDFs desde el sistema de archivos local, desde bytes en memoria o desde un flujo de red, lo que facilita la integración en aplicaciones de gestión de facturas para la Administración Pública española.

¿Está IronPDF Viewer preparado para entornos VERI*FACTU?

IronPDF Viewer es un componente de visualización; la generación del PDF de VERI*FACTU se realiza con la biblioteca principal IronPDF. Una vez generado, el componente Viewer permite mostrar la representación gráfica dentro de la misma aplicación, eliminando la dependencia de un visor externo en entornos de software de facturación certificado.

¿Cómo gestiono los permisos de archivo en entornos ENS?

En despliegues bajo el Esquema Nacional de Seguridad (ENS), donde los permisos de escritura en disco pueden estar restringidos, se recomienda usar IronPdfViewSource.FromBytes o IronPdfViewSource.FromStream para visualizar documentos desde memoria, evitando la necesidad de escribir PDFs temporales en el sistema de archivos.

¿Puede IronPDF Viewer utilizarse en plataformas de facturación electrónica B2B preparadas para Crea y Crece?

Sí. Con la entrada en vigor de la Ley Crea y Crece (B2B e-invoicing obligatorio previsto para 2027–2028, estándar EN 16931 / CIUS-ES), las plataformas de software de facturación B2B que necesiten mostrar representaciones gráficas de facturas electrónicas al operador pueden integrar IronPDF Viewer en su aplicación .NET MAUI. La carga desde bytes en memoria (IronPdfViewSource.FromBytes) permite visualizar las facturas generadas conforme a Crea y Crece sin escribir ficheros temporales en disco.