Installazione

Di cosa tratta questa pagina

Installa Aspose.Slides per Python tramite Java su Windows, Linux o macOS, configura Java e JPype e verifica l’installazione con un esempio funzionante.

Aspose.Slides per Python tramite Java funziona su Windows, Linux e macOS. Utilizza JPype per accedere alla libreria Java da Python. Microsoft PowerPoint non è richiesto.

Prerequisiti

Prima di installare i pacchetti Python, installa Python e un JDK che soddisfi i Requisiti di sistema. Quella pagina elenca le versioni compatibili, i requisiti di architettura e tutte le dipendenze necessarie per compilare JPype dal codice sorgente.

Imposta JAVA_HOME sulla directory di installazione del JDK, non sulla sua sottodirectory bin, e aggiungi la directory bin del JDK a PATH. Apri un nuovo terminale dopo aver modificato le variabili d’ambiente.

Installa da PyPI

Esegui i comandi seguenti in un terminale, non nella console interattiva di Python. Crea una directory di progetto e un ambiente virtuale per mantenere i pacchetti isolati da altri progetti.

Windows

Con l’interprete Python scelto disponibile come python su PATH, esegui i seguenti comandi in Prompt dei comandi:

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

Linux e macOS

Con la versione di Python scelta disponibile come python3, esegui i seguenti comandi in Bash o zsh:

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

Su Debian o Ubuntu, se la creazione dell’ambiente fallisce perché ensurepip non è disponibile, installa il pacchetto python3-venv con sudo apt-get install python3-venv, quindi ripeti il comando di creazione dell’ambiente. Una versione di Python installata separatamente potrebbe necessitare del relativo pacchetto venv specifico della versione.

Installa i pacchetti

Con l’ambiente virtuale attivo, installa JPype e Aspose.Slides:

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

L’uso di python -m pip garantisce che i pacchetti vengano installati per l’interprete usato per eseguire l’applicazione.

Per aggiornare un’installazione esistente di Aspose.Slides, esegui python -m pip install --upgrade aspose-slides-java nello stesso ambiente.

Installa da un archivio ZIP

Puoi anche usare la libreria dalla pagina di download di Aspose.Slides:

Installa Python e Java come descritto nei Prerequisiti.
Crea e attiva un ambiente virtuale seguendo le istruzioni sopra.
Installa JPype con python -m pip install JPype1.
Scarica e estrai l’archivio ZIP di Aspose.Slides per Python tramite Java.
Individua la directory asposeslides estratta. Mantieni i suoi contenuti, inclusi la directory lib e il file JAR, insieme.
Posiziona example.py dalla sezione successiva accanto alla directory asposeslides in modo che Python possa importare il pacchetto. L’archivio contiene già il proprio example.py accanto a asposeslides; sostituiscilo con quello qui sotto.

Verifica l’installazione

Salva il seguente codice in example.py. Crea una presentazione con una casella di testo e la salva come out.pptx nella directory di lavoro corrente.

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 l’ambiente virtuale attivo, esegui l’esempio dalla directory contenente example.py:

python example.py

L’importazione asposeslides registra la libreria Java inclusa prima dell’avvio della JVM. Importa asposeslides.api dopo aver avviato la JVM e rilascia le risorse della presentazione prima di chiuderla.

Note

Senza licenza, l’output include una filigrana di valutazione. Consulta Valuta Aspose.Slides per le limitazioni della versione di valutazione e le informazioni sulla licenza temporanea.

FAQ

Perché Python segnala che la JVM non può essere trovata o caricata?

Verifica che JAVA_HOME punti a un JDK compatibile con la tua installazione di Python e JPype, come descritto nei Requisiti di sistema. Consulta la guida alla risoluzione dei problemi di installazione di JPype per ulteriori controlli.

Perché Python segnala che asposeslides è mancante dopo l’installazione?

Il pacchetto potrebbe essere stato installato per un interpreter Python diverso. Attiva l’ambiente virtuale usato per l’installazione ed esegui python -m pip show aspose-slides-java. Per un’installazione ZIP, assicurati che la directory asposeslides sia accanto al tuo script o altrimenti disponibile sul percorso di ricerca dei moduli di Python.

Posso eseguire l’esempio più volte in un notebook?

L’esempio è pensato per un processo Python autonomo. Prima di adattarlo a esecuzioni ripetute in un notebook, consulta Limitazioni e differenze API per la gestione del ciclo di vita della JVM e le linee guida per i notebook.

Perché pip fallisce con CERTIFICATE_VERIFY_FAILED?

Se la tua rete utilizza un proxy di ispezione HTTPS, pip deve fidarsi della sua autorità di certificazione. Configura il bundle CA fidato usando l’opzione --cert di pip o la variabile d’ambiente PIP_CERT, seguendo le istruzioni sui certificati HTTPS di pip. La configurazione necessaria dipende dalla tua rete e dalla versione di pip.

Requisiti di sistema Licenza