Installation

À propos de cette page

Installez Aspose.Slides for Python via Java sous Windows, Linux ou macOS, configurez Java et JPype, et vérifiez la configuration avec un exemple fonctionnel.

Aspose.Slides for Python via Java fonctionne sous Windows, Linux et macOS. Il utilise JPype pour accéder à la bibliothèque Java depuis Python. Microsoft PowerPoint n’est pas requis.

Pré-requis

Avant d’installer les packages Python, installez Python et un JDK qui répondent aux System Requirements. Cette page répertorie les versions compatibles, les exigences d’architecture et les dépendances nécessaires pour compiler JPype à partir des sources.

Définissez JAVA_HOME sur le répertoire d’installation du JDK, et non sur son sous‑répertoire bin, puis ajoutez le répertoire bin du JDK à PATH. Ouvrez un nouveau terminal après avoir modifié les variables d’environnement.

Installation depuis PyPI

Exécutez les commandes suivantes dans un terminal, et non dans l’invite interactive de Python. Créez un répertoire de projet et un environnement virtuel pour isoler les packages des autres projets.

Windows

Avec l’interpréteur Python de votre choix disponible sous le nom python dans le PATH, exécutez les commandes suivantes dans l’invite de commandes :

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

Linux et macOS

Avec la version Python de votre choix disponible sous le nom python3, exécutez les commandes suivantes dans Bash ou zsh :

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

Sur Debian ou Ubuntu, si la création de l’environnement échoue parce que ensurepip est indisponible, installez le paquet python3-venv avec sudo apt-get install python3-venv, puis répétez la commande de création d’environnement. Une version de Python installée séparément peut nécessiter le paquet venv correspondant à sa version.

Installer les packages

Avec l’environnement virtuel actif, installez JPype et Aspose.Slides :

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

Utiliser python -m pip garantit que les packages sont installés pour l’interpréteur utilisé pour exécuter votre application.

Pour mettre à jour une installation existante d’Aspose.Slides, exécutez python -m pip install --upgrade aspose-slides-java dans le même environnement.

Installer depuis une archive ZIP

Vous pouvez également utiliser la bibliothèque depuis la page de téléchargement d’Aspose.Slides :

Installez Python et Java comme décrit dans les Pré-requis.
Créez et activez un environnement virtuel en suivant les instructions ci‑dessus.
Installez JPype avec python -m pip install JPype1.
Téléchargez et extrayez l’archive ZIP d’Aspose.Slides for Python via Java.
Localisez le répertoire du package asposeslides extrait. Conservez son contenu, y compris le répertoire lib et le fichier JAR, ensemble.
Placez example.py de la section suivante à côté du répertoire asposeslides afin que Python puisse importer le package. L’archive contient déjà son propre example.py à côté de asposeslides ; remplacez‑le par celui ci‑dessous.

Vérifier l’installation

Enregistrez le code suivant sous le nom example.py. Il crée une présentation contenant une zone de texte et l’enregistre sous out.pptx dans le répertoire de travail actuel.

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()

Avec l’environnement virtuel actif, exécutez l’exemple depuis le répertoire contenant example.py :

python example.py

L’importation asposeslides enregistre la bibliothèque Java fournie avant le démarrage de la JVM. Importez asposeslides.api après le démarrage de la JVM, et libérez les ressources de la présentation avant de l’arrêter.

Note

Sans licence, le résultat comporte un filigrane d’évaluation. Consultez Évaluer Aspose.Slides pour connaître les limitations de l’évaluation et les informations sur la licence temporaire.

FAQ

Pourquoi Python indique-t-il que la JVM est introuvable ou ne peut pas être chargée ?

Vérifiez que JAVA_HOME pointe vers un JDK compatible avec votre installation Python et JPype, comme décrit dans les System Requirements. Consultez le guide de dépannage de l’installation de JPype pour des vérifications supplémentaires.

Pourquoi Python indique-t-il que asposeslides est manquant après l’installation ?

Le package a peut‑être été installé pour un autre interpréteur Python. Activez l’environnement virtuel utilisé pour l’installation et exécutez python -m pip show aspose-slides-java. Pour une installation ZIP, assurez‑vous que le répertoire asposeslides se trouve à côté de votre script ou qu’il soit autrement accessible via le chemin de recherche des modules de Python.

Puis‑je exécuter l’exemple de façon répétée dans un notebook ?

L’exemple est destiné à un processus Python autonome. Avant de l’adapter à une exécution répétée dans un notebook, consultez les Limitations et différences d’API concernant le cycle de vie de la JVM et les recommandations pour les notebooks.

Pourquoi pip échoue avec CERTIFICATE_VERIFY_FAILED ?

Si votre réseau utilise un proxy d’inspection HTTPS, pip doit faire confiance à son autorité de certification. Configurez le bundle CA de confiance à l’aide de l’option --cert de pip ou de la variable d’environnement PIP_CERT, en suivant les instructions de pip concernant les certificats HTTPS. La configuration requise dépend de votre réseau et de la version de pip.

Exigences Système Licences