Saltar al pie de página
  1. IronPDF
  2. Blog de IronPDF
  3. Guías de migración
  4. migración de mupdf a ironpdf
GUíAS DE MIGRACIóN

Cómo migrar de MuPDF a IronPDF en C#

Curtis Chau
Curtis Chau
Publicado:

Por qué migrar de MuPDFa IronPDF

Los retos de MuPDF

MuPDF es un excelente renderizador de PDF, pero su licencia AGPL y su enfoque exclusivo de renderización crean limitaciones significativas para los desarrolladores .NET que crean aplicaciones comerciales:

  1. La trampa de la licencia AGPL: la licencia viral de MuPDFrequiere que la aplicación completa se publique en código abierto bajo AGPL o que se compren licencias comerciales costosas con precios opacos y de venta por contacto.

  2. Enfoque solo en la representación: MuPDFes un visualizador/representador; no está diseñado para la creación de PDF a partir de HTML, flujos de trabajo de generación de documentos, llenado de formularios o adición de marcas de agua y encabezados/pies de página.

  3. No admite HTML: MuPDFno admite la conversión directa de HTML a PDF. En primer lugar, tendrás que utilizar otra biblioteca para convertir HTML a un formato compatible. Esta es una limitación fundamental: MuPDFes principalmente un renderizador/visualizador de PDF.

  4. Dependencias nativas: los binarios específicos de la plataforma requieren administración manual para Windows, Linux y macOS. Los despliegues de Docker se vuelven complejos con los requisitos de las bibliotecas nativas, y el empaquetado del despliegue introduce desafíos.

  5. Manipulación limitada: no hay soporte integrado para fusionar o dividir archivos PDF, rotación o reordenamiento de páginas, marcas de agua o anotaciones, o firmas digitales.

  6. Complejidad de interoperabilidad de C: los enlaces nativos introducen problemas de gestión de memoria, errores específicos de la plataforma y sobrecarga de serialización.

Comparación entre MuPDFe IronPDF

CaracterísticaMuPDFIronPDF
LicenciaAGPL (viral) o comercial caroComercial con precios transparentes
Enfoque principalRenderización/visualizaciónSolución PDF completa
HTML a PDFNo soportadoMotor Chromium completo
Creación de PDFNo soportadoHTML, URL, imágenes
Manipulación de PDFLimitadoCompletar (combinar, dividir, editar)
DependenciasBinarios nativosTotalmente gestionado
Soporte de plataformasManual por plataformaAutomático
Soporte de AsyncLimitadoAsync/await completo
Integración .NETInteroperabilidad de C.NET nativo

Para los equipos que planifican la adopción de .NET 10 y C# 14 hasta 2025 y 2026,IronPDFproporciona una base a prueba de futuro como biblioteca .NET totalmente gestionada sin complejidad de interoperabilidad nativa.

Evaluación de la complejidad de la migración

Esfuerzo estimado por función

CaracterísticaComplejidad de la migraciónNotas
Carga del documentoMuy bajoSustitución directa de métodos
Extracción de TextoMuy bajoAPI más sencilla
Fusión de PDFBajoMétodo estático frente a bucles manuales
Reproducción de imágenesBajoRasterizeToImageFiles vs pixmaps
HTML a PDFN/A (Nueva capacidad)No es posible en MuPDF
Seguridad/marcas de aguaN/A (Nueva capacidad)No es posible en MuPDF

Cambio de paradigma

El cambio fundamental en esta migración de MuPDFes pasar de un visualizador solo de renderizado a una solución PDF completa:

using IronPdf; MuPDF: MuPDFContext → MuPDFDocument → Iteración de páginas → Sólo renderizar/extraer IronPDF: PdfDocument.FromFile() → Manipulación completa → Crear/Editar/Fusionar/Seguro using IronPdf;

Antes de empezar

Prerrequisitos

  1. Entorno .NET: .NET Framework 4.6.2+ o .NET Core 3.1+ / .NET 5/6/7/8/9+
  2. Acceso a NuGet: Capacidad para instalar paquetes NuGet
  3. Licencia de IronPDF: Obtenga su clave de licencia en ironpdf.com

Cambios en el paquete NuGet

using IronPdf;bash

Remove MuPDFpackages

dotnet remove package MuPDF.NET dotnet remove package MuPDFCore dotnet remove package MuPDFCore.MuPDFWrapper

Install IronPDF

dotnet add package IronPdf using IronPdf;

También elimine los binarios nativos de MuPDF de su implementación:

  • Borrar mupdf.dll, libmupdf.so, libmupdf.dylib
  • Eliminar carpetas específicas de la plataforma (runtimes/*/native/)
  • Actualizar los archivos Docker para eliminar la instalación de MuPDF

Configuración de licencias

using IronPdf;csharp // Add at application startup (Program.cs or Startup.cs) IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"; using IronPdf;

Identificar el uso de MuPDF

using IronPdf;bash

Find all MuPDFreferences

grep -r "MuPDF|MuPDFCore|MuPDFDocument" --include="*.cs" . using IronPdf;

Referencia completa de la API

Carga del documento

MuPDFIronPDFNotas
nuevo MuPDFDocument(ruta)<código>PdfDocument.FromFile(path)</códigoCargar desde archivo
nuevo MuPDFDocument(stream)<código>PdfDocument.FromStream(stream)</códigoCargar desde stream
document.Dispose()<código>pdf.Dispose()</códigoLimpieza

Acceso a la página

MuPDFIronPDFNotas
document.Pages.Count<código>pdf.PageCount</códigoNúmero de páginas
document.Pages[index]pdf.Pages[index]Página de acceso
page.GetText()page.TextTexto de la página

Extracción de texto

MuPDFIronPDFNotas
Bucle a través de document.Pages[i].GetText()<código>pdf.ExtractAllText()</códigoTodo el texto a la vez

Creación de PDF (no disponible en MuPDF)

MuPDFIronPDFNotas
(no compatible)<código>ChromePdfRenderer.RenderHtmlAsPdf(html)</códigoHTML a PDF
(no compatible)<código>ChromePdfRenderer.RenderUrlAsPdf(url)</códigoURL a PDF

Manipulación de PDF (limitada en MuPDF)

MuPDFIronPDFNotas
Bucles de copia de página manualPdfDocument.Merge(pdf1, pdf2)Fusionar PDF
(no compatible)<código>pdf.ApplyWatermark(html)</códigoAñadir marca de agua
(no compatible)<código>pdf.SecuritySettings</códigoProtección mediante contraseña

Ejemplos de migración de código

Ejemplo 1: Conversión de HTML a PDF (MuPDF no puede hacer esto)

Antes (MuPDF):

using IronPdf;csharp // NuGet: Install-Package MuPDF.NET using MuPDFCore; using System.IO;

class Program { static void Main() { // MuPDFdoesn't support HTML a PDFconversion directly // You would need to use another library to convert HTML to a supported format first // This is a limitation - MuPDFis primarily a PDF renderer/viewer

    // Alternative: Use a browser engine or intermediate conversion
    string html = "<html><body><h1>Hello World</h1></body></html>";

    // Not natively supported in MuPDF
    throw new NotSupportedException("MuPDF does not support direct HTML a PDFconversion");
}

} using IronPdf;

Después (IronPDF):

using IronPdf;csharp // NuGet: Install-Package IronPdf using IronPdf;

class Program { static void Main() { var renderer = new ChromePdfRenderer(); string html = "

Hello World

";

    var pdf = renderer.RenderHtmlAsPdf(html);
    pdf.SaveAs("output.pdf");
}

} using IronPdf;

Este ejemplo pone de manifiesto la limitación más importante de MuPDF: no puede convertir HTML a PDF en absoluto. El código MuPDFexplícitamente lanza NotSupportedException porque la conversión de HTML a PDF simplemente no es una capacidad que MuPDFproporciona. Si necesitaba esta funcionalidad con MuPDF, tenía que utilizar una biblioteca independiente como wkhtmltopdf o un motor de navegador y, a continuación, cargar el PDF resultante con MuPDFpara su visualización.

El ChromePdfRenderer deIronPDFutiliza un motor Chromium completo para renderizar HTML con soporte completo de CSS3, JavaScript y estándares web modernos. El método RenderHtmlAsPdf() acepta cadenas HTML directamente. Consulte la documentación HTML a PDF para conocer otras opciones de conversión, como la conversión de URL y de archivos HTML.

Ejemplo 2: Extracción de texto

Antes (MuPDF):

using IronPdf;csharp // NuGet: Install-Package MuPDF.NET using MuPDFCore; using System; using System.Text;

class Program { static void Main() { using (MuPDFDocument document = new MuPDFDocument("input.pdf")) { StringBuilder allText = new StringBuilder();

        for (int i = 0; i < document.Pages.Count; i++)
        {
            string pageText = document.Pages[i].GetText();
            allText.AppendLine(pageText);
        }

        Console.WriteLine(allText.ToString());
    }
}

} using IronPdf;

Después (IronPDF):

using IronPdf;csharp // NuGet: Install-Package IronPdf using IronPdf; using System;

class Program { static void Main() { var pdf = PdfDocument.FromFile("input.pdf"); string text = pdf.ExtractAllText();

    Console.WriteLine(text);
}

} using IronPdf;

El enfoque MuPDFrequiere crear un bloque using con un MuPDFDocument, iterar manualmente a través de document.Pages.Countcon un bucle for, llamar a document.Pages[i].GetText() para cada página y construir el texto con un StringBuilder. Se trata de 12 líneas de código para una simple extracción de texto.

IronPDF reduce esto a 3 líneas: cargar el documento con PdfDocument.FromFile(), llamar a ExtractAllText(), e imprimir el resultado. Nada de iteración manual, nada de StringBuilder, nada de gestión explícita de recursos con bloques using para esta sencilla operación. Obtenga más información sobre la extracción de texto de archivos PDF .

Ejemplo 3: Fusión de varios PDF

Antes (MuPDF):

using IronPdf;csharp // NuGet: Install-Package MuPDF.NET using MuPDFCore; using System.IO;

class Program { static void Main() { using (MuPDFDocument doc1 = new MuPDFDocument("file1.pdf")) using (MuPDFDocument doc2 = new MuPDFDocument("file2.pdf")) { // Create a new document using (MuPDFDocument mergedDoc = MuPDFDocument.Create()) { // Copy pages from first document for (int i = 0; i < doc1.Pages.Count; i++) { mergedDoc.CopyPage(doc1, i); }

            // Copy pages from second document
            for (int i = 0; i < doc2.Pages.Count; i++)
            {
                mergedDoc.CopyPage(doc2, i);
            }

            mergedDoc.Save("merged.pdf");
        }
    }
}

} using IronPdf;

Después (IronPDF):

using IronPdf;csharp // NuGet: Install-Package IronPdf using IronPdf;

class Program { static void Main() { var pdf1 = PdfDocument.FromFile("file1.pdf"); var pdf2 = PdfDocument.FromFile("file2.pdf");

    var merged = PdfDocument.Merge(pdf1, pdf2);
    merged.SaveAs("merged.pdf");
}

} using IronPdf;

La operación de fusión de MuPDFes especialmente prolija. Debe abrir ambos documentos fuente en bloques using anidados, crear un nuevo documento vacío con MuPDFDocument.Create(), iterar a través de cada página del primer documento llamando a CopyPage(), iterar a través de cada página del segundo documento llamando a CopyPage(), y finalmente guardar. Son más de 20 líneas de código con anidamiento complejo.

El método estático PdfDocument.Merge() deIronPDFacepta varios documentos PDF y devuelve un único documento fusionado. La operación completa consta de 4 líneas de código legible. Para fusionar muchos documentos, puede pasar una lista: PdfDocument.Merge(pdfList). Consulte la documentación sobre fusión y división de PDF para obtener más opciones.

Notas de migración críticas

Quitar binarios nativos

MuPDF requiere bibliotecas nativas específicas de la plataforma. Tras migrar a IronPDF, elimine todos los binarios nativos de MuPDF:

using IronPdf;bash

Delete native libraries

rm -f mupdf.dll libmupdf.so libmupdf*.dylib

Remove runtime folders

rm -rf runtimes/*/native/

Update Docker files to remove MuPDFinstallation

using IronPdf;

IronPDF es un código .NET totalmente gestionado, sin binarios nativos que gestionar entre plataformas.

Patrón Dispose simplificado

MuPDF requiere un contexto y una gestión de documentos explícitos:

using IronPdf;csharp // MuPDF: Nested using blocks required using (MuPDFDocument document = new MuPDFDocument("input.pdf")) { // Work with document }

// IronPDF: Simpler pattern var pdf = PdfDocument.FromFile("input.pdf"); // Work with pdf using IronPdf;

Cambio de patrón de iteración de página

MuPDF utiliza iteración basada en índices con recuento explícito de páginas:

using IronPdf;csharp // MuPDF for (int i = 0; i < document.Pages.Count; i++) { var pageText = document.Pages[i].GetText(); }

//IronPDF(foreach supported) foreach (var page in pdf.Pages) { var pageText = page.Text; } using IronPdf;

Nuevas funciones disponibles

Tras migrar a IronPDF, obtendrá funciones que MuPDFno puede ofrecerle:

using IronPdf;csharp // Creación de PDFfrom HTML (not possible in MuPDF) var pdf = renderer.RenderHtmlAsPdf("

Hello

");

// Watermarks (not possible in MuPDF) pdf.ApplyWatermark("

DRAFT
");

// Password Protection (not possible in MuPDF) pdf.SecuritySettings.OwnerPassword = "admin"; pdf.SecuritySettings.UserPassword = "user";

// Headers and Footers (not possible in MuPDF) pdf.AddTextHeader("Document Title"); pdf.AddTextFooter("Page {page} of {total-pages}"); using IronPdf;

Solución de problemas

Edición 1: MuPDFDocument Not Found

Problema: la clase MuPDFDocument no existe en IronPDF.

Solución: utilice PdfDocument.FromFile() :

using IronPdf;csharp // MuPDF using (MuPDFDocument document = new MuPDFDocument("input.pdf"))

// IronPDF var pdf = PdfDocument.FromFile("input.pdf"); using IronPdf;

Asunto 2: Páginas.no encontradas

Problema: el patrón document.Pages.Countno funciona.

Solución: utilice <código>pdf.PageCount</código:

using IronPdf;csharp // MuPDF for (int i = 0; i < document.Pages.Count; i++)

// IronPDF for (int i = 0; i < pdf.PageCount; i++) // Or use: foreach (var page in pdf.Pages) using IronPdf;

Edición 3: GetText() no se encuentra

Problema: el método page.GetText()no existe.

Solución: utilice la propiedad page.Texto <código>pdf.ExtractAllText()</código:

using IronPdf;csharp // MuPDF string pageText = document.Pages[i].GetText();

// IronPDF string pageText = pdf.Pages[i].Text; // Or for all text: string allText = pdf.ExtractAllText(); using IronPdf;

Edición 4: Página de copia no encontrada

Problema: Patrón de copia de página manual para fusionar.

Solución: utilice PdfDocument.Merge() estático:

using IronPdf;csharp // MuPDF mergedDoc.CopyPage(doc1, i);

// IronPDF var merged = PdfDocument.Merge(pdf1, pdf2); using IronPdf;

Lista de comprobación de la migración

Pre-Migración

  • Inventario de todos los usos de MuPDFen el código base
  • Documentar todas las operaciones de renderizado (DPI, factores de escala)
  • Identificar cualquier necesidad de creación de PDF (actualmente utilizando herramientas externas)
  • Enumerar los requisitos de extracción de texto
  • Revisar los scripts de implementación para el manejo binario nativo
  • Obtener la clave de licencia de IronPDF

Cambios en el paquete

  • Eliminar el paquete MuPDF.NET
  • Eliminar el paquete MuPDFCore
  • Eliminar el paquete MuPDFCore.MuPDFWrapper
  • Instalar el paquete NuGet IronPdf : dotnet add package IronPdf
  • Actualizar las importaciones de espacios de nombres

Cambios de código

  • Agregar configuración de clave de licencia al inicio
  • Reemplace MuPDFDocument con PdfDocument.FromFile()
  • Reemplace document.Pages.Countcon pdf.PageCount
  • Reemplace page.GetText()con page.Texto pdf.ExtractAllText()
  • Reemplace los bucles manuales CopyPage con PdfDocument.Merge()
  • Eliminar bloques anidados using para la gestión del contexto
  • Agregue código de creación de PDF si es necesario (HTML a PDF)

Posmigración

  • Eliminar los binarios nativos de MuPDFdel proyecto
  • Actualizar los archivos Docker para eliminar la instalación de MuPDF
  • Eliminar carpetas de tiempo de ejecución específicas de la plataforma
  • Ejecutar pruebas de regresión comparando la salida renderizada
  • Prueba en todas las plataformas de destino (Windows, Linux, macOS)
  • Considere agregar nuevas capacidades (marcas de agua, seguridad, encabezados/pies de página)
Curtis Chau
Curtis Chau
  Chatea con el equipo de ingeniería ahora
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más

Artículos Relacionados

Prueba de 30 días → Producto completo. Sin límites. Sin tarjeta. Prueba gratis