GroupDocs.Signature for Python 26.10 – Sorotan Rilis Oktober 2026

Kami dengan senang hati mengumumkan rilis GroupDocs.Signature for Python v26.10, tersedia sejak Oktober 2026. Rilis utama ini meningkatkan mesin GroupDocs.Signature yang mendasarinya dari 25.12 ke 26.9 dan memigrasikan runtime .NET yang disematkan dari .NET Core 3.1 ke .NET 10.0.12. Rilis ini memperkenalkan callback gaya Python untuk alur pratinjau, logger, enkripsi data, dan dukungan hash tanda tangan khusus, menambahkan kompatibilitas penuh dengan Python 3.14, serta menyelesaikan masalah impor kritis pada Linux. Rilis ini mencakup dua fitur utama, lima peningkatan, dan dua perbaikan bug.

Apa yang baru dalam rilis ini

• [Feature] Menerima fungsi Python sebagai callback pratinjau halaman dan tanda tangan (SIGNATUREPYTHON-21)
• [Feature] Menerima objek Python sebagai implementasi ILogger, IDataEncryption, dan ICustomSignHash (SIGNATUREPYTHON-22)
• [Feature] Menambahkan dukungan untuk Python 3.14 (SIGNATUREPYTHON-23)
• [Enhancement] Memperbarui mesin GroupDocs.Signature dari 25.12 ke 26.9 (SIGNATUREPYTHON-24)
• [Enhancement] Memperbarui runtime .NET yang disematkan dari .NET Core 3.1 ke .NET 10.0.12 (SIGNATUREPYTHON-25)
• [Enhancement] Melempar GroupDocsSignatureException, IncorrectPasswordException, dan PasswordRequiredException alih-alih RuntimeError (SIGNATUREPYTHON-26)
• [Enhancement] Melempar AttributeError ketika kode menetapkan atribut yang tidak dimiliki kelas (SIGNATUREPYTHON-27)
• [Enhancement] Mengganti nama anggota yang nama Python‑nya memisahkan kata‑kata .NET (z_order → zorder, x_ad_es_type → xad_es_type) (SIGNATUREPYTHON-28)
• [Enhancement] Memilih overload berdasarkan isi daftar, dan meneruskan nilai datetime serta Decimal ke .NET tanpa perubahan (SIGNATUREPYTHON-29)
• [Enhancement] Memperbarui tag platform wheel ke manylinux_2_27 dan macosx_12_0, serta menghapus wheel Windows 32‑bit (SIGNATUREPYTHON-30)
• [Fix] Wheel Linux tidak dapat diimpor pada distribusi saat ini (SIGNATUREPYTHON-31)
• [Fix] GROUPDOCS_LIC_PATH diabaikan (SIGNATUREPYTHON-32)

Perubahan API Publik

Pengguna yang melakukan upgrade perlu menyesuaikan diri dengan anggota yang telah diganti nama, tipe pengecualian baru, dan tag platform yang diperbarui. Penetapan atribut kini melempar AttributeError dan callback dapat berupa callable Python biasa.

Kelas dan anggota baru

• groupdocs.signature: ProcessCompleteEventHandler, ProcessProgressEventHandler, ProcessStartEventHandler.
• groupdocs.signature.domain: OoxmlCompliance.
• groupdocs.signature.options: CreateSignatureStream, ReleaseSignatureStream, PreviewOptions.CreateDocPageStream, PreviewOptions.ReleaseDocPageStream, PreviewOptions.PreviewFormats, PreviewSignatureOptions.PreviewFormats.
• ConsoleLogger: error().
• DigitalSignOptions: allow_expired, allow_not_yet_valid.
• DigitalSignature: certificate_store_location, certificate_store_name.
• FileLogger: error().
• ILogger: error().
• ImageSignOptions: dispose().
• LoadOptions: skip_external_resources, whitelisted_resources.
• Mailmark2D: class_.
• MetadataSignatureCollection: append(), get().
• PreviewOptions: sebuah konstruktor; sebelumnya tidak ada.
• PreviewSignatureOptions: sebuah konstruktor; sebelumnya tidak ada.
• SearchResult: get_enumerator(), to_list().
• Signature: dispose().
• SignatureSettings: default_culture.
• WordProcessingSaveOptions: ooxml_compliance.

Nama yang Diubah

Fitur baru

Pembuatan pratinjau dengan callback Python

PreviewOptions kini dapat dibuat dengan fungsi Python biasa. Callback create menerima objek page_data dan harus mengembalikan stream yang dapat ditulis (objek file atau io.BytesIO). Callback release dipanggil setelah gambar ditulis dan menerima page_data serta stream yang sama.

from groupdocs.signature import Signature
from groupdocs.signature.options import PreviewOptions

def create_page_stream(page_data):
    return open(f"page-{page_data.page_number}.png", "wb")

def release_page_stream(page_data, page_stream):
    page_stream.close()

with Signature("document.pdf") as signature:
    signature.generate_preview(PreviewOptions(create_page_stream, release_page_stream))

Objek Python sebagai logger, enkripsi, dan callback hash khusus

Objek Python biasa kini dapat mengimplementasikan antarmuka ILogger, IDataEncryption, dan ICustomSignHash. Objek logger dengan metode trace, warning, dan error dapat diberikan ke SignatureSettings. Objek enkripsi dengan metode encode dan decode dapat ditetapkan ke options.data_encryption pada tanda tangan QR‑code atau metadata. Penandatangan hash khusus dapat berupa fungsi atau objek dengan metode custom_sign_hash dan digunakan oleh DigitalSignOptions.custom_sign_hash.

import base64

from groupdocs.signature import Signature, SignatureSettings
from groupdocs.signature.options import QrCodeSignOptions


class SimpleLogger:
    def trace(self, message):
        print("TRACE:", message)

    def warning(self, message):
        print("WARN:", message)

    def error(self, message, exception=None):
        print("ERROR:", message, exception)


class Base64Encryption:
    def encode(self, source):
        return base64.b64encode(source.encode()).decode()

    def decode(self, source):
        return base64.b64decode(source).decode()


options = QrCodeSignOptions("Private text")
options.data_encryption = Base64Encryption()

with Signature("document.pdf", SignatureSettings(logger=SimpleLogger())) as signature:
    signature.sign("signed.pdf", options)

Dukungan untuk Python 3.14

Wheel kini mendeklarasikan python_requires=">=3.5,<3.15" dan satu wheel per platform mencakup Python 3.5 – 3.14. Tidak ada perubahan kode yang diperlukan; impor dan penggunaan yang sama berfungsi pada interpreter yang lebih baru.

Contoh kode

Lihat bagian “Fitur baru” di atas untuk contoh kode yang berfungsi, yang memperlihatkan callback Python untuk pembuatan pratinjau serta implementasi logger/enkripsi khusus.

Cara mendapatkan pembaruan

PyPI

Tingkatkan ke paket GroupDocs.Signature for Python terbaru melalui PyPI: groupdocs-signature-net 26.10.0

Instal dengan:

pip install groupdocs-signature-net==26.10.0

Unduhan langsung

Unduh paket wheel secara langsung dari halaman rilis GroupDocs.Signature for Python v26.10.

Sumber daya

• Catatan Rilis Lengkap
• Dokumentasi
• Free Support Forum