我們很高興宣布 GroupDocs.Redaction for Python v26.11 已於 2026 年 11 月 發佈。此版本將 GroupDocs.Redaction 引擎從 26.5 升級至 26.10,並嵌入 .NET runtime 10.0.15,將 System.Drawing 替換為 Aspose.Drawing 與 SkiaSharp,以支援跨平台光柵化與影像區域遮蔽——包括 Linux 與 macOS。新功能包括頁面預覽、Python 日誌支援、Python OCR 連接器整合、Word 文件的 OOXML 合規性控制、明確的檔案類型載入,以及授權狀態檢查。
此版本的新功能
- [Feature] 新增對檔案和
io.BytesIO的頁面預覽支援(PreviewOptions、generate_preview()) (REDACTIONPYTHONNET-23) - [Feature] 新增對 Python 日誌(
ILogger)的支援 (REDACTIONPYTHONNET-24) - [Feature] 新增對 Python OCR 連接器(
IOcrConnector)以在影像中遮蔽文字的支援 (REDACTIONPYTHONNET-25) - [Feature] 新增設定已儲存 Word 文件之 OOXML 合規等級(
ooxml_compliance)的支援 (REDACTIONPYTHONNET-26) - [Feature] 新增以指定檔案類型開啟文件的支援(
LoadOptions.file_type) (REDACTIONPYTHONNET-27) - [Feature] 新增檢查授權是否已套用(
License.is_licensed)的支援 (REDACTIONPYTHONNET-28) - [Enhancement] 將 GroupDocs.Redaction 更新至 26.10,並將嵌入的執行環境升級至 .NET 10.0.15 (REDACTIONPYTHONNET-29)
- [Enhancement] 將
groupdocs.pydrawing類型取代為groupdocs.redaction.options.drawing(Color、Point、Size、Rectangle、Font、FontStyle) (REDACTIONPYTHONNET-30) - [Enhancement] 在遮蔽回呼的描述中返回
RedactionType與RedactionActionType列舉 (REDACTIONPYTHONNET-31) - [Enhancement] 當未知屬性被指派給 API 物件時拋出
AttributeError(REDACTIONPYTHONNET-32) - [Enhancement] 對無法套用的授權拋出
LicenseError,並從groupdocs.redaction匯出它與GroupDocsRedactionException(REDACTIONPYTHONNET-33) - [Enhancement] 從共享的
groupdocs-shared-net套件安裝groupdocs.pydrawing與groupdocs.pycore(REDACTIONPYTHONNET-34) - [Fix] 修復 26.6.0 中的 CVE 問題:.NET runtime 10.0.0 → 10.0.15(另加 2 項) (REDACTIONPYTHONNET-12)
- [Fix] 在 Linux 與 macOS 上,光柵化 PDF 輸出與影像區域遮蔽會拋出
PlatformNotSupportedException(REDACTIONPYTHONNET-35) - [Fix] 當文字包含制表符時,遮蔽回呼會因
JSONDecodeError失敗 (REDACTIONPYTHONNET-36) - [Fix]
RedactorSettings在僅傳入遮蔽回呼作為唯一參數時拋出TypeError(REDACTIONPYTHONNET-37) - [Fix] 在 Linux 與 macOS 上安裝 Wheels 時,嵌入的 .NET runtime 無法執行 (REDACTIONPYTHONNET-38)
公開 API 變更
升級者需要從 groupdocs.redaction.options.drawing 匯入顏色與幾何類型,並將遮蔽回呼的 redaction_type 與 action_type 與列舉成員進行比較。其他皆為新增項目。
新增類別與成員
groupdocs.redaction:CancellationToken,CancellationTokenSource,OperationCanceledError,LicenseError,LicenseWarning,GroupDocsRedactionException.groupdocs.redaction.options:WordProcessingComplianceLevel,WordprocessingSaveOptions.groupdocs.redaction.options.drawing:Color,Font,FontStyle,Point,Rectangle,Size.FileType:DJVU,LOG,OTP,POTM,POTX,PPS,PPSM,PPSX,PPTM,TAB,WEBP,XLT,XLTM,XLTX.License:is_licensed.LoadOptions:file_type.SaveOptions:wordprocessing_save_options.
groupdocs.redaction.options.drawing 是新模組。GroupDocsRedactionException 仍然由 groupdocs.redaction.exceptions 匯出。
已移除
groupdocs.pydrawing 所重新匯出的顏色已被移除;請改從 groupdocs.redaction.options.drawing 匯入 Color:
groupdocs.redaction.Colorgroupdocs.redaction.redactions.Color
已變更
- 所有接受或返回顏色、點、尺寸或矩形的成員皆使用
groupdocs.redaction.options.drawing類型。groupdocs.pydrawing的值會拋出TypeError(無匹配的重載)。 RedactionDescription.redaction_type與action_type(遮蔽回呼會讀取)為RedactionType與RedactionActionType成員。- 引擎的過時別名仍然存在:
ReplacementOptions.box_fill_color、RegionReplacementOptions.area_fill_color與area_size、ImageAreaRedaction.top_left_position、PageAreaFilter.area_rectangle與TextFragment.bounding_rectangle。請使用box_color、fill_color、size、top_left與rectangle。
新功能
頁面預覽
Redactor.generate_preview() 會將文件頁面渲染為影像。PreviewOptions 接受一個函式,為每頁返回一個串流、開啟的二進位檔案或 io.BytesIO,並可選擇第二個函式以釋放每頁的串流。設定 width、height 與 page_numbers。26.6.0 會因 TypeError 拒絕此 Python 函式。
Python 日誌
RedactorSettings(logger=...) 接受一個具備 error(message)、warning(message) 與 trace(message) 方法的物件,並由引擎透過它回報。26.6.0 會因 TypeError 拒絕此 Python 日誌。
Python OCR 連接器
GroupDocs.Redaction 不隨附 OCR 引擎。RedactorSettings(ocr_connector=...) 接受一個具備 recognize(image_stream) 方法的物件,該方法返回 OCR 引擎偵測到的結果:包含 TextLine 的 RecognizedImage,每個 TextLine 包含 TextFragment,其文字與矩形。引擎會在影像中尋找相應片語並覆蓋。將每行文字報告為一個 TextFragment。26.6.0 會因 TypeError 拒絕此 Python 連接器。
已儲存 Word 文件的 OOXML 合規等級
SaveOptions.wordprocessing_save_options.ooxml_compliance 設定已儲存 Word 文件的 OOXML 合規等級:WordProcessingComplianceLevel.ECMA、TRANSITIONAL 或 STRICT。若未設定,文件將保留原有等級。26.6.0 並未提供此功能。
以指定檔案類型開啟文件
LoadOptions(file_type) 會將串流或檔名未指示格式的檔案,以指定的 FileType 開啟。26.6.0 並未提供此功能。
檢查授權是否已套用
一旦授權已套用(使用 License().set_license() 或透過 GROUPDOCS_LIC_PATH 環境變數),License().is_licensed 會返回 True。
程式碼範例
import io
from groupdocs.redaction import Redactor
from groupdocs.redaction.options import PreviewOptions, PreviewFormats
pages = {}
def create_page_stream(page_number):
pages[page_number] = io.BytesIO()
return pages[page_number]
with Redactor("document.pdf") as redactor:
options = PreviewOptions(create_page_stream)
options.width, options.height = 300, 400
options.page_numbers = [1]
options.preview_format = PreviewFormats.PNG
redactor.generate_preview(options)
print(len(pages[1].getvalue()), "bytes of PNG")
如何取得更新
PyPI
透過 PyPI 升級:
安裝指令:
pip install groupdocs-redaction-net==26.11.0
直接下載
從以下位置下載適用於您平台的 wheel:
- GroupDocs.Redaction for Python via .NET 26.11 – Windows
- GroupDocs.Redaction for Python via .NET 26.11 – Linux
- GroupDocs.Redaction for Python via .NET 26.11 – macOS Intel
- GroupDocs.Redaction for Python via .NET 26.11 – macOS Apple Silicon