אנו שמחים להודיע על שחרור GroupDocs.Signature for Python v26.10, זמין החל מאוקטובר 2026. גרסה מרכזית זו מעדכנת את מנוע GroupDocs.Signature הבסיסי מ‑25.12 ל‑26.9 ומעבירה את זמן הריצה המוטמע של .NET מ‑.NET Core 3.1 ל‑.NET 10.0.12. היא מציגה קריאות חוזרות בסגנון Python עבור זרמי תצוגה מקדימה, רישום, הצפנת נתונים ותמיכה ב‑hash חתימה מותאם, מוסיפה תאימות מלאה ל‑Python 3.14, ופותרת בעיות ייבוא קריטיות ב‑Linux. גרסה זו כוללת שני תכונות מרכזיות, חמש שיפורים ושתי תיקוני באגים.

מה חדש בגרסה זו

  • [Feature] קבלה של פונקציות Python כקריאות חוזרות לתצוגה מקדימה של דף וחתימה (SIGNATUREPYTHON-21)
  • [Feature] קבלה של אובייקטים Python כמימושים של ILogger, IDataEncryption ו‑ICustomSignHash (SIGNATUREPYTHON-22)
  • [Feature] הוספת תמיכה ב‑Python 3.14 (SIGNATUREPYTHON-23)
  • [Enhancement] עדכון מנוע GroupDocs.Signature מ‑25.12 ל‑26.9 (SIGNATUREPYTHON-24)
  • [Enhancement] עדכון זמן הריצה המוטמע של .NET מ‑.NET Core 3.1 ל‑.NET 10.0.12 (SIGNATUREPYTHON-25)
  • [Enhancement] הקפת GroupDocsSignatureException, IncorrectPasswordException ו‑PasswordRequiredException במקום RuntimeError (SIGNATUREPYTHON-26)
  • [Enhancement] הקפת AttributeError כאשר קוד מנסה להקצות תכונה שהמחלקה אינה מכילה (SIGNATUREPYTHON-27)
  • [Enhancement] שינוי שם של חברים שהשמות ב‑Python מחלקים מילים של .NET (z_order → zorder, x_ad_es_type → xad_es_type) (SIGNATUREPYTHON-28)
  • [Enhancement] בחירת עומסים לפי תוכן של רשימה, והעברת ערכי datetime ו‑Decimal ל‑.NET ללא שינוי (SIGNATUREPYTHON-29)
  • [Enhancement] עדכון תגיות פלטפורמה של חבילת wheel ל‑manylinux_2_27 ו‑macosx_12_0, והסרת חבילת Windows 32‑bit (SIGNATUREPYTHON-30)
  • [Fix] חבילת ה‑Linux לא ניתנת לייבוא על הפצות נוכחיות (SIGNATUREPYTHON-31)
  • [Fix] GROUPDOCS_LIC_PATH מתעלם (SIGNATUREPYTHON-32)

שינויים ב‑API הציבורי

מעדכנים צריכים להתאים את עצמם לחברים ששונו שמם, לסוגי החריגים החדשים ולתגיות הפלטפורמה המעודכנות. הקצאת תכונות כעת מייצרת AttributeError והקריאות החוזרות יכולות להיות פונקציות Python רגילות.

מחלקות וחברים חדשים

  • 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: בונה (constructor); לא היה קיים לפני כן.
  • PreviewSignatureOptions: בונה (constructor); לא היה קיים לפני כן.
  • SearchResult: get_enumerator(), to_list().
  • Signature: dispose().
  • SignatureSettings: default_culture.
  • WordProcessingSaveOptions: ooxml_compliance.

שונה שם

מחלקה שם ישן שם חדש
BarcodeTypes DATA_LOGIC_2OF_5 DATA_LOGIC_2OF5
BarcodeTypes GS1_CODE_128 GS1_CODE128
BarcodeTypes GS1_MICRO_PDF_417 GS1_MICRO_PDF417
BarcodeTypes IATA2OF_5 IATA2OF5
BarcodeTypes INTERLEAVED_2OF_5 INTERLEAVED_2OF5
BarcodeTypes MATRIX_2OF_5 MATRIX_2OF5
BarcodeTypes STANDARD_2OF_5 STANDARD_2OF5
BarcodeTypes UPCA_GS_1_CODE_128_COUPON UPCA_GS1_CODE_128_COUPON
BarcodeTypes UPCA_GS_1_DATABAR_COUPON UPCA_GS1_DATABAR_COUPON
DigitalSignature x_ad_es_type xad_es_type
FileType G_ZIP GZIP
FileType L_ZIP LZIP
XAdESType X_AD_ES XAD_ES
DigitalSignOptions x_ad_es_type xad_es_type
JpegCompressionColorMode Y_CB_CR YCB_CR
SignOptions z_order zorder
PdfTextAnnotationAppearance h_corner_radius hcorner_radius
PdfTextAnnotationAppearance v_corner_radius vcorner_radius

תכונות חדשות

יצירת תצוגה מקדימה עם קריאות חוזרות של Python

PreviewOptions ניתן כעת לבנות עם פונקציות Python רגילות. קריאת ה‑create מקבלת אובייקט page_data וחייבת להחזיר זרם כתיבה (אובייקט קובץ או io.BytesIO). קריאת ה‑release מתבצעת לאחר שהתמונה נכתבה ומקבלת את אותו page_data והזרם.

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

אובייקטים של Python כמחוללי לוג, הצפנה וקריאות חוזרות של hash מותאם

אובייקטים של Python יכולים כעת לממש את הממשקים ILogger, IDataEncryption, ו‑ICustomSignHash. ניתן להעביר אובייקט לוג עם שיטות trace, warning ו‑error ל‑SignatureSettings. אובייקט הצפנה עם שיטות encode ו‑decode ניתן לשייך ל‑options.data_encryption ב‑QR‑code או בחתימות מטא‑דטה. חותם hash מותאם יכול להיות פונקציה או אובייקט עם שיטת custom_sign_hash ומשמש ב‑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)

תמיכה ב‑Python 3.14

חבילת ה‑wheel כעת מציינת python_requires=">=3.5,<3.15" וחבילה יחידה לכל פלטפורמה מכסה את Python 3.5 – 3.14. אין צורך בשינויים בקוד; הייבוא והשימוש זהים במפרש החדש.

דוגמת קוד

ראו את הסעיף “תכונות חדשות” למעלה לקבלת דוגמאות קוד עובדות המדגימות קריאות חוזרות של Python ליצירת תצוגה מקדימה ולמימושי לוג/הצפנה מותאמים.

איך לקבל את העדכון

PyPI

שדרגו לחבילה העדכנית ביותר של GroupDocs.Signature for Python דרך PyPI: groupdocs-signature-net 26.10.0

התקינו באמצעות:

pip install groupdocs-signature-net==26.10.0

הורדה ישירה

הורידו את חבילות ה‑wheel ישירות מ-דף השחרור של GroupDocs.Signature for Python v26.10.

משאבים