Wir freuen uns, die Veröffentlichung von GroupDocs.Viewer for Python 26.9 bekannt zu geben, verfügbar seit September 2026. Dieses Release aktualisiert die zugrunde liegende GroupDocs.Viewer‑Engine von 26.4 auf 26.8, fügt die Unterstützung für die Darstellung von Microsoft‑Project‑Dateien unter Linux und macOS hinzu, führt Seitenzahlen‑ und Auflösungs‑Steuerungen für Word‑Dokumente ein, entfernt die libgdiplus‑Abhängigkeit auf Nicht‑Windows‑Plattformen und stellt die Kompatibilität mit Python 3.5–3.7 wieder her. Das eingebettete .NET‑Runtime wurde auf 10.0.12 aktualisiert, und die Python‑API enthält nun vollständige Docstrings mit Code‑Beispielen.

Was ist neu in diesem Release

  • [Feature] WordProcessingOptions.page_number_location und das Enum WordsPageNumberLocation hinzufügen, um Seitenzahlen auf gerenderten Word‑Dokumenten zu stempeln (VIEWERPYTHON-153)
  • [Feature] WordProcessingOptions.horizontal_resolution / vertical_resolution hinzufügen, um die DPI von PNG‑ und JPEG‑Ausgabe für Word‑Dokumente festzulegen (VIEWERPYTHON-154)
  • [Feature] Unterstützung für die Darstellung von Microsoft‑Project‑Dateien (MPP, MPT, MPX) unter Linux und macOS hinzufügen (VIEWERPYTHON-155)
  • [Enhancement] GroupDocs.Viewer‑Engine von 26.4 auf 26.8 aktualisieren (VIEWERPYTHON-156)
  • [Enhancement] Eingebettete .NET‑Runtime von 10.0.0 auf 10.0.12 aktualisieren (VIEWERPYTHON-157)
  • [Enhancement] Die Anforderung von libgdiplus / mono-libgdiplus unter Linux und macOS entfernen (VIEWERPYTHON-158)
  • [Enhancement] Auf allen Plattformen dieselbe Python‑API bereitstellen — die Linux‑ und macOS‑Pakete erhalten ProjectManagementOptions sowie die FileType‑Mitglieder für Project, Photoshop, Illustrator und OneNote (VIEWERPYTHON-159)
  • [Enhancement] Docstrings mit Zusammenfassungen, Parametern und Code‑Beispielen zur Python‑API hinzufügen (VIEWERPYTHON-160)
  • [Enhancement] Einen Abschnitt „Developer Guide“ zur API‑Referenz hinzufügen (VIEWERPYTHON-161)
  • [Fix] Das Paket kann nicht mit Python 3.5 – 3.7 verwendet werden (VIEWERPYTHON-162)
  • [Fix] pip installiert das Paket auf Linux‑ und macOS‑Versionen, die es nicht ausführen können (VIEWERPYTHON-163)

Public API changes

Es wird nichts entfernt oder umbenannt.

Neue Typen

Typ Modul Beschreibung
WordsPageNumberLocation groupdocs.viewer.options Gibt an, wo Seitenzahlen auf einem gerenderten Word‑Dokument gestempelt werden: NOT_APPLY (Standard), TOP_LEFT, TOP_CENTER, TOP_RIGHT, BOTTOM_LEFT, BOTTOM_CENTER, BOTTOM_RIGHT

Neue Member in bestehenden Klassen

Klasse Member Beschreibung
WordProcessingOptions page_number_location Seitenzahlen, die beim Rendern angewendet werden (WordsPageNumberLocation)
WordProcessingOptions horizontal_resolution Horizontale DPI der PNG / JPEG‑Ausgabe, 72 – 600 (Standard 96)
WordProcessingOptions vertical_resolution Vertikale DPI der PNG / JPEG‑Ausgabe, 72 – 600 (Standard 96)

Neu unter Linux und macOS

ProjectManagementOptions, BaseViewOptions.project_management_options sowie FileType.MPP, MPT, MPX, PSD, PSB, AI, ONE waren bereits unter Windows verfügbar und sind nun auch in den Linux‑ und macOS‑Paketen enthalten — siehe Eine Python‑API auf jeder Plattform.

Neue Funktionen

Microsoft‑Project‑Dateien unter Linux und macOS

MPP-, MPT‑ und MPX‑Dateien konnten bisher nur unter Windows gerendert werden; unter Linux und macOS schlugen sie mit Failed to detect file type fehl. Die Engine 26.8 rendert sie auf jeder Plattform mit denselben ProjectManagementOptions wie unter Windows:

from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions, TimeUnit

with Viewer("project.mpp") as viewer:
    options = HtmlViewOptions.for_embedded_resources("page_{0}.html")
    options.project_management_options.time_unit = TimeUnit.DAYS
    viewer.view(options)

Unter Linux muss zuerst das Microsoft‑Core‑Fonts‑Paket (ttf-mscorefonts-installer) installiert werden: Ohne diese schlägt die Projekt‑Darstellung mit Cannot find fallback font 'Generic Sans Serif' fehl, und metrisch kompatible Ersatzschriften wie Liberation erfüllen die Suche nicht.

Seitenzahlen auf gerenderten Word‑Dokumenten

WordProcessingOptions.page_number_location stempelt beim Rendern Seitenzahlen auf ein Word‑Dokument, selbst wenn das Dokument selbst keine enthält. Wählen Sie eine der sechs Positionen aus dem neuen Enum WordsPageNumberLocation; der Standardwert NOT_APPLY lässt das Dokument unverändert.

from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, WordsPageNumberLocation

with Viewer("document.docx") as viewer:
    options = PdfViewOptions("output.pdf")
    options.word_processing_options.page_number_location = WordsPageNumberLocation.BOTTOM_CENTER
    viewer.view(options)

Auflösung der PNG‑ und JPEG‑Ausgabe für Word‑Dokumente

WordProcessingOptions.horizontal_resolution und vertical_resolution legen die DPI der aus Word‑Dokumenten gerenderten Bilder fest. Der Standardwert ist 96 DPI; Werte außerhalb des Bereichs 72 – 600 DPI werden auf diesen Bereich begrenzt.

from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

with Viewer("document.docx") as viewer:
    options = PngViewOptions("page_{0}.png")
    options.word_processing_options.horizontal_resolution = 300
    options.word_processing_options.vertical_resolution = 300
    viewer.view(options)

Keine libgdiplus mehr

Die Linux‑ und macOS‑Pakete rendern über SkiaSharp und Aspose.Drawing, die im Wheel enthalten sind. Sie rufen niemals libgdiplus auf: jedes dokumentierte Beispiel läuft in einem Linux‑Container, der weder libgdiplus noch dessen Grafik‑Abhängigkeiten enthält. Entfernen Sie libgdiplus / mono-libgdiplus aus Ihren Images und Bereitstellungsskripten.

Eine Python‑API auf jeder Plattform

Frühere Linux‑ und macOS‑Pakete boten eine kleinere API als das Windows‑Paket. Version 26.9 liefert überall dieselbe API, sodass Code, der gemäß der Dokumentation geschrieben wurde, auf jeder Plattform importierbar ist. Die Linux‑ und macOS‑Pakete erhalten ProjectManagementOptions und die FileType.MPP, MPT und MPX‑Mitglieder, die dort nun ebenfalls funktionieren.

Zusätzlich erhalten sie FileType.PSD, PSB, AI und ONE. Diese Formate bleiben Windows‑exklusiv; ein Zugriff auf eines dieser Mitglieder unter Linux oder macOS löst GroupDocsViewerException: Member 'GroupDocs.Viewer.FileType.PSD' not found. aus. Um zur Laufzeit zu prüfen, ob ein Format gerendert werden kann, verwenden Sie FileType.get_supported_file_types(), das nur die vom laufenden Engine unterstützten Formate auflistet:

from groupdocs.viewer import FileType

supported = {file_type.extension for file_type in FileType.get_supported_file_types()}
print(".psd" in supported)   # True unter Windows, False unter Linux und macOS
print(".mpp" in supported)   # True überall

Code‑Beispiel

Um eine Microsoft‑Project‑Datei unter Linux oder macOS mit täglichen Zeiteinheiten zu rendern:

from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions, TimeUnit

with Viewer("project.mpp") as viewer:
    options = HtmlViewOptions.for_embedded_resources("page_{0}.html")
    options.project_management_options.time_unit = TimeUnit.DAYS
    viewer.view(options)

Um Seitenzahlen zu einem Word‑Dokument hinzuzufügen und als PDF zu rendern:

from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, WordsPageNumberLocation

with Viewer("document.docx") as viewer:
    options = PdfViewOptions("output.pdf")
    options.word_processing_options.page_number_location = WordsPageNumberLocation.BOTTOM_CENTER
    viewer.view(options)

Wie Sie das Update erhalten

PyPI

Aktualisieren Sie das Paket über PyPI:

pip install groupdocs-viewer-net==26.9.0

Direkter Download

Laden Sie die Wheel‑Dateien für alle Plattformen von der Seite GroupDocs.Viewer for Python via .NET 26.9 herunter: https://releases.groupdocs.com/viewer/python-net/

Ressourcen