Ícono de mensaje
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ística MuPDF IronPDF
Licencia AGPL (viral) o comercial caro Comercial con precios transparentes
Enfoque principal Renderización/visualización Solución PDF completa
HTML a PDF No soportado Motor Chromium completo
Creación de PDF No soportado HTML, URL, imágenes
Manipulación de PDF Limitado Completar (combinar, dividir, editar)
Dependencias Binarios nativos Totalmente gestionado
Soporte de plataformas Manual por plataforma Automático
Soporte de Async Limitado Async/await completo
Integración .NET Interoperabilidad 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ística Complejidad de la migración Notas
Carga del documento Muy bajo Sustitución directa de métodos
Extracción de Texto Muy bajo API más sencilla
Fusión de PDF Bajo Método estático frente a bucles manuales
Reproducción de imágenes Bajo RasterizeToImageFiles vs pixmaps
HTML a PDF N/A (Nueva capacidad) No es posible en MuPDF
Seguridad/marcas de agua N/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

MuPDF IronPDF Notas
nuevo MuPDFDocument(ruta) <código>PdfDocument.FromFile(path)` Cargar desde archivo
nuevo MuPDFDocument(stream) <código>PdfDocument.FromStream(stream)` Cargar desde stream
document.Dispose() <código>pdf.Dispose()` Limpieza

Acceso a la página

MuPDF IronPDF Notas
document.Pages.Count <código>pdf.PageCount` Número de páginas
document.Pages[index] pdf.Pages[index] Página de acceso
page.GetText() page.Text Texto de la página

Extracción de texto

MuPDF IronPDF Notas
Bucle a través de document.Pages[i].GetText() <código>pdf.ExtractAllText()` Todo el texto a la vez

Creación de PDF (no disponible en MuPDF)

MuPDF IronPDF Notas
(no compatible) <código>ChromePdfRenderer.RenderHtmlAsPdf(html) HTML a PDF
(no compatible) <código>ChromePdfRenderer.RenderUrlAsPdf(url) URL a PDF

Manipulación de PDF (limitada en MuPDF)

MuPDF IronPDF Notas
Bucles de copia de página manual PdfDocument.Merge(pdf1, pdf2) Fusionar PDF
(no compatible) <código>pdf.ApplyWatermark(html)` Añadir marca de agua
(no compatible) <código>pdf.SecuritySettings Protecció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`:

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()`:

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