Instalace

Aspose.Slides pro Python přes Java běží na Windows, Linuxu a macOS. Používá JPype k přístupu k Java knihovně z Pythonu. Microsoft PowerPoint není vyžadován.

Požadavky

Před instalací balíčků Pythonu nainstalujte Python a JDK, které splňují Požadavky systému. Tato stránka uvádí kompatibilní verze, požadavky na architekturu a všechny závislosti potřebné pro sestavení JPype ze zdrojového kódu.

Nastavte JAVA_HOME na adresář instalace JDK, nikoli na jeho podadresář bin, a přidejte adresář bin JDK do PATH. Po změně proměnných prostředí otevřete nový terminál.

Instalace z PyPI

Spusťte následující příkazy v terminálu, nikoli v interaktivním promptu Pythonu. Vytvořte adresář projektu a virtuální prostředí, aby byly balíčky izolovány od ostatních projektů.

Windows

Pokud je váš zvolený interpreter Pythonu k dispozici jako python v PATH, spusťte následující příkazy v příkazovém řádku:

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

Linux a macOS

Pokud je vaše zvolená verze Pythonu k dispozici jako python3, spusťte následující příkazy v Bash nebo zsh:

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

Na Debianu nebo Ubuntu, pokud selže vytvoření prostředí kvůli nedostupnosti ensurepip, nainstalujte balíček python3-venv pomocí sudo apt-get install python3-venv a poté opakujte příkaz pro vytvoření prostředí. Samostatně nainstalovaná verze Pythonu může vyžadovat odpovídající verzi‑specifický balíček venv.

Instalace balíčků

Při aktivním virtuálním prostředí nainstalujte JPype a Aspose.Slides:

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

Použití python -m pip zajišťuje, že balíčky jsou nainstalovány pro interpreter, který používáte k spuštění vaší aplikace.

Pro aktualizaci existující instalace Aspose.Slides spusťte python -m pip install --upgrade aspose-slides-java ve stejném prostředí.

Instalace ze ZIP archivu

Knihovnu můžete také použít ze stránky Aspose.Slides ke stažení:

1. Nainstalujte Python a Java podle popisu v Požadavcích.
2. Vytvořte a aktivujte virtuální prostředí pomocí výše uvedených instrukcí.
3. Nainstalujte JPype pomocí python -m pip install JPype1.
4. Stáhněte a rozbalte ZIP archiv Aspose.Slides pro Python přes Java.
5. Najděte extrahovaný adresář balíčku asposeslides. Uchovejte jeho obsah, včetně adresáře lib a souboru JAR, pohromadě.
6. Umístěte example.py z následující sekce vedle adresáře asposeslides, aby jej Python mohl importovat. Archiv již obsahuje vlastní example.py vedle asposeslides; nahraďte jej tím níže.

Ověření instalace

Uložte následující kód jako example.py. Vytvoří prezentaci s textovým polem a uloží ji jako out.pptx do aktuálního pracovního adresáře.

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

Při aktivním virtuálním prostředí spusťte příklad ze složky obsahující example.py:

python example.py

Import asposeslides registruje zabalenou Java knihovnu před spuštěním JVM. Importujte asposeslides.api po spuštění JVM a uvolněte zdroje prezentace před jeho vypnutím.

Často kladené otázky

Proč Python hlásí, že JVM nelze najít nebo načíst?

Zkontrolujte, že JAVA_HOME ukazuje na JDK kompatibilní s vaším Pythonem a instalací JPype, jak je popsáno v System Requirements. Další kontroly najdete v průvodci řešením problémů s instalací JPype.

Proč Python hlásí, že asposeslides chybí po instalaci?

Balíček mohl být nainstalován pro jiný interpreter Pythonu. Aktivujte virtuální prostředí použité při instalaci a spusťte python -m pip show aspose-slides-java. Pro instalaci ze ZIP se ujistěte, že adresář asposeslides je vedle vašeho skriptu nebo je jinak dostupný v Pythonu na cestě pro vyhledávání modulů.

Mohu spouštět příklad opakovaně v notebooku?

Příklad je určen pro samostatný Python proces. Před jeho úpravou pro opakované spouštění v notebooku si přečtěte Limitations and API Differences ohledně životního cyklu JVM a doporučení pro notebooky.

Proč pip selže s CERTIFICATE_VERIFY_FAILED?

Pokud vaše síť používá HTTPS inspekční proxy, pip musí důvěřovat jejímu certifikačnímu úřadu. Nakonfigurujte důvěryhodný CA bundle pomocí volby --cert pipu nebo proměnné prostředí PIP_CERT, podle pip HTTPS certificate instructions. Požadovaná konfigurace závisí na vaší síti a verzi pipu.