如何用 C# 从 MuPDF 迁移到 IronPDF

删除本地二进制文件

MuPDF 需要特定平台的本地库。 迁移到IronPDF后，删除所有MuPDF本地二进制文件：

# Delete native libraries
rm -f mupdf*.dll libmupdf*.so libmupdf*.dylib

# Remove runtime folders
rm -rf runtimes/*/native/

# Update Docker files to removeMuPDFinstallation

# Delete native libraries
rm -f mupdf*.dll libmupdf*.so libmupdf*.dylib

# Remove runtime folders
rm -rf runtimes/*/native/

# Update Docker files to removeMuPDFinstallation

IronPDF 是完全托管的 .NET 代码，无需跨平台管理本地二进制文件。

简化处置模式

MuPDF 需要明确的上下文和文档管理：

// 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

// 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

页面迭代模式更改

MuPDF 使用基于索引的迭代，并有明确的页数：

// 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;
}

// 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;
}

可用的新功能

迁移到IronPDF后，您将获得MuPDF无法提供的功能：

//PDF 创建from HTML (not possible in MuPDF)
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello</h1>");

// Watermarks (not possible in MuPDF)
pdf.ApplyWatermark("<div style='color:red;opacity:0.3;'>DRAFT</div>");

// 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}");

//PDF 创建from HTML (not possible in MuPDF)
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello</h1>");

// Watermarks (not possible in MuPDF)
pdf.ApplyWatermark("<div style='color:red;opacity:0.3;'>DRAFT</div>");

// 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}");

问题 1：未找到 MuPDFDocument

问题：IronPDF中不存在MuPDFDocument类。

解决方案：使用PdfDocument.FromFile() :

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

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

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

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

问题 2：Pages.Count 未找到

问题： document.Pages.Count模式不起作用。

解决方案：使用pdf.PageCount ：

// 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)

// 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)

问题 3：GetText() 未找到

问题： page.GetText()方法不存在。

解决方法：使用page.Text属性或pdf.ExtractAllText() ：

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

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

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

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

问题 4：未找到复制页面

问题：手动复制页面以进行合并的模式。

解决方案：使用静态的PdfDocument.Merge()方法：

// MuPDF
mergedDoc.CopyPage(doc1, i);

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

// MuPDF
mergedDoc.CopyPage(doc1, i);

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

迁移前

• 清点代码库中所有MuPDF的使用情况
• 记录所有渲染操作（DPI、缩放因子）
• 确定任何 PDF 创建需求（目前使用外部工具）
• 列出文本提取要求
• 检查部署脚本中的原生二进制文件处理情况
• 获取IronPDF许可证密钥

软件包变更

• 删除MuPDF.NET包
• 移除MuPDFCore软件包
• 删除MuPDFCore.MuPDFWrapper包 安装IronPdf NuGet 包： dotnet add package IronPdf
• 更新命名空间导入

代码更改

• 在启动时添加许可证密钥配置
• 将MuPDFDocument替换为PdfDocument.FromFile()
• 将document.Pages.Count替换为pdf.PageCount
• 将page.GetText()替换为page.Text或pdf.ExtractAllText()
• 将手动CopyPage循环替换为PdfDocument.Merge()
• 移除嵌套的using语句块以进行上下文管理
• 如有需要，添加 PDF 创建代码（HTML 转 PDF）

后迁移

• 从项目中移除原生MuPDF二进制文件
• 更新 Docker 文件以移除MuPDF安装
• 删除平台特定的运行时文件夹
• 运行回归测试，比较渲染输出
• 在所有目标平台（Windows、Linux、macOS）上进行测试
• 考虑添加新功能（水印、安全设置、页眉/页脚）