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_locationund das EnumWordsPageNumberLocationhinzufügen, um Seitenzahlen auf gerenderten Word‑Dokumenten zu stempeln (VIEWERPYTHON-153) - [Feature]
WordProcessingOptions.horizontal_resolution/vertical_resolutionhinzufü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-libgdiplusunter Linux und macOS entfernen (VIEWERPYTHON-158) - [Enhancement] Auf allen Plattformen dieselbe Python‑API bereitstellen — die Linux‑ und macOS‑Pakete erhalten
ProjectManagementOptionssowie dieFileType‑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]
pipinstalliert 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/