GroupDocs.Conversion for Python 26.9 – Điểm nổi bật bản phát hành tháng 9 2026

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.

Những gì mới trong bản phát hành này

• [Tính năng] Thêm hỗ trợ ConversionEvents để quan sát bắt đầu, tiến độ, hoàn thành từng trang và từng tài liệu, lỗi và thay thế phông chữ (CONVERSIONPYTHON-93)
• [Tính năng] Thêm hỗ trợ các định dạng mới — kho lưu trữ XAR, sơ đồ draw.io và sơ đồ Mermaid (.mmd) (CONVERSIONPYTHON-94)
• [Tính năng] Thêm CadLoadOptions.layout_scope để giới hạn chuyển đổi CAD chỉ trong không gian mô hình, bố cục không gian giấy, hoặc cả hai (CONVERSIONPYTHON-95)
• [Tính năng] Thêm MarkdownOptions.image_saving_callback để kiểm soát nơi lưu các hình ảnh được trích xuất vào Markdown (CONVERSIONPYTHON-96)
• [Tính năng] Thêm EmailLoadOptions.page_layout_options và WebLoadOptions.margin_settings / orientation_settings / size_settings (CONVERSIONPYTHON-97)
• [Tính năng] Thêm ImageConvertOptions.min_resolution và cap_resolution_to_page_content (CONVERSIONPYTHON-98)
• [Tính năng] Thêm WordProcessingLoadOptions.auto_detect_rtl_direction (CONVERSIONPYTHON-99)
• [Tính năng] Thêm MissingDependencyException để thông báo lỗi rõ ràng hơn khi một phụ thuộc tùy chọn của engine bị thiếu (CONVERSIONPYTHON-100)
• [Cải tiến] Cập nhật engine GroupDocs.Conversion từ 26.3 lên 26.8 (CONVERSIONPYTHON-101)
• [Cải tiến] Xóa mô-đun trùng lặp groupdocs.conversion.file_types — sử dụng groupdocs.conversion.filetypes (CONVERSIONPYTHON-102)
• [Cải tiến] Đổi tên PdfOptions.remove_pdf_acompliance thành remove_pdf_a_compliance (CONVERSIONPYTHON-103)
• [Cải tiến] Thêm mục Hướng dẫn dành cho Nhà phát triển và các trang groupdocs.conversion.integration.* vào tài liệu tham chiếu API (CONVERSIONPYTHON-104)
• [Sửa lỗi] Không thể import mô-đun khi dùng Python 3.5 – 3.7 (CONVERSIONPYTHON-91)
• [Sửa lỗi] Lỗi thời gian chạy khi truyền đối số Enum trong các phiên bản Python 3.8 – 3.10 (CONVERSIONPYTHON-92)
• [Sửa lỗi] Thuộc tính item của *DocumentInfo và PossibleConversions là một property và không thể gọi được (CONVERSIONPYTHON-105)
• [Sửa lỗi] Các thuộc tính kiểu delegate không thể gán từ Python (Object must implement IConvertible) (CONVERSIONPYTHON-106)
• [Sửa lỗi] Các thuộc tính kiểu delegate được chú thích sai kiểu trong stub và docstring (CONVERSIONPYTHON-107)

Thay đổi API công cộng

Các lớp mới

Thành viên mới trên các lớp hiện có

• FluentConverter.with_events(...), và tương tự trên IConversionFrom và IConversionSettings
• Converter(...) — bốn overload khởi tạo mới chấp nhận một 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

Đã xóa — groupdocs.conversion.file_types

Mô-đun groupdocs.conversion.file_types và 23 lớp của nó đã bị xóa. Các lớp này không bị xóa — mỗi lớp vẫn tồn tại, không thay đổi, trong groupdocs.conversion.filetypes.

Nếu bạn đã nhập từ đó, hãy thay đổi lệnh import — không cần gì khác:

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

Đã đổi tên — PdfOptions.remove_pdf_acompliance

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

Các tính năng mới

Sự kiện chuyển đổi

ConversionEvents cho phép bạn quan sát quá trình chuyển đổi khi nó đang chạy — tiến độ, hoàn thành từng trang và từng tài liệu, lỗi, và thay thế phông chữ. Gắn các hàm Python thông thường:

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

Lưu ý hàm khởi tạo nhận (path, settings, events) — không có overload (path, events), vì vậy hãy truyền một ConverterSettings() ngay cả khi bạn không cần cấu hình gì.

Các hook có sẵn là on_conversion_started, on_conversion_progress, on_conversion_completed, on_document_converted, on_document_failed, on_page_converted, on_page_failed, on_compression_completed và on_font_substituted.

Định dạng mới

Phạm vi bố cục CAD

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

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

BOTH là mặc định và không hạn chế việc chuyển đổi.

Ví dụ mã

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

Cách nhận bản cập nhật

PyPI

pip install groupdocs-conversion-net==26.9.0

Tải trực tiếp

Tải về từ trang GroupDocs.Conversion for Python via .NET 26.9 .

Tài nguyên

• Ghi chú phát hành đầy đủ
• Trang sản phẩm
• Tài liệu
• Tham chiếu API
• Ví dụ mã
• Diễn đàn hỗ trợ miễn phí