Jsme rádi, že můžeme oznámit vydání GroupDocs.Viewer for Python 26.9, dostupné od září 2026. Toto vydání aktualizuje podkladový engine GroupDocs.Viewer z 26.4 na 26.8, přidává podporu pro vykreslování souborů Microsoft Project na Linuxu a macOS, zavádí číslování stránek a ovládání rozlišení pro dokumenty Word, odstraňuje závislost libgdiplus na ne‑Windows platformách a obnovuje kompatibilitu s Python 3.5–3.7. Vložené .NET runtime je aktualizováno na 10.0.12 a Python API nyní obsahuje úplné docstringy s ukázkami kódu.

Co je nového v tomto vydání

  • [Feature] Přidat WordProcessingOptions.page_number_location a výčtový typ WordsPageNumberLocation pro razítkování čísel stránek ve vykreslených dokumentech Word (VIEWERPYTHON-153)
  • [Feature] Přidat WordProcessingOptions.horizontal_resolution / vertical_resolution pro nastavení DPI výstupu PNG a JPEG pro dokumenty Word (VIEWERPYTHON-154)
  • [Feature] Přidat podporu pro vykreslování souborů Microsoft Project (MPP, MPT, MPX) na Linuxu a macOS (VIEWERPYTHON-155)
  • [Enhancement] Aktualizovat engine GroupDocs.Viewer z 26.4 na 26.8 (VIEWERPYTHON-156)
  • [Enhancement] Aktualizovat vložené .NET runtime z 10.0.0 na 10.0.12 (VIEWERPYTHON-157)
  • [Enhancement] Odstranit požadavek libgdiplus / mono-libgdiplus na Linuxu a macOS (VIEWERPYTHON-158)
  • [Enhancement] Poskytnout stejné Python API na všech platformách — balíčky pro Linux a macOS získají ProjectManagementOptions a členy FileType pro Project, Photoshop, Illustrator a OneNote (VIEWERPYTHON-159)
  • [Enhancement] Přidat docstringy s přehledy, parametry a ukázkami kódu do Python API (VIEWERPYTHON-160)
  • [Enhancement] Přidat sekci Průvodce vývojáře do referenčního API (VIEWERPYTHON-161)
  • [Fix] Nelze použít balíček na Python 3.5 – 3.7 (VIEWERPYTHON-162)
  • [Fix] pip nainstaluje balíček na verze Linuxu a macOS, které jej nemohou spustit (VIEWERPYTHON-163)

Změny veřejného API

Nic není odstraněno ani přejmenováno.

Nové typy

Typ Modul Popis
WordsPageNumberLocation groupdocs.viewer.options Kde razítkovat čísla stránek ve vykresleném dokumentu Word: NOT_APPLY (výchozí), TOP_LEFT, TOP_CENTER, TOP_RIGHT, BOTTOM_LEFT, BOTTOM_CENTER, BOTTOM_RIGHT

Nové členy existujících tříd

Třída Člen Popis
WordProcessingOptions page_number_location Číslování stránek, které se použije při vykreslování (WordsPageNumberLocation)
WordProcessingOptions horizontal_resolution Horizontální DPI výstupu PNG / JPEG, 72 – 600 (výchozí 96)
WordProcessingOptions vertical_resolution Vertikální DPI výstupu PNG / JPEG, 72 – 600 (výchozí 96)

Novinky pro Linux a macOS

ProjectManagementOptions, BaseViewOptions.project_management_options a FileType.MPP, MPT, MPX, PSD, PSB, AI, ONE byly již k dispozici na Windows a nyní jsou také v balíčcích pro Linux a macOS — viz One Python API on every platform.

Nové funkce

Soubory Microsoft Project na Linuxu a macOS

Soubory MPP, MPT a MPX se dříve vykreslovaly pouze na Windows; na Linuxu a macOS selhaly s chybou Failed to detect file type. Engine 26.8 je vykresluje na všech platformách se stejnými ProjectManagementOptions jako na 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)

Na Linuxu nejprve nainstalujte Microsoft core fonts (ttf-mscorefonts-installer): bez nich selže vykreslování projektu s chybou Cannot find fallback font 'Generic Sans Serif' a metrické kompatibilní náhrady jako Liberation tuto kontrolu nesplňují.

Čísla stránek ve vykreslených dokumentech Word

WordProcessingOptions.page_number_location razítkuje čísla stránek do dokumentu Word během vykreslování, i když dokument žádná čísla neobsahuje. Vyberte jednu ze šesti pozic z nového výčtu WordsPageNumberLocation; výchozí hodnota NOT_APPLY ponechá dokument beze změny.

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)

Rozlišení výstupu PNG a JPEG pro dokumenty Word

WordProcessingOptions.horizontal_resolution a vertical_resolution nastavují DPI obrázků vykreslených z dokumentů Word. Výchozí hodnota je 96 DPI; hodnoty mimo rozsah 72 – 600 DPI jsou oříznuty na tento rozsah.

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)

Už žádný libgdiplus

Balíčky pro Linux a macOS vykreslují pomocí SkiaSharp a Aspose.Drawing, které jsou součástí wheelu. Nikdy nevolají libgdiplus: každý dokumentovaný příklad běží v Linux kontejneru, který nemá ani libgdiplus, ani jeho grafické závislosti. Odstraňte libgdiplus / mono-libgdiplus ze svých obrazů a skriptů pro nasazení.

Jedno Python API na každé platformě

Starší balíčky pro Linux a macOS poskytovaly menší API než Windows verze. 26.9 nabízí stejné API všude, takže kód napsaný podle dokumentace lze importovat na každé platformě. Balíčky pro Linux a macOS získávají ProjectManagementOptions a členy FileType.MPP, MPT a MPX, které nyní fungují i tam.

Také získávají FileType.PSD, PSB, AI a ONE. Tyto formáty zůstávají pouze pro Windows a na Linuxu a macOS přístup k některému z těchto členů vyvolá GroupDocsViewerException: Member 'GroupDocs.Viewer.FileType.PSD' not found. Pro rozhodnutí za běhu, zda lze formát vykreslit, zkontrolujte FileType.get_supported_file_types(), který uvádí jen to, co aktuální engine vykresluje:

from groupdocs.viewer import FileType

supported = {file_type.extension for file_type in FileType.get_supported_file_types()}
print(".psd" in supported)   # True on Windows, False on Linux and macOS
print(".mpp" in supported)   # True everywhere

Příklad kódu

Pro vykreslení souboru Microsoft Project na Linuxu nebo macOS s denními časovými jednotkami:

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)

Pro aplikaci číslování stránek do dokumentu Word a vykreslení do PDF:

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)

Jak získat aktualizaci

PyPI

Aktualizujte na nejnovější balíček přes PyPI:

pip install groupdocs-viewer-net==26.9.0

Přímé stažení

Stáhněte soubory wheel pro všechny platformy ze stránky GroupDocs.Viewer pro Python přes .NET 26.9 .

Zdroje