GroupDocs.Conversion for Python 26.9 – 2026年9月 發行亮點

We’re happy to announce the release of GroupDocs.Conversion for Python v26.9, available as of September 2026. This release upgrades the underlying GroupDocs.Conversion engine from 26.3 to 26.8, introduces the ConversionEvents API for real‑time conversion monitoring, adds support for XAR archives, draw.io, and Mermaid diagrams, and includes several new load and convert options. It also resolves critical compatibility issues on Python 3.5–3.10 and fixes longstanding defects affecting delegate‑typed properties and enum arguments.

What’s new in this release

• [Feature] 新增對 ConversionEvents 的支援，以觀察開始、進度、每頁與每文件的完成、失敗以及字型替換 (CONVERSIONPYTHON-93)
• [Feature] 新增對新格式的支援 — XAR 壓縮檔、draw.io 圖表與 Mermaid (.mmd) 圖表 (CONVERSIONPYTHON-94)
• [Feature] 新增 CadLoadOptions.layout_scope，可將 CAD 轉換限制為模型空間、紙張佈局或兩者皆可 (CONVERSIONPYTHON-95)
• [Feature] 新增 MarkdownOptions.image_saving_callback，可控制 Markdown 中提取的圖像寫入位置 (CONVERSIONPYTHON-96)
• [Feature] 新增 EmailLoadOptions.page_layout_options 以及 WebLoadOptions.margin_settings / orientation_settings / size_settings (CONVERSIONPYTHON-97)
• [Feature] 新增 ImageConvertOptions.min_resolution 與 cap_resolution_to_page_content (CONVERSIONPYTHON-98)
• [Feature] 新增 WordProcessingLoadOptions.auto_detect_rtl_direction (CONVERSIONPYTHON-99)
• [Feature] 新增 MissingDependencyException，在缺少可選引擎相依性時提供更清晰的失敗訊息 (CONVERSIONPYTHON-100)
• [Enhancement] 將 GroupDocs.Conversion 引擎從 26.3 更新至 26.8 (CONVERSIONPYTHON-101)
• [Enhancement] 移除重複的 groupdocs.conversion.file_types 模組 — 改用 groupdocs.conversion.filetypes (CONVERSIONPYTHON-102)
• [Enhancement] 將 PdfOptions.remove_pdf_acompliance 重新命名為 remove_pdf_a_compliance (CONVERSIONPYTHON-103)
• [Enhancement] 新增開發者指南章節與 groupdocs.conversion.integration.* 頁面至 API 參考 (CONVERSIONPYTHON-104)
• [Fix] 在 Python 3.5 – 3.7 中無法匯入模組的問題已修復 (CONVERSIONPYTHON-91)
• [Fix] 在 Python 3.8 – 3.10 中傳遞 Enum 參數時的執行時錯誤已修復 (CONVERSIONPYTHON-92)
• [Fix] *DocumentInfo 與 PossibleConversions 上的索引器 item 為屬性，不能被呼叫的問題已修復 (CONVERSIONPYTHON-105)
• [Fix] Delegate 類型屬性無法從 Python 指派（Object must implement IConvertible）的問題已修復 (CONVERSIONPYTHON-106)
• [Fix] Delegate 類型屬性在 stub 與 docstring 中被標註為錯誤類型的問題已修復 (CONVERSIONPYTHON-107)

Public API changes

新增類別

現有類別的新成員

• FluentConverter.with_events(...)，以及在 IConversionFrom 與 IConversionSettings 上的相同方法
• Converter(...) — 四個接受 ConversionEvents 的新建構子重載
• CadLoadOptions.layout_scope
• EmailLoadOptions.page_layout_options
• WebLoadOptions.margin_settings、.orientation_settings、.size_settings
• MarkdownOptions.image_saving_callback
• ImageConvertOptions.min_resolution、.cap_resolution_to_page_content
• WordProcessingLoadOptions.auto_detect_rtl_direction
• CompressionFileType.XAR、DiagramFileType.DRAWIO、DiagramFileType.MMD

移除 — groupdocs.conversion.file_types

groupdocs.conversion.file_types 模組及其 23 個類別已被移除。類別本身並未移除 — 它們仍然以未變更的形式存在於 groupdocs.conversion.filetypes 中。

如果您從該模組匯入，請改為從新模組匯入，其他不需變更：

# before
from groupdocs.conversion.file_types import WordProcessingFileType
# after
from groupdocs.conversion.filetypes import WordProcessingFileType

重新命名 — PdfOptions.remove_pdf_acompliance

# before
options.remove_pdf_acompliance = True
# after
options.remove_pdf_a_compliance = True

新功能

轉換事件

ConversionEvents 讓您在轉換執行期間觀察進度、每頁與每文件的完成、失敗以及字型替換。只需掛接普通的 Python 函式：

from groupdocs.conversion import ConversionEvents, Converter, ConverterSettings
from groupdocs.conversion.options.convert import PdfConvertOptions

events = ConversionEvents()
events.on_conversion_started = lambda: print("started")
events.on_conversion_progress = lambda percent: print(f"{percent}%")
events.on_document_converted = lambda ctx: print("document done")
events.on_font_substituted = lambda ctx: print(
    f"{ctx.original_font_name} -> {ctx.substitute_font_name} ({ctx.reason})")
events.on_conversion_completed = lambda: print("completed")

with Converter("business-plan.docx", ConverterSettings(), events) as converter:
    converter.convert("business-plan.pdf", PdfConvertOptions())

請注意建構子接受 (path, settings, events) — 沒有僅 (path, events) 的重載，因此即使不需要設定，也請傳入 ConverterSettings()。

可用的掛鉤包括 on_conversion_started、on_conversion_progress、on_conversion_completed、on_document_converted、on_document_failed、on_page_converted、on_page_failed、on_compression_completed 與 on_font_substituted。

新增格式

CAD 版面範圍

from groupdocs.conversion.options.load import CadLayoutScope, CadLoadOptions

load_options = CadLoadOptions()
load_options.layout_scope = CadLayoutScope.MODEL     # MODEL | LAYOUTS | BOTH

BOTH 為預設值，表示不限制轉換範圍。

程式碼範例

from groupdocs.conversion import ConversionEvents, Converter, ConverterSettings
from groupdocs.conversion.options.convert import PdfConvertOptions

events = ConversionEvents()
events.on_conversion_started = lambda: print("started")
events.on_conversion_progress = lambda percent: print(f"{percent}%")
events.on_document_converted = lambda ctx: print("document done")
events.on_font_substituted = lambda ctx: print(
    f"{ctx.original_font_name} -> {ctx.substitute_font_name} ({ctx.reason})")
events.on_conversion_completed = lambda: print("completed")

with Converter("business-plan.docx", ConverterSettings(), events) as converter:
    converter.convert("business-plan.pdf", PdfConvertOptions())

如何取得更新

PyPI

pip install groupdocs-conversion-net==26.9.0

直接下載

從 GroupDocs.Conversion for Python via .NET 26.9 頁面下載。

資源

• Full Release Notes
• Product Page
• Documentation
• API Reference
• Code Examples
• Free Support Forum