Instalación

De qué trata esta página

Instalar Aspose.Slides para Python a través de Java en Windows, Linux o macOS, configurar Java y JPype, y verificar la configuración con un ejemplo funcional.

Aspose.Slides para Python a través de Java se ejecuta en Windows, Linux y macOS. Utiliza JPype para acceder a la biblioteca Java desde Python. Microsoft PowerPoint no es necesario.

Requisitos previos

Antes de instalar los paquetes de Python, instale Python y un JDK que cumplan los Requisitos del sistema. Esa página enumera las versiones compatibles, los requisitos de arquitectura y cualquier dependencia necesaria para compilar JPype desde el código fuente.

Establezca JAVA_HOME al directorio de instalación del JDK, no a su subdirectorio bin, y añada el directorio bin del JDK a PATH. Abra una nueva terminal después de modificar las variables de entorno.

Instalar desde PyPI

Ejecute los siguientes comandos en una terminal, no en el indicador interactivo de Python. Cree un directorio de proyecto y un entorno virtual para mantener los paquetes aislados de otros proyectos.

Windows

Con el intérprete de Python que haya elegido disponible como python en PATH, ejecute los siguientes comandos en el Símbolo del sistema:

mkdir slides-example
cd slides-example
python -m venv .venv
.venv\Scripts\activate.bat

Linux y macOS

Con la versión de Python que haya elegido disponible como python3, ejecute los siguientes comandos en Bash o zsh:

mkdir slides-example
cd slides-example
python3 -m venv .venv
source .venv/bin/activate

En Debian o Ubuntu, si la creación del entorno falla porque ensurepip no está disponible, instale el paquete python3-venv con sudo apt-get install python3-venv, y luego repita el comando de creación del entorno. Una versión de Python instalada por separado puede necesitar su paquete venv correspondiente a esa versión.

Instalar los paquetes

Con el entorno virtual activo, instale JPype y Aspose.Slides:

python -m pip install --upgrade pip
python -m pip install JPype1 aspose-slides-java

Usar python -m pip garantiza que los paquetes se instalen para el intérprete usado al ejecutar su aplicación.

Para actualizar una instalación existente de Aspose.Slides, ejecute python -m pip install --upgrade aspose-slides-java en el mismo entorno.

Instalar desde un archivo ZIP

También puede usar la biblioteca desde la página de descargas de Aspose.Slides:

Instale Python y Java como se describe en Requisitos previos.
Cree y active un entorno virtual siguiendo las instrucciones anteriores.
Instale JPype con python -m pip install JPype1.
Descargue y extraiga el archivo ZIP de Aspose.Slides para Python a través de Java.
Localice el directorio del paquete asposeslides extraído. Mantenga su contenido, incluido el directorio lib y el archivo JAR, juntos.
Coloque example.py de la sección siguiente junto al directorio asposeslides para que Python pueda importar el paquete. El archivo ya contiene su propio example.py junto a asposeslides; sustitúyalo por el que aparece a continuación.

Verificar la instalación

Guarde el siguiente código como example.py. Crea una presentación con un cuadro de texto y la guarda como out.pptx en el directorio de trabajo actual.

import jpype
import asposeslides

jpype.startJVM()

try:
    from asposeslides.api import Presentation, SaveFormat, ShapeType

    presentation = Presentation()
    try:
        slide = presentation.getSlides().get_Item(0)
        shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 500, 80)
        shape.getTextFrame().setText("Aspose.Slides is ready!")
        presentation.save("out.pptx", SaveFormat.Pptx)
    finally:
        presentation.dispose()
finally:
    jpype.shutdownJVM()

Con el entorno virtual activo, ejecute el ejemplo desde el directorio que contiene example.py:

python example.py

La importación de asposeslides registra la biblioteca Java incluida antes de que se inicie la JVM. Importe asposeslides.api después de iniciar la JVM y libere los recursos de la presentación antes de cerrarla.

Note

Sin una licencia, la salida incluye una marca de agua de evaluación. Consulte Evaluar Aspose.Slides para conocer las limitaciones de la evaluación y la información sobre licencias temporales.

Preguntas frecuentes

¿Por qué Python indica que no se puede encontrar o cargar la JVM?

Verifique que JAVA_HOME apunte a un JDK compatible con su instalación de Python y JPype, como se describe en los Requisitos del sistema. Consulte la guía de solución de problemas de instalación de JPype para comprobaciones adicionales.

¿Por qué Python indica que falta asposeslides después de la instalación?

El paquete puede haberse instalado para un intérprete de Python diferente. Active el entorno virtual usado para la instalación y ejecute python -m pip show aspose-slides-java. Para una instalación ZIP, asegúrese de que el directorio asposeslides esté junto a su script o disponible de otro modo en la ruta de búsqueda de módulos de Python.

¿Puedo ejecutar el ejemplo repetidamente en un cuaderno?

El ejemplo está pensado para un proceso Python independiente. Antes de adaptarlo a una ejecución repetida en un cuaderno, consulte Limitaciones y diferencias de API para información sobre el ciclo de vida de la JVM y la guía para cuadernos.

¿Por qué pip falla con CERTIFICATE_VERIFY_FAILED?

Si su red utiliza un proxy de inspección HTTPS, pip debe confiar en su autoridad certificadora. Configure el paquete de CA de confianza usando la opción --cert de pip o la variable de entorno PIP_CERT, siguiendo las instrucciones de certificados HTTPS de pip. La configuración requerida depende de su red y de la versión de pip.

Requisitos del Sistema Licencias