Nous sommes heureux d’annoncer la sortie de GroupDocs.Viewer for Python 26.9, disponible depuis septembre 2026. Cette version met à jour le moteur sous‑jacent GroupDocs.Viewer de la version 26.4 à 26.8, ajoute la prise en charge du rendu des fichiers Microsoft Project sous Linux et macOS, introduit la numérotation des pages et le contrôle de la résolution pour les documents Word, supprime la dépendance libgdiplus sur les plateformes non Windows, et restaure la compatibilité avec Python 3.5–3.7. Le runtime .NET intégré est mis à jour vers la version 10.0.12, et l’API Python inclut désormais des docstrings complètes avec des exemples de code.

Nouveautés de cette version

  • [Feature] Ajouter WordProcessingOptions.page_number_location et l’énumération WordsPageNumberLocation pour apposer des numéros de page sur les documents Word rendus (VIEWERPYTHON-153)
  • [Feature] Ajouter WordProcessingOptions.horizontal_resolution / vertical_resolution pour définir le DPI des sorties PNG et JPEG des documents Word (VIEWERPYTHON-154)
  • [Feature] Ajouter la prise en charge du rendu des fichiers Microsoft Project (MPP, MPT, MPX) sous Linux et macOS (VIEWERPYTHON-155)
  • [Enhancement] Mettre à jour le moteur GroupDocs.Viewer de la version 26.4 à 26.8 (VIEWERPYTHON-156)
  • [Enhancement] Mettre à jour le runtime .NET intégré de la version 10.0.0 à 10.0.12 (VIEWERPYTHON-157)
  • [Enhancement] Supprimer l’exigence libgdiplus / mono-libgdiplus sous Linux et macOS (VIEWERPYTHON-158)
  • [Enhancement] Distribuer la même API Python sur toutes les plateformes — les packages Linux et macOS gagnent ProjectManagementOptions ainsi que les membres FileType Project, Photoshop, Illustrator et OneNote (VIEWERPYTHON-159)
  • [Enhancement] Ajouter des docstrings avec résumés, paramètres et exemples de code à l’API Python (VIEWERPYTHON-160)
  • [Enhancement] Ajouter une section Guide du développeur à la référence API (VIEWERPYTHON-161)
  • [Fix] Impossible d’utiliser le package sur Python 3.5 – 3.7 (VIEWERPYTHON-162)
  • [Fix] pip installe le package sur des versions Linux et macOS qui ne peuvent pas l’exécuter (VIEWERPYTHON-163)

Modifications de l’API publique

Rien n’est supprimé ou renommé.

Nouveaux types

Type Module Description
WordsPageNumberLocation groupdocs.viewer.options Où apposer les numéros de page sur un document Word rendu : NOT_APPLY (par défaut), TOP_LEFT, TOP_CENTER, TOP_RIGHT, BOTTOM_LEFT, BOTTOM_CENTER, BOTTOM_RIGHT

Nouveaux membres des classes existantes

Classe Membre Description
WordProcessingOptions page_number_location Numérotation des pages à appliquer lors du rendu (WordsPageNumberLocation)
WordProcessingOptions horizontal_resolution DPI horizontal de la sortie PNG / JPEG, 72 – 600 (96 par défaut)
WordProcessingOptions vertical_resolution DPI vertical de la sortie PNG / JPEG, 72 – 600 (96 par défaut)

Nouveautés sur Linux et macOS

ProjectManagementOptions, BaseViewOptions.project_management_options et FileType.MPP, MPT, MPX, PSD, PSB, AI, ONE étaient déjà disponibles sous Windows et le sont maintenant également dans les packages Linux et macOS — voir One Python API on every platform.

Nouvelles fonctionnalités

Fichiers Microsoft Project sur Linux et macOS

Les fichiers MPP, MPT et MPX ne pouvaient être rendus que sous Windows ; sous Linux et macOS ils échouaient avec Failed to detect file type. Le moteur 26.8 les rend sur toutes les plateformes, avec les mêmes ProjectManagementOptions que sous 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)

Sous Linux, installez d’abord les polices Microsoft core (ttf-mscorefonts-installer) : sans elles le rendu du projet échoue avec Cannot find fallback font 'Generic Sans Serif', et les substituts métriquement compatibles comme Liberation ne satisfont pas cette recherche.

Numéros de page sur les documents Word rendus

WordProcessingOptions.page_number_location appose des numéros de page sur un document Word pendant le rendu, même si le document n’en contient aucun. Choisissez l’une des six positions de la nouvelle énumération WordsPageNumberLocation ; la valeur par défaut, NOT_APPLY, laisse le document tel quel.

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)

Résolution de la sortie PNG et JPEG pour les documents Word

WordProcessingOptions.horizontal_resolution et vertical_resolution définissent le DPI des images rendues à partir de documents Word. La valeur par défaut est 96 DPI ; les valeurs en dehors de la plage 72 – 600 DPI sont limitées à cette plage.

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)

Plus de libgdiplus

Les packages Linux et macOS rendent via SkiaSharp et Aspose.Drawing, qui sont inclus dans la roue. Ils n’appellent jamais libgdiplus : chaque exemple documenté s’exécute dans un conteneur Linux qui ne possède ni libgdiplus ni ses dépendances graphiques. Supprimez libgdiplus / mono-libgdiplus de vos images et scripts de provisionnement.

Une API Python unique sur chaque plateforme

Les packages Linux et macOS exposaient auparavant une API plus restreinte que celle de Windows. La version 26.9 fournit la même API partout, de sorte que le code écrit d’après la documentation s’importe sur chaque plateforme. Les packages Linux et macOS gagnent ProjectManagementOptions ainsi que les membres FileType.MPP, MPT et MPX, qui fonctionnent désormais également là‑bas.

Ils gagnent également FileType.PSD, PSB, AI et ONE. Ces formats restent réservés à Windows, et sous Linux et macOS l’accès à l’un de ces membres lève GroupDocsViewerException: Member 'GroupDocs.Viewer.FileType.PSD' not found. Pour déterminer à l’exécution si un format peut être rendu, utilisez FileType.get_supported_file_types(), qui ne répertorie que les formats rendus par le moteur en cours d’exécution :

from groupdocs.viewer import FileType

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

Exemple de code

Pour rendre un fichier Microsoft Project sous Linux ou macOS avec des unités de temps quotidiennes :

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)

Pour appliquer la numérotation des pages à un document Word et le rendre en 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)

Comment obtenir la mise à jour

PyPI

Mettez à jour vers le dernier package via PyPI :

pip install groupdocs-viewer-net==26.9.0

Téléchargement direct

Téléchargez les fichiers wheel pour toutes les plateformes depuis la page GroupDocs.Viewer for Python via .NET 26.9 .

Ressources