Nos complace anunciar el lanzamiento de GroupDocs.Viewer for Python 26.9, disponible a partir de septiembre de 2026. Esta versión actualiza el motor subyacente de GroupDocs.Viewer de la versión 26.4 a la 26.8, añade soporte para renderizar archivos Microsoft Project en Linux y macOS, introduce controles de numeración de páginas y resolución para documentos Word, elimina la dependencia libgdiplus en plataformas que no son Windows y restaura la compatibilidad con Python 3.5–3.7. El runtime .NET incrustado se actualiza a la versión 10.0.12, y la API de Python ahora incluye docstrings completos con ejemplos de código.
Novedades en esta versión
- [Feature] Añadir
WordProcessingOptions.page_number_locationy el enumeradoWordsPageNumberLocationpara estampar números de página en documentos Word renderizados (VIEWERPYTHON-153) - [Feature] Añadir
WordProcessingOptions.horizontal_resolution/vertical_resolutionpara establecer el DPI de la salida PNG y JPEG de documentos Word (VIEWERPYTHON-154) - [Feature] Añadir soporte para renderizar archivos Microsoft Project (MPP, MPT, MPX) en Linux y macOS (VIEWERPYTHON-155)
- [Enhancement] Actualizar el motor GroupDocs.Viewer de la versión 26.4 a la 26.8 (VIEWERPYTHON-156)
- [Enhancement] Actualizar el runtime .NET incrustado de la versión 10.0.0 a la 10.0.12 (VIEWERPYTHON-157)
- [Enhancement] Eliminar el requisito
libgdiplus/mono-libgdiplusen Linux y macOS (VIEWERPYTHON-158) - [Enhancement] Distribuir la misma API de Python en todas las plataformas: los paquetes de Linux y macOS incorporan
ProjectManagementOptionsy los miembrosFileTypede Project, Photoshop, Illustrator y OneNote (VIEWERPYTHON-159) - [Enhancement] Añadir docstrings con resúmenes, parámetros y ejemplos de código a la API de Python (VIEWERPYTHON-160)
- [Enhancement] Añadir una sección de Guía del Desarrollador a la referencia de la API (VIEWERPYTHON-161)
- [Fix] No se puede usar el paquete en Python 3.5‑3.7 (VIEWERPYTHON-162)
- [Fix]
pipinstala el paquete en versiones de Linux y macOS que no pueden ejecutarlo (VIEWERPYTHON-163)
Cambios en la API pública
No se elimina ni se renombra nada.
Nuevos tipos
| Tipo | Módulo | Descripción |
|---|---|---|
WordsPageNumberLocation |
groupdocs.viewer.options |
Dónde estampar los números de página en un documento Word renderizado: NOT_APPLY (predeterminado), TOP_LEFT, TOP_CENTER, TOP_RIGHT, BOTTOM_LEFT, BOTTOM_CENTER, BOTTOM_RIGHT |
Nuevos miembros en clases existentes
| Clase | Miembro | Descripción |
|---|---|---|
WordProcessingOptions |
page_number_location |
Numeración de página a aplicar durante la renderización (WordsPageNumberLocation) |
WordProcessingOptions |
horizontal_resolution |
DPI horizontal de la salida PNG / JPEG, 72 – 600 (predeterminado 96) |
WordProcessingOptions |
vertical_resolution |
DPI vertical de la salida PNG / JPEG, 72 – 600 (predeterminado 96) |
Nuevas características en Linux y macOS
ProjectManagementOptions, BaseViewOptions.project_management_options y FileType.MPP, MPT, MPX, PSD, PSB, AI, ONE ya estaban disponibles en Windows y ahora también forman parte de los paquetes de Linux y macOS — vea Una API de Python en todas las plataformas.
Nuevas funcionalidades
Archivos Microsoft Project en Linux y macOS
Los archivos MPP, MPT y MPX solo se podían renderizar en Windows; en Linux y macOS fallaban con Failed to detect file type. El motor 26.8 los renderiza en cualquier plataforma, con el mismo ProjectManagementOptions que en 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)
En Linux, instale primero las fuentes Microsoft core (ttf-mscorefonts-installer): sin ellas la renderización del proyecto falla con Cannot find fallback font 'Generic Sans Serif', y los sustitutos compatibles métricamente como Liberation no satisfacen esa búsqueda.
Números de página en documentos Word renderizados
WordProcessingOptions.page_number_location estampa números de página en un documento Word mientras se renderiza, incluso si el documento no los contiene. Elija una de las seis posiciones del nuevo enumerado WordsPageNumberLocation; el valor predeterminado, NOT_APPLY, deja el documento tal como está.
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)
Resolución de la salida PNG y JPEG para documentos Word
WordProcessingOptions.horizontal_resolution y vertical_resolution establecen el DPI de las imágenes generadas a partir de documentos Word. El valor predeterminado es 96 DPI; los valores fuera del rango 72 – 600 DPI se ajustan a ese intervalo.
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)
Ya no más libgdiplus
Los paquetes de Linux y macOS renderizan mediante SkiaSharp y Aspose.Drawing, que se incluyen dentro de la rueda. Nunca llaman a libgdiplus: cada ejemplo documentado se ejecuta en un contenedor Linux que no tiene ni libgdiplus ni sus dependencias gráficas. Elimine libgdiplus / mono-libgdiplus de sus imágenes y scripts de aprovisionamiento.
Una API de Python en todas las plataformas
Los paquetes anteriores de Linux y macOS ofrecían una API más reducida que la de Windows. La versión 26.9 distribuye la misma API en todas partes, de modo que el código escrito según la documentación se importa en cualquier plataforma. Los paquetes de Linux y macOS añaden ProjectManagementOptions y los miembros FileType.MPP, MPT y MPX, que ahora también funcionan allí.
También se añaden FileType.PSD, PSB, AI y ONE. esos formatos siguen siendo exclusivos de Windows, y en Linux y macOS acceder a uno de esos miembros genera GroupDocsViewerException: Member 'GroupDocs.Viewer.FileType.PSD' not found. Para decidir en tiempo de ejecución si un formato puede renderizarse, consulte FileType.get_supported_file_types(), que enumera solo lo que el motor en ejecución soporta:
from groupdocs.viewer import FileType
supported = {file_type.extension for file_type in FileType.get_supported_file_types()}
print(".psd" in supported) # True en Windows, False en Linux y macOS
print(".mpp" in supported) # True en todas partes
Ejemplo de código
Para renderizar un archivo Microsoft Project en Linux o macOS con unidades de tiempo diarias:
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)
Para aplicar numeración de páginas a un documento Word y renderizarlo a 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)
Cómo obtener la actualización
PyPI
Actualice al paquete más reciente a través de PyPI:
pip install groupdocs-viewer-net==26.9.0
Descarga directa
Descargue los archivos wheel para todas las plataformas desde la página GroupDocs.Viewer for Python via .NET 26.9.