更新日志:更新、里程碑、路线图
IronPDF 路线图
通过优先考虑兼容性、可用性和效果,我们已将 IronPDF 制作成领先的 .NET HTML 到 PDF 产品。 现在,我们的任务是通过不断更新 IronPDF 以适应最新的 HTML、CSS 和 JS 技术变革以及 Chrome 的前沿版本,维护这一来之不易的声誉。
我们的软件是由工程师为工程师开发的,因此我们理解严格测试、支持以及透明的一次性许可的重要性。
我们以倾听社区为荣,并通过优先考虑客户提出的功能请求来证明这一点。
在过去的几年中,我们持续开发IronPDF,扩展其能力以服务不仅于.NET开发者,还有Java、Python和Node.js社区。
¹ 基于 2022 年 8 月对我们产品的独立审核。
里程碑
在这里,我们重点介绍三个主要里程碑,它们对 IronPDF 的性能改进作出了显著贡献。 查看里程碑 >
2026年5月
IronPDF v2026.5.2
发布说明
- 添加了
VerifiedSignature,提供完整的X.509证书详细信息,包括主体DN、发行者、序列号、有效期和来自数字签名PDF的原始DER字节 - 添加了
LinkAnnotation类,用于在PDF文档中创建点击后导航到特定页面和位置的链接 - 添加了
LinearizePdfToStream方法,支持全内存PDF线性化,不需要磁盘I/O,非常适合基于云和沙盒环境 - 添加了自动PDF书签生成功能,通过HTML标题(h1–h6)在渲染期间,包括正确的层级结构、页面映射和根据标题级别或CSS选择器的可选过滤
- 使用静态链接的libjpeg和zlib重建了qpdf 12.3.2,移除对系统libjpeg.so.62的依赖,以适应现代Linux发行版如Rocky 9/10和Debian 13
- 修复了使用
UseScaledRendering()在非默认缩放级别时,HTML页眉和页脚没有正确缩放的问题 - 修复了自定义纸张尺寸下使用FragmentHeight渲染页眉/页脚时的间歇性
IronPdfInputException问题 - 修复了进程拆卸期间的间歇性SEGFAULT,并改进了标签池稳定性,以防止并发渲染问题和日志垃圾邮件
- 更新了内部依赖项
2026年4月
IronPDF v2026.4.1
发布说明
- 通过减少内部渲染调用并复用浏览器标签页来降低启动开销,从而提升了 PDF 渲染性能
- 针对包含混合输入类型、隐藏元素、深度嵌套标签以及注释顺序的表单,改进了 PDF/UA 结构树标记,以确保控件与结构元素的正确关联
- 将 IronPdfEngine Docker 镜像大小缩减了 60%(从 2.89 GB 缩减至 1.14 GB)
- 通过移除不必要的软件包、修复 4 个高危 CVE 以及 1,400 多个其他安全扫描问题,提升了 IronPdfEngine Docker 镜像的安全性
- 改进了IronPdfEngine Docker容器,能正确转发运行时参数,如端口、
chrome_browser_limit - 修复了
RedactRegions的内存泄漏问题,重复调用会导致不断增长的内存消耗(减少了93-97%) - 修复了
GetMetadata中的缓冲区过读问题,可能导致崩溃或数据损坏 - 修复了 PDF/UA 转换时移除 CSS overflow:hidden 裁剪的问题,确保裁剪后的图像与标准 PDF 输出效果一致
- 修复了由类似Adobe Reader的外部签名者创建签名时,验证签名时
SignatureName总是为空的问题 - 修复了DOCX到PDF转换中缺少页眉/页脚图像的问题(
DrawingML和VML)
2026年3月
IronPDF v2026.3.1
发布说明
- 添加了带自动智能压缩的
CompressPdfToStream,通过磁盘或内存处理减少PDF文件大小 - 通过解决结构标记错误、恢复语义标签(H1/P)、修复标签渲染问题、消除表单处理期间的
AccessViolationException崩溃以及防止重复的可访问性标签,改进了PDF/UA的可访问性支持 - 增强了签名验证功能,包括证书信任链、吊销状态、算法强度、字节范围完整性以及可选的增量篡改检测。
- 增强了 RTF 到 PDF 的转换功能,支持多列布局,并可自动检测横向方向、边距和列设置。 已解决表格边框裁剪、首字符截断和重复图元文件图像问题。
- 通过将内部 URL 替换为自定义方案,增强了内部 HTML 渲染,从而提高了安全合规性并减少了不必要的网络请求。
- 解决了由非标准XMP元数据和不完整的Type1字体
CharSet条目导致的PDF/A验证失败问题 - 修复了解析签名时间戳时导致未处理异常的问题。
- 修复了调整旋转页面大小导致尺寸不正确或内容被截断的问题。
- 修正了
LinuxAndDockerDependenciesAutoConfig在Ubuntu 24.04上正确安装libasound2t64用于.NET 9/10环境的问题 - 修复了在启用
UseResponsiveCssRendering(固定像素宽度)时,HTML页眉和页脚渲染宽度和字体缩放不正确的问题 - 修复了在为具有格式错误的纲要结构的PDF添加顶级书签时的
System.AccessViolationException问题 - 修复了在合并或附加PDF后,
ComboBox表单字段失去选项的问题
2026 年 2 月
IronPDF v2026.2.1.
发布说明
- 更新内部依赖项。
2026 年 1 月
IronPDF v2026.1.3.
发布说明
- 添加了通过本地路径或远程URL在
ChromePdfRenderOptions中进行自定义断字支持 - 在
UpdateImageObject中增强了健壮的状态跟踪转换系统 - 增强从现有 PDF 中复制页面的功能,以避免某些特定文档出现 Stack Overflow 异常
- 修复了获取带有 unicode 字符的表单字段导致 IronPDF 冻结的问题
- 修复了将某些 PDF 转换为 PDF/UA 可能导致文本和形状颜色重置或呈现不正确的问题
- 修复了在使用非标准
CropBox偏移的文档中平展PDF导致内容消失或被裁剪的问题 - 修复了由
ToUnicodeCMaps中的禁止Unicode值导致PDF/A-4导出验证失败的合规性问题 - 修正了某些 PDF 文件中组合框表单字段显示空字符串选项且无法正确验证值的问题
- 修复了在某些PDF中处理格式错误的字体宽度数组时发生的
System.AccessViolationException崩溃 - 修复了在呈现带有复杂或畸形表单字段的页面时出现的崩溃(访问违规
- 修正了一个问题,即绘制矩形时的 Y 位置不正确
- 修正了一个问题,即基于柔性布局的 HTML 页眉和页脚无法正确适应不同的页面方向
- 修正了一个问题,即当添加后期渲染器时,HTML 页眉和页脚的高度和字体缩放不正确
2025 年 12 月
IronPDF v2025.12.2.
发布说明
- 新增对 PDF/UA-2 (ISO 14289-2:2024) 合规性的支持
- 添加了新的
CompressAndSaveAsAPI,提供了更好的压缩 -
添加了
SaveAsJsonAPI,用于将PDF内容提取为JSON - 改进文档和示例
-
启用了在本地运行IronPdfEngine时将本地HTML文件转换为PDF功能,适用于Java和Node.js
- 修复了
ApplyMultipleStamps在某些纸张尺寸上裁剪印章内容的问题 - 修复了Python中
IronPdf的内部部署问题 - 修正 QPdf 操作随机抛出异常的问题
2025 年 11 月
IronPDF v2025.11.12
发布说明
- 增加对 PDF/A-4、PDF/A-4E 和 PDF/A-4F (ISO 19005-4:2020) 合规性的支持。
- 增加了通过 USB 令牌使用硬件安全模块 (HSM) 签署 PDF 的支持。
- 改善了表单生成流程中的内存使用。 PDF-1599
- 修复了当应用于旋转的横向页面时,页眉和页脚在无效位置的问题。
- 修复了由于子集字体中的 CIDSet 无效,导致将某些 PDF 转换为 PDF/A 1a/1b 验证失败的问题。
- 修复了 IronPDF 无法访问带有北欧字符的临时文件目录的问题。
- 修复了
CreatePdfFormsFromHtml创建不正确的表单字段名称的问题。 - 修复了
ASP.NET框架Web应用程序在验证许可证时完全冻结的严重问题。 - 修复了一些 Linux 环境中抛出 "不支持的平台" 错误的问题。
2025年10月
IronPDF v2025.10.8
发布说明
-
添加了新的
IsLinearizedAPI。 - 修复了在
HtmlStructTreeDom中处理某些HTML块、链接或文本节点时未正确处理,导致在生成PDF/UA时出现异常的问题。 - 修复了 CSS 自动断字规则未被应用的问题。
- 修复了在不同父项下具有相同名称的父书签被错误替换的问题。
- 修复了使用
Cleaner.ScanPdf时的内存泄漏问题。 - 修复了在多页上应用
HtmlHeaderFooter时的性能回退问题。
2025 年 9 月
IronPDF v2025.9.4
发布说明
- 在
IgnorePageRotation标志,用于忽略页面的旋转。 - 在应用相同的
Footer到多页时减小了PDF文件大小。 - 修复了PDF/UA合规性中由于链接注释缺少适当的
VeraPDF验证失败。 - 在某些PDF字体缺少
VeraPDFPDF/3A验证失败的问题。 - 修复了将 HTML 渲染为 PDF 时的重大内存泄漏问题。
- 修复了应用
Footer时的内存泄漏问题。 - 修复了使用
DrawTextAPI时的轻微内存泄漏问题。
2025 年 8 月
IronPDF v2025.8.8
发布说明
-
添加了一个新
VerifiedSignature.SignerName属性用于访问数字签名者的姓名。 -
将带有表单字段的 PDF 自动转换为图像时自动平铺,确保表单值默认显示。
- 修复了将PDF作为PDF/A保存后将其保存为PDF/UA时在某些情况下会引发
AccessViolationException的问题。 - 修复了在将某些PDF页面转换为PDF/UA时PDF/UA转换抛出
AccessViolationException的问题。 - 修复了当内容需要换行时,HTML 页眉和页脚的长内容被错误剪切的问题。
- 修复了在 PDF 标题元数据中使用数字字符引用的表情符号和特殊字符在 PDF 生成期间导致异常的问题。
- 修复了在 Linux 中将 HTML 渲染为 PDF 时中文表单域值损坏的问题。
- 修复了在某些 PDF 文件中进行 PDF/A 转换时的内存泄漏问题。
- 修复了替换或删除任何 PDF 对象时背景颜色变成黑色的问题。
- 修复了签署包含未签署的签名表单域的 PDF 时抛出异常的问题。
2025年7月
IronPDF v2025.7.17
发布说明
- 按平台分离
IronSoftware.Native.PdfModel依赖包。 -
增强了
Cleaner.SanitizeWithSvg方法,默认情况下保留原始PDF的边距 - 修复了目录 (TOC) 中的点分辨率较低的问题。
- 修复了启用
Grayscale使PDF文本被光栅化为图像而不是保持可选择的问题。 - 修复了在某些 PDF 中书签页面索引返回错误值的问题。
- 修复了在旋转页面上盖章时导致原始内容损坏的问题。
- 修复了
CompressImages导致某些PDF中的图像旋转的问题。 - 修复了将 PDF 转换为图像时渲染透明区域为黑色的问题。
- 修复了使用非默认字体的文本在将 PDF 转换为 PDF/UA 时丢失的问题。
- 修复了HTML表单字段,尤其是跨越多页的长文本区域,可能导致PDF生成时的
AccessViolationException的问题。 - 修复了名称相同的复选框未正确创建的问题。
- 修复了在 BenchmarkDotNet 中显示高内存分配的问题。
- 修复了
AddForegroundOverlayPdfToPsd导致主PDF的内部链接断裂的问题。 - 修复了
ShrinkImage设置为True时使图像黑屏的问题。 - 修复了在从
AddBackgroundPdf将背景放在前景的问题。 - 修复了在
Bitmap时导致背景覆盖前景的问题。 - 修复了应用于盖章器的旋转导致盖章器对象放置在错误位置的问题。
2025 年 6 月
IronPDF v2025.6.8
发布说明
-
添加了新的
ToMultiPageTiffStream()API -
优化了内部
ToMultiPageTiff()转换 - 修复了合并文档时书签目标未更新的问题。
- 修复了文本行和文本块抛出系统访问违规异常的问题。
- 修复了合并、复制或插入PDF时表单字段丢失的问题。 现在所有的第二个及以后的PDF的表单字段名称都更新为
x是PDF的索引(例如,PDF 1上的字段firstname保持为firstname,在PDF 2上变为firstname_1,在PDF 3上变为firstname_2)。 - 修复了应用印章或页眉/页脚时注释丢失的问题。
- 修复了当应用印章或页眉/页脚时,
AcroForm字段丢失的问题。 - 修复了在使用含有页眉/页脚的 HTML 渲染为 PDF 时缺少超链接的问题。
- 修复了合并某些 PDF 时会崩溃的问题。
- 修复了合并或复制 PDF 时缺少某些书签的问题。
- 修复了由于复杂 PDF 文件中的文本碎片化和标题检测问题导致目录生成失败并出现空目录的问题。
- 修复了由于 HTML 解析与 PDF 文本提取之间的空白差异,导致目录生成无法匹配包含 HTML 实体的标题的问题。
- 修复了将某些DOCX文件转换为PDF时,
RenderDocxAsPdf抛出异常的问题。 - 修复了添加多个HTML页眉/页脚时,
SaveAsPdfUA抛出内存违规异常的问题。 -
修复了一些内部内存泄漏。
Flatten
2025年5月
IronPDF v2025.5.6
发布说明
- 支持 Linux ARM
-
添加了一个新的API,用于检索文本对象的每个字符的单独字形信息和边框框(见
TextObject.GetGlyphInfo())。 - 改进了签名移除,确保在签名移除后文档可编辑(见
PdfDocument.RemoveSignatures())。 - 改进了 macOS 错误处理,以在出现未捕获的 JavaScript 错误时优雅地取消 PDF 渲染,防止崩溃。
- 改进了字体取消嵌入的可靠性。
-
增强了 HTML 到 PDF 转换的内部作业和任务队列,提高了性能和可靠性。
- 修复了 PDF/A 文档中嵌入字体的相关问题。
- 解决了调用
SaveAsPdfA()时的内存泄漏问题。 - 修复了调用
Flatten()后,旋转的页面显示不正确的问题。 - 修正了 IronPDFEngine 的许可证密钥应用问题。
-
解决了未能按预期减少 PDF 文件大小的字体取消嵌入问题。
- 改进了 PDF/A 和 PDF/UA 文档。
2025 年 4 月
IronPDF v2025.4.4
发布说明
-
引入了新的
ToBitmapHighQualityAPI。 - 优化了 PDF 转图像的内存使用。
-
更新了
NaturalLanguages参数,使其变为可选。 - 修复了
IronPdfEngine(gRPC)的功能性问题。 -
解决了打印时表单的可见性问题。
- 为某些类添加了缺少的文档。
2025 年 3 月
IronPDF v2025.3.6
发布说明
- 将默认打印 DPI 调整为 300。
-
更新了
Environment.ProcessorCount,提高了云部署的稳定性。 - 解决了来自
HtmlHeaderFooter的PDF页面编号不正确的问题。 - 修复了由于元数据键中的括号引起的异常。
- 解决了一些 PDF 中不正确的打印边距对齐问题。
- 处理了在单进程模式下使用
UpdatedChrome的崩溃和警告问题。
2025 年 2 月
IronPDF v2025.2.8
发布说明
-
启用了在PDF/A文档中编辑自定义XMP元数据的功能,适用于
EmbedFileToPdfA。 - 改进了
ExtractAllTextVisualOrder输出。 -
增强了在添加新书签或合并包含书签的文档时书签的处理。
- 修正了注释图标、颜色和位置更新问题。
- 解决了注释坐标值为零的问题。
- 使用
FindFormField修正了表单字段发现。 - 解决了复选框表单行为如单选按钮的问题。
- 解决了单选按钮表单中丢失的"否"值。
- 处理了
DocuSign中的文本字段显示问题。 - 修复了
Cleaner.ScanPdf()中的异常。 - 解决了 .NET Framework 应用程序退出时 gRPC 通道异常的问题。
- 改进了使用
RenderingOptions.MarginRight进行页眉/页脚高度管理。 - 修正了
PdfDocument复制构造函数的行为。 - 解决了页眉/页脚 CSS 样式与主要内容对齐的问题。
- 解决了在32位.NET Framework上出现
Compress异常的问题。 - 改进了
RemoveSignatures中的异常。 - 修复了
MetaData.Keywords重新分配异常。 - 解决了从特定PDF中检索
Bookmarks时的过程冻结问题。 - 修正了访问某些PDF
Form对象时的异常。
2025 年 1 月
IronPDF v2025.1.1
发布说明
- 针对Linux和Windows引入了基于最新CEF 131的
IronPdf.Native.UpdatedChrome包。 -
添加了新的
RenderZipFileAsPdfAPI重载。 - 改进了整体 PDF 表单操作性能和 HTML 表单生成。
-
增强了 PDF 文本提取质量。
- 解决了从版本2024.8.3升级
RenderRazorViewToPdf()编译错误。 - 修正了
DrawText()方法的换行符渲染问题。 - 解决了由于不支持的元素导致 RTF 转换为 PDF 时的异常。
- 修复了
ReplaceText()方法中的缺失字形渲染问题。 - 解决应用密码保护后超链接问题。
- 修正了使用
PdfPage时的线条和文本块检测问题。 - 解决了 PDF 转图像时的 DPI 参数问题。
- 解决了使用
Flatten()方法导致的PDF尺寸变化问题。 - 解决了应用背景 PDF 后 HTML 页眉/页脚可见性问题。
- 解决了 Base64 编码图像干扰 UTF-8 编码的问题。
2024 年 12 月
IronPDF v2024.12.9
发布说明
- 修复了合并某些 PDF 时会导致崩溃的问题。
- 修正了一个问题,即编辑区域下文本的第一个字母仍可能出现在输出中。
- 添加了在
DrawText中的换行符支持。 - 为
IsSubsetted属性。 - 为
PdfFontCollection.Find添加了skipSubsetFonts标志。 - 添加了
PdfFont对象。
2024年11月
IronPDF v2024.11.4
发布说明
- 添加了一个新的 API,用于在 PDF/A 转换过程中嵌入文件。
- 为
ReplaceTextAPI添加可选参数CustomFontSize。 - 允许自定义字体与
DrawTextAPI一起使用。 - 修复邮票定位问题。
- 修复了某些 PDF/A 文件无法在 Adobe Acrobat Pro 中显示的问题。
- 修正了
ReplaceText导致垂直换行的问题。 - 修正了
Transform()方法不可访问的问题。 - 增强对 Unicode 文本的支持。
- 改进内存使用和性能。
- 提升了
ApplyMultipleStampsAsync速度。
2024年10月
IronPDF v2024.10.8
发布说明
- 改善文本编辑定位
- 改善PDF/A-3转换
- 改善复选框和单选按钮的外观和行为
- 改善缩放时的印章定位精度
- 修复了在旋转页面时,应用的印章偏移的问题。
- 修复了在设置表单值时Unicode字符不显示的问题
- 修复了
VerifyPdfSignatures返回不正确值的问题 - 使签名字段在Bluebeam Revu中可见
IronPdfEngine现在支持表单单选按钮、签名字段和图像字段。
2024 年 9 月
IronPDF v2024.9.3
发布说明
- 添加对'.download'文件扩展名的HTML资源支持
- 添加了新的实验API,用于访问PDF中的所有DOM对象(见
PdfDocument.Pages[].ObjectModel) - 为HTML转换为PDF添加了HTTP请求头支持(见
ChromePdfRenderOptions.HttpRequestHeaders) - 改进了外部PDF阅读器对多个签名的验证(见
SignaturePermissions) - 改善组合页面功能的行为和保真度 (也称为N-up)
2024 年 8 月
IronPDF v2024.8.3
发布说明
- 添加对PDF/A版本 1A, 1B, 2A, 2B, 3A 转换的支持!
- 添加了创建空白PDF文档的支持(见
PdfDocument构造函数) - 添加了将PDF页面合并为单页行列的支持(见
PdfDocument.Com/binePages()) - 添加了移动或缩放整个页面内容的支持(见
PdfPage.Transform()) - 修复渲染HTML到PDF/A时复选框不可交互的问题
-
改进从HTML创建单选按钮时的性能
RedactRegion需要负数高度才能正常工作(pr)CombinePages不支持合并不同大小的页面(pr)
2024 年 7 月
IronPDF v2024.7.8
发布说明
- 修复了保存为 PDF/A 时链接、表单和注释被破坏的问题。
- 修复了保存为 PDF/UA 时选项卡顺序不正确的问题。
- 修复删除 PDF 对象时的内存泄漏问题。
- 修复了无法通过 Adobe Acrobat Pro 编辑表格的问题。
- 修复了渲染大型图片时导致崩溃的问题。
- 修复了渲染宽度不适用于页眉和页脚的问题。
- 修复了不同页面尺寸下印章错位的问题。
- 修复了扁平化页面后表单值不可见的问题。
- 修复了将页面转换为图片时表单值不可见的问题(使用 Flatten=true`)。
- 修复了签名图像不可见的问题。
- 改善对重复表单名称的表单值设置支持。
- 添加从HTML输入中渲染选定组合框列表的支持。
- 为文本编辑API添加新选项。
- 增加对整个单词编辑的支持,包括标点符号。
2024 年 6 月
IronPDF v2024.6.1
发布说明
- 添加新的区域编辑API
- 添加对图像表单字段的支持
- 添加在将PDF转换为图像时显示表单字段值的支持
- 允许
SaveAsPdfUA使用自定义自然语言标识符 - 修复了
SaveAsPdfUA有时崩溃的错误 - 修复了
Merge有时崩溃的错误 - 修复了
Stamp损坏某些PDF的问题 - 修复了
CompressImage损坏某些PDF的问题 - 修复了添加
Footer损坏某些PDF的问题 - 修复了忽略带点符号的表单字段名的问题
- 修复了一大堆
System.AccessViolationExceptions在处理PDF文档时的问题 - 修复了
QRCode使用无效宽度和高度的问题 - 修复了
RenderDocxAsPdf无视docx中的分页面元的问题 - 修复了登录身份验证用户名错误地设置为密码值的问题
- 修复了某些系统上符合 FIPS 标准的错误
- 修复了当
StackOverflowException问题 - 改进了对表单注释的支持
- 更新至最新的 Pdfium 版本,其中包括操作现有 PDF 文档时的修复问题
- 将
IronSoftware.System.Drawing更新到2024.6.1 - 在
IronPdfDocker镜像中支持更多语言
2024年5月
IronPDF v2024.5.2
发布说明
- 添加了新的
IronPdf.CleanerAPI,可对PDF进行消毒和扫描。 - 修复了
RenderRtfFileAsPdf有时返回黑色内容的问题。
2024年4月
IronPDF v2024.4.2
发布说明
- 添加了新
PdfDocument.Com/press()API。 - 修复旋转PDF导致在将PDF转换为HTML时断裂的图像问题。
- 修复在将包含阿拉伯语的PDF转换为HTML时破坏HTML结构的问题。
- 修复在应用边距时更改页眉/页脚字体大小的问题。
- 修复在渲染复杂HTML时目录失败的问题。
- 修复了在
IronPdfEngine中设置许可证密钥不起作用的问题。 - 修复旋转PDF转换为HTML时输出破损图像的问题。
- 修复将含阿拉伯字符的PDF转换为HTML时破坏文档结构的问题。
- 修复了
PdfSignature.SigningContact不起作用的问题。 - 提升了
DocxToPdf性能。 - 使所有
Print方法异步化。 - 更新gRPC库到版本2.62.0
2024 年 3 月
IronPDF v2024.3.4
发布说明
- 添加了一个全面的字体API,用于添加、移除和使用字体(见
PdfDocument.Fonts) - 添加了PDF文本编辑功能(见
PdfDocument.RedactText()) - 为
PdfDocument.Com/pressImages()添加了支持压缩灰度图像的功能 - 为
PdfDocument.Com/pressImages()添加了支持"444"和"441"两种色度抽样的功能 - 添加了从base64字符串加载签名的新方法(见
PdfSignature.FromBase64()) - 在使用
IronPdf"Docker Engine"时为MacOsARM添加支持 - 为
IronPdf"Docker Engine"添加IronPDF_ENGINE_ENABLE_LOG环境标志 - 改善用户尝试使用没有私钥的签名进行签署时的错误信息
- 在检测到
IronPdf"Docker Engine"版本不匹配时改进了错误消息 - 改善打开文档或处理图像时的内存使用
- 改进了对PDF/A的支持
- 改进文本提取,现在省略了行尾连字符(0xFFFE字符)
- 修复了注释未正确调整大小的问题(见
PdfDocument.ResizePage()) - 修复了客户覆盖IronPDFEngine中许可证密钥的问题
- 修复目录在使用单行HTML时不起作用的问题
- 修复了升级
IronPdf版本时的不兼容程序集问题 - 修复了与
OpenXML库的罕见版本冲突问题 - 修复HTML戳记布局问题
- 修复应用背景PDF时内容消失问题
- 修复使用HTML无法选择集合中的第一个单选按钮的问题
- 修复某些PDF上的数字签名在Adobe viewer中不可见的问题
2024 年 2 月
IronPDF v2024.2.2
发布说明
- 修复了在调用
AppendPdf()修改文档后转换的问题 - 修复了在
Installation.AutomaticallyDownloadNativeBinaries=true未被下载时的问题 - 修复了
Installation.CustomDeploymentDirectory被忽略的问题 - 修复启用PDF/A合规性会移除透明度并导致背景变黑的问题
- 修复了
PdfFormFieldFlags枚举对用户不可访问的问题 - 修复了如果文本未在每一页上找到,则
ReplaceTextOnPages()会抛出错误的问题 - 修复Linux上的cookie支持问题
- 修复了
Installation.SingleProcess总是启用的问题 - 修复了配置
IronPdf使用Docker/远程后处理表单时出现的各种问题 - 改善各种注释和API文档
- 改善替换文本时的字母、单词和文本间距; 单词之间不再有错误的字母间距
- 添加了对自定义远程
IronPdfConnectionConfiguration WithCustomChannel())
2024 年 1 月
IronPDF v2024.1.20
发布说明
- 增加用于单选按钮和复选框的有效选择列表。 (See
CheckboxFormFieldandRadioFormFieldforChoicesandSelectedIndex) - 增加设置单选按钮和复选框选定索引的方法。 (See
CheckboxFormFieldandRadioFormFieldforClear()andSelect) - 增加在现有文档上绘制线条和矩形的能力。 (See
PdfDocumentforDrawLine()andDrawRectangle()) - 添加一个空的签名字段,允许用户点击签名。 (See the
SignatureFormFieldclass) - 添加带位置信息的文本、字符和行提取。 (See
PdfDocument.PagesforLinesandCharacters) - 为接受不受信任用户输入的那些用户添加更强大的自选网络安全功能。 (See
Installation.EnableWebSecurity) - 添加在现有文档上绘制文本时指定字体的功能。 (See
PdfDocument.DrawText()) - 添加对OpenAI扩展的支持。 (See
IronPdf.Extensions.AINuGet package) - 添加了通过
ObservableCollection) - 修复启用PDF/A或PDF/UA兼容性后超链接断裂的问题。
- 修复了在某些机器上渲染某些
WebGL或JavaScript负载较重的URL时的崩溃或渲染失败问题。 - 修复转换包含超链接的文档时的PDF/UA验证。 (PDF/UA 7.18.5)
- 修复了在转换为PDF/A时的
System.AccessViolationException问题 - 修复替换文本以兼容使用灰度文本或路径的文档
- 改进替换文本行为,修复许多漏洞并改进文本格式
- 改善PDF/A超链接的内容描述。
- 在只支持单进程的只读环境中改进了行为,自动启用
Installation.SingleProcess
2023 年 12 月
IronPDF v2023.12.6
发布说明
- 添加新的字体API来添加、移除和使用字体! (see
PdfDocument.Fonts) - 添加新的注解API用来检索文档注解! (see
PdfDocument.Annotations) - 添加了对需要SHA-256或SHA-512的签名时间戳URL的支持(见
TimestampHashAlgorithms) - 添加通过HTML 'checked'属性设置的单选按钮值支持
- 修复了有时会损坏由第三方数字签名的文档的
ChangeTrackingModes) - 修复合并多个文档后某些PDF表单元素被破坏的漏洞
- 修复了使用
IronPdf遍历PDF页面时PDF页面索引不正确的错误 - 修复设置复选框表单值时的漏洞
- 修复在现有文档后面应用背景PDF时的漏洞
- 修复为具有各种不同页面大小的文档应用页眉和页脚时的漏洞
- 改善cookie行为 - 自定义cookie现在应该可以被整个URL域访问
- 改善IronPDF生成的复选框和单选按钮的视觉显示
2023年11月
IronPDF v2023.11.7
发布说明
- 添加新的自动生成目录! 查看
TableOfContents设置 - 添加新的方法来减小PDF大小! 查看
PdfDocument.Com/pressStructTree() - 添加了新的PDF表单字段API(参见
PdfDocument.Form) - 添加对HTML表单属性'只读'、'禁用'和'最大长度'的支持
- 添加了在将
RenderDocxMailMergeAsPdf()) - 修复文件路径包含特殊字符时的基本URL问题
- 修复了从
ASP.NETFramework呈现时的资产加载问题 - 修复在Adobe Reader中PDF/A抛出'无效色彩空间'的问题
- 修复从含有透明度的PDF生成图像时的问题
- 修复了调用
Flatten()后从PDF生成图像时的问题 - 修复在具有非US文化/字符串的机器上使用页眉页脚或HTML戳记时的问题
- 修复在同一个项目中使用多个Iron Software产品时的问题
- 修复在使用Docker托管IronPDF引擎时的各种问题和缺失功能
- 修复了将包含页眉和页脚的
DocX转换为PDF时的问题 - 修复在苹果硬件上托管的持久环境中运行IronPDF时的各种问题
2023 年 10 月
IronPDF v2023.10.3
发布说明
- 修复了若干小错误并提升了性能
2023 年 9 月
IronPDF v2023.9.8
发布说明
- 添加Word文档到PDF的转换! (see
DocxToPdfRenderer) - 在PDF文档中增加了对
EnableMathematicalLaTex) - 添加在从HTML字符串渲染时cookie的支持
- 为
IronPdf异步方法添加了对MacOS的支持 - 增加了对透明签名图像的支持
- 增加了对在Azure App Services中托管
IronPdf.Server.Azure) - 增加了通过Azure应用服务在iOS和Android上使用
IronPdf.Examplesrepo) - 修复了 MacOS 有时会导致连续渲染失败的错误
- 修复安装多个Iron Software产品时导致崩溃的bug
- 修复了阻止使用
Installation.ChromeGpuMode的错误 - 修复了在MAUI应用程序中运行
IronPdf时的问题 - 修复了使用gRPC服务时的杂项错误(
IronPdfDocker引擎) - 修复在合并文档时的内存泄漏
- 更改了cookie以针对每个独立渲染(参见
ChromePdfRenderOptions.CustomCookies) - 更改了HTML-to-PDF渲染的默认行为以使用单独的请求上下文(参见
IronPdf.Rendering.RequestContexts) - 改进了
IronPdfDocker引擎的稳定性 - 改善对MacOS的兼容性
- 改善对单进程模式的支持
- 改善了在MacOS上使用
IronPdffor Python时的路径检测 - 减小了
IronPdfDocker引擎的磁盘大小 - 将保存大型文档(>100MB)的时间缩短 90% 或更多
2023年8月
IronPDF v2023.8.6
发布说明
- 修复了某些情况下的"缺少
IronPdfInterop.dll"问题 - 修复了使用
ImportPages时的页面索引错误 - 修复导致程序在复制注释时挂起的bug
- 增加了在渲染前等待HTML元素加载的功能(参见'
WaitFor') - 增加了在渲染前等待字体加载的功能(参见'
WaitFor') - 添加在绘制文本时指定旋转的功能
- 添加在保存为PDFA时指定自定义颜色配置文件的功能
2023年7月
IronPDF v2023.7.4
发布说明
- 添加SVG转换功能: 这包括将PDF转换为SVG文件和SVG字符串的功能
- 添加HTML转换功能: 这包括将PDF转换为HTML文件和HTML字符串的功能
- 添加XMP元数据功能并改进现有设置元数据属性的API
- 增加PDF U/A支持: 参见
PdfDocument.SaveAsPdfUA() - 通过JavaScript方法增加HTML-to-PDF触发器: 参见
RenderingOptions.WaitFor() - 通过网络活动完成增加HTML-to-PDF触发器: 参见
RenderingOptions.WaitFor() - 增加了 Python 支持 (Python 3.7+):通过 'pip install IronPDF' 安装
- 修复了关于
IronPdf的连接问题 Docker镜像 - 修复图像 Stamper:图章 PNG 图像失去透明度
- 修复了
AnyBitmap时的异常 - 修复读取文本注释标题和内容
- 修复了一个罕见问题,即在非英语系统上无法验证许可证密钥
- 修复了
InsertPdf(),现在正确合并了表单字段和书签 - 使用HTML页眉和页脚时显著提高了性能
- 在将 HTML 呈现为 PDF 时减少内存使用量
- 在打开大型 PDF 文档时减少内存使用量
- 改进了一些Windows服务器版本(2016年及以后)的平台支持
- 更新至
IronSoftware.Drawing 2023.7.1,修复了图像编码和解码的各种错误
2023年6月
IronPDF v2023.6.10
发布说明
- 添加连续进纸选项,例如用于生成收据文档!
- 添加新的注释API,包括注释移除!
- 修复灰度选项未应用的问题
- 修复图像压缩功能损坏位图
- 修复在某些情况下添加、编辑或合并书签
- 修复签名有时在Adobe Reader签名面板中不可见
- 修复了
RasterizeToImageFiles未考虑页面旋转的问题 - 修复了条形码戳记在靠近页面边界时缩小的问题
- 修复IronPDFEngine Docker IP地址问题(现在监听0.0.0.0)
- 修复IronPDFEngine页眉和页脚不正常工作的问题
- 内存使用率和性能最多可提高 10
- 改进图像压缩逻辑,进一步优化尺寸
- 改进了内存不足错误消息,使其更加明显
- 删除
IronPdf.Rendering.Abstractions命名空间。 请改用ChromePdfRenderer类中的相同渲染方法
2023年5月
IronPDF v2023.5.8
发布说明
- 修复了在Linux上
IronPdf的错误处理和断点 - 修复了一些.NET Framework
ASP.NET项目中从web.co/nfig中无法检索许可证密钥的问题 - 修复了关于
System.Memory版本冲突的可能警告 - 添加了PDF/A-3B支持(看
ConvertToPdfA()) - 增加了删除文档元数据的支持(看
RemoveMetadataKey()) - 修复从流中打开文档时的错误
2023年4月
IronPDF v2023.4.4
发布说明
- 支持
ImageSharp2和ImageSharp3(参见<IronDrawingImageSharp版本>) - 支持容器化的客户端/服务器模型PDF生成(参见 IronPDFEngine Docker Images)
- 修复了某些无法从应用程序配置文件中读取许可证密钥的情况
- 修复了某些针对 .NET 4.6.2 - 4.8 的程序集引用缺失或不兼容的情况
2023 年 3 月
IronPDF v2023.3.2
发布说明
- 实现签名图像(参见
PdfSignatureImage) - 添加新的调整大小API,用于在保持纵横比的同时缩放页面尺寸
- 修复不同方向 PDF 上的印章和水印定位问题
- 修复当从包含超链接的PDF中检索表单字段时的异常
- 更新到CEF 110.0.31,带有许多安全和性能改进
2023年2月
IronPDF v2023.2.4
发布说明
- 支持IronPDFEngine Docker!
- 支持 PDF 增量保存
- 重构PDF 签名和签署
- 移除了对iText的依赖
- 修复了
DrawDividerLine在页眉/页脚中的错误 - 在文本页眉/页脚中添加了
DrawDividerLineColor - 将最低.NET Framework版本从4.0更改为4.6.2
- 修复了使用
ReplaceTextOnPage时的内存泄漏 - 更新
IronSoftware.System.Drawing至2023.2.12 - 修复将图像转换为PDF有时会导致图像不适合PDF文档的大小问题。
- 修正了一个问题,即在从 HTML 呈现 PDF 时,HTML 页眉和页脚文本中的文本换行无法正确断字。 以前,有些单词会在意想不到的地方断开,导致文本难以阅读或理解
- 修复了
ImageStamper功能中未正确读取相对路径的错误
2023年1月
IronPDF v2023.1.11416
发布说明
- 添加对在 HTML 渲染后执行自定义 JavaScript 的支持(请参见 JavaScript 属性)
- 修复对 Ubuntu 22 的支持
- 修复了使用ClickOnce发布方法时不包含
IronPdf文件的问题 - 修复了合并某些表单字段配置文件时的错误
- 磁盘缓存默认启用并设置为临时文件夹路径(参见
Installation.ChromeBrowserCachePath) - 弃用
FitPaperModes.Zoom - 在netstandard2.0项目中用
System.Drawing.Com/mon
-
AZURE V4 W/NET6.0无附加变量集 [下载链接]
ChromePdfRenderer renderer = new ChromePdfRenderer(); var doc = renderer.RenderUrlAsPdf("https://www.google.com/"); 返回 new FileContentResult(doc.BinaryData, "application/pdf") { FileDownloadName = "google.pdf" -
AZURE V4 W/NET6.0无附加变量集 [下载链接]
ChromePdfRenderer renderer = new ChromePdfRenderer(); var doc = renderer.RenderUrlAsPdf("https://www.google.com/"); 返回 new FileContentResult(doc.BinaryData, "application/pdf") { FileDownloadName = "google.pdf" - .NET发布net6.0目标平台win-x64
2022 年 12 月
IronPDF v2022.12.11113
发布说明
- 修复了作为Windows服务的一部分使用
IronPdf时的崩溃 - 修复了使用
IronPdf与Azure Functions时出错"无法部署IronPdf"(参见如何在Azure上使用.NET运行HTML到PDF) - 修复在现有 PDF 内容后面加盖 HTML 或图像时的行为
- 修复了缺少自定义日志接口的错误(
Logging.CustomLogger) - 修复了缺失的
AspxToPdf功能(仅适用于.NET 4) - 修复了即使
FitToPaperModes正确设置为None时仍被忽略的观察问题 - 添加了用于将ZIP文件呈现为PDF文档的
RenderZipFileAsPdf - 添加了
TextStamper - 更新至 Chrome 108.4.13 版,性能和安全性得到多项改进
- 更新各种第三方NuGet包以缓解漏洞
- 更新建议的Docker文件(参见将
IronPdf添加到现有Docker容器中) - 提升了不同Linux发行版和.NET版本之间
IronPdf部署的一致性 - 逐步改进本地代码的内存管理、稳定性和性能
2022年11月
IronPDF v2022.11.10347
发布说明
- 添加单选按钮表单元素,由 html "input "元素生成,"type "属性为 "radio"。
- 添加了RTF到PDF - 参见
RenderRtfStringAsPdf()获取更多信息 - 增加了多种替换文本的方法 - 参见
ReplaceTextOnAllPages() - 修复文本页眉和页脚不可见的问题
- 修复合并具有特定书签配置的文档时出现的错误
- 修复了调用
ApplyWatermark()时的错误 - 修复合并后表单域有时不可编辑的问题
- 修复带有"!重要 "样式的 HTML 元素的表单生成问题
- 修复了使用
ImageToPdf()时无法加载某些TIFF图像的问题 - 更新
ToMultiPageTiffImage()仅生成单个图像文件 - 更新NuGet包布局以提高在所有平台上的部署
- 更新了将页眉和页脚应用页边距的逻辑(现在默认只应用左侧和右侧页边距)
- 现在支持通过zip文件或安装程序可执行文件安装
IronPdf(参见[IronPdf登陆页面]())
2022年10月
IronPDF v2022.10.9622
发布说明
- [补丁] 修复了
TextStamper丢失
IronPDF v2022.10.9532
发布说明
- 添加HTML印章的新方法
- 添加了仅将左侧和右侧边距应用于页眉和页脚的选项(参见
UseMarginsOnHeaderAndFooter) - 弃用了
ApplyMarginToHeaderAndFooter - 纸张尺寸现在精确到0.00001毫米
- 使用
IronPdf创建的表单字段不再有蓝色边框 - 修复替换文本有时会中断页面布局的问题
- 改进了替换文本时决定使用哪种字体的逻辑(现在检查缺失的字形)
- 更新到CEF版本105.3.39
2022年9月
IronPDF v2022.9.9056
发布说明
- 修复了许可证密钥未从应用程序或Web配置文件中读取的问题
- 修复在Windows上缺少Microsoft Visual C++依赖项时的错误
- 修复导致表单垂直偏移几个像素的错误
- 修复了使用
VB.NET时的重复方法名称 - 添加支持在HTML转换为PDF时的表单复选框
2022年8月
IronPDF v2022.8.8138
发布说明
- 为PDF文档添加压缩功能。 参见
PdfDocument.Com/pressImages()获取更多信息 - 添加了在使用
ImageToPdfConverter时指定渲染选项的参数 - 删除了
PdfPage.PageRotation(PDF页面旋转为0, 90, 180或270) - 修复了其href属性指定参数的链接元素的渲染
- 修复了使用
LoadStylesAndCSSFromMainHtmlDocument选项时应用于页眉和页脚的文档CSS问题 - 修复在使用嵌套表单字段时设置和检索表单字段标志的问题
- 更新到最新的Pdfium,具有各种安全修复和性能改进
2022年7月
IronPDF v2022.8.7894
发布说明
- 添加了对Apple Silicon设备的支持(
MacOs在ARM处理器上) - 添加对Ubuntu 22的支持
- 添加了
IronPdf.Installation.ChromeBrowserCachePath - 添加了用于将图像绘制到PDF文档的
PdfDocument.DrawBitmap - 减少了由于水印导致的PDF文档文件大小增加(对没有
IronPdf许可证的用户) - 修复了有时渲染错误的单页应用程序和AJAX网站
- 修复合并PDF文档时"重命名表单字段错误"的问题
- 修复加载TIFF文件时有时抛出异常
- 修复了一些附件被损坏的问题
- 修复图像TOPdf不能处理文件名中含有空格的问题
- 修复了某些
FitToPaperModes无法正常工作的情况。 修复了一些无法打开的PDF文件 - 合并PDF文档现在能正确合并所有表单字段及其属性,包括嵌套的表单字段
- 改进了在某些环境中的.NET 6.0支持
- 改进了
HtmlStamp和水印定位
2022年6月
IronPDF v2022.7.6986
发布说明
- 为Azure Functions中.NET 6.0项目添加官方支持
- 实现合并PDF文档时的注释合并
- 实现了HTML内容自动适应PDF页面 - 参见
FitToPaperModes获取更多信息 TextAreaHTML元素现在在生成PDF文档时应包含其值- 大大提高了检索表单字段数据或操作表单字段时的性能
- 为表单字段添加了几个只读属性
- 修复了阻止设置表单字段值和使用其全名操作表单字段的错误
- 修复了在
MacOs上的若干冻结和性能问题 - 修复了向横向文档添加页眉和页脚时的错误
- 改进了在IIS应用程序池中使用多个实例时的行为
IronPdf - 改进了遇到罕见错误(如连接错误或超时)时的行为和清晰度
IronPDF v2022.6.6115
发布说明
- 添加了扩展的 PDF 书签 API
- 新增了 PDF 附件 API
- 增加了新的
Text替换API - 修复了在受限资源环境(如 Docker、Kubernetes 等)中多次渲染导致挂起的错误
- 修复了
PageOrientation返回错误值的错误 - 修复了插入页面时产生错误的错误
- 修复了将 PDF 转换为图像输出比率无效的错误
- 修复了重复表单字段未正确设置的错误
- 修复了页眉/页脚占位符不起作用的错误
- 修复了应用
HtmlHeaderFooter时的内存泄漏问题 - 改进了在用户指定的浏览器限制达到后排队多次渲染的逻辑
- 改进了部署过程
- 改进了一些错误信息
- 更新到最新的 Pdfium 版本,其中包括操作现有 PDF 文档时的修复
- 更新到最新的 Chrome 版本,其中包括在将 HTML 渲染为 PDF 时的修复和安全更新
2022年5月
IronPDF v2022.5.5596
发布说明
- 修复了
HtmlStamp定位无法正常工作的错误 - 修复了
AddBackground错误地添加到前景中的错误 - 修复了
EnableCookies未按预期工作的错误 - 修复了在编辑PDF文档期间导致
ArgumentNullException的错误 - 实现了对
ChromePdfRenderer异常的处理,无需重启 - 改进了文档(
IntelliSense)
2022年4月
IronPDF v2022.4.5575
发布说明
- 支持 .NET 6
- 修复了用户 cookies 未在渲染 URL 时自动应用的错误
- 修复了在 Windows 上将 pdf 文档转换为图像时,导致的间歇性 GDI+ 异常
- 修复了某些系统在初始化和部署时导致的间歇性挂起错误
- 修复了导致pdf文档的
PrintHeight属性计算错误的错误 - 修复了导致
HtmlFooter有时在页脚下方额外添加5 mm边距的错误 - 修复了 DPI 参数未增加从 pdf 文档生成的图像分辨率的错误
- 修复了页眉和页脚 CSS 样式不起作用的错误
- 修复了在设置 pdf 安全设置时书签会消失的错误
- 修复了
ArgumentNullException的错误 - 修复了
IronPdf无法在某些发布配置文件下发布时运行的错误 - 修复了
DrawDividerLine不支持HTML页眉和页脚的错误 - 修复了临时文件未被清理的问题
- 实施了在Windows上使用
IronPdf时的Microsoft Visual C++可再发行组件检查 - 实现了改进的逻辑,从而在 pdf 文档上渲染 html 页眉和页脚
IronPDF v2022.4.5455
发布说明
- 修复了更改用户密码、所有者密码或权限时会删除书签的错误
- 修复了合并 pdf 文档时无法保留书签的错误
- 修复了若干与设置或检索书签相关的其他错误
- 修复了PDF页面的
PrintWidth计算错误 - 修复了从 PDF 文档生成图像时可能导致崩溃的错误
- 修复了生成 PDF 文档的页眉和页脚时错误应用渲染延迟的错误
- 修复了不使用
IDisposable模式时的内存泄漏 - 改进了修改 PDF 文档时的线程安全性
- 改进了在无法打开 PDF 文档时的错误文本
- 更新了 pdf 转图像转换,以索引 1 开始页面
2022年3月
IronPDF v2022.3.5084
发布说明
- 修复了在使用 .NET 6 时 PNG 图像未正确加载的错误
- 修复了许可证标识无法点击的错误
- 改进了对某些 Linux 发行版的兼容性
- 改进了整体稳定性
- 改进了多线程支持
- 更新到最新的 Pdfium 版本
2022年2月
IronPDF v2022.2.4887
发布说明
- 修复了某些图像未正确加载的错误
- 修复了在
ChromeRender中使用cookie时不正常工作的错误 - 修复了在使用
RenderHtmlAsPdf时UNC路径中的图像不正常工作的错误 - 修复了页眉和页脚 HTML 样式应用中的错误
- 修复了多线程渲染在某些系统上会损坏文档的错误
- 改进了 macOS 稳定性
- 提高了总体稳定性和性能
- 新API - 用于在使用
ImageToPdfConverter.PaperSize
2022年1月
IronPDF v2022.1.4599
发布说明
- 修复了某些系统上的初始化超时问题
- 修复了某些 SSL 证书的使用问题
- 改进了使用自定义临时文件夹时的逻辑
- 改进了关闭/清理逻辑
2021年12月
IronPDF v2021.12.4495
发布说明
- 修复了在禁用 JavaScript 时页眉和页脚无法正确渲染的错误
- 修复了使用
GetPrintDocument()打印文档时的内存问题 - 修复了使用
HtmlToPdf类时未正确应用渲染选项的错误 - 修复了可能错误抛出"子进程不可执行"异常的错误
- 修复了可能错误抛出"此平台不支持注册表"异常的错误
- 改进了部署逻辑以确保使用已下载依赖项的正确版本(适用于使用
IronPdf.SlimNuGet包时) - 将默认渲染超时从 30 秒更新为 60 秒
- 更新
StampHTML()方法,允许用户指定用于html戳的渲染选项
IronPDF v2021.12.4401
发布说明
- 为PDF文档添加压缩功能。 参见
PdfDocument.Com/pressImages()获取更多信息 - 添加了在使用
ImageToPdfConverter时指定渲染选项的参数 - 删除了
PdfPage.PageRotation(PDF页面旋转为0, 90, 180或270) - 修复了其href属性指定参数的链接元素的渲染
- 修复了使用
LoadStylesAndCSSFromMainHtmlDocument选项时应用于页眉和页脚的文档CSS问题 - 修复在使用嵌套表单字段时设置和检索表单字段标志的问题
- 更新到最新的Pdfium,具有各种安全修复和性能改进
2021年11月
IronPDF v2021.11.4257
发布说明
- 新增Chrome、
WebKit和Adaptive Rendering到IronPdf - 像素完美的 Chrome HTML 到 PDF 渲染
- 完整的多线程和异步支持
- 添加了 Razor 和 MVC 助手
- 添加了
ChromePdfRenderer类 - 添加了
WebKitPdfRenderer类 - 添加了
AdaptivePdfRenderer类 - Chrome渲染器取代
HtmlToPdf引擎。HTML、CSS和JS的渲染更准确,这可能导致现有用户的布局变化 - 次要 API 变化

