Aspose.Slides FOSS
Python
Začínáme
Instalace

Instalace

Instalace Aspose.Slides FOSS pro Python

Aspose.Slides FOSS for Python is distributed as a pure-Python package on PyPI. Its only external dependency is lxml, který pip instaluje automaticky: žádné nativní rozšíření ke kompilaci, žádné systémové knihovny k instalaci a není potřeba Microsoft Office ani jiný proprietární runtime.

Předpoklady

PožadavekDetail
Python verze3.10 or later
Správce balíčkůpip (součást CPythonu)
Operační systémWindows, macOS, Linux (jakákoli platforma, která spouští CPython)
Kompilátor / nástroje pro sestaveníNení vyžadováno
Automatická závislostlxml (instaluje se pipem automaticky)

1. Install via pip (Recommended)

Nejednodušší způsob instalace Aspose.Slides FOSS je přímo z PyPI:

pip install aspose-slides-foss

pip stáhne a nainstaluje balíček spolu s lxml závislostí. Není potřeba žádná konfigurace po instalaci.

Pro instalaci konkrétní verze pro reprodukovatelné sestavení:

pip install aspose-slides-foss==26.3.0

2. Set Up a Virtual Environment (Recommended for Projects)

Použití virtuálního prostředí udržuje knihovnu oddělenou od ostatních projektů Python a zabraňuje konfliktům verzí.

Vytvořte a aktivujte virtuální prostředí:

##Create the environment
python -m venv .venv

##Activate on Linux / macOS
source .venv/bin/activate

##Activate on Windows (Command Prompt)
.venv\Scripts\activate.bat

##Activate on Windows (PowerShell)
.venv\Scripts\Activate.ps1

Nainstalujte knihovnu uvnitř aktivovaného prostředí:

pip install aspose-slides-foss

Zaznamenejte závislosti pro reprodukovatelnost:

pip freeze > requirements.txt

Pro obnovení prostředí na jiném počítači:

python -m venv .venv
source .venv/bin/activate   # or the Windows equivalent
pip install -r requirements.txt

3. Verify the Installation

Po instalaci ověřte, že se knihovna správně načte a že lze vytvořit Presentation lze vytvořit:

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    print("Aspose.Slides FOSS installed successfully")
    print(f"Slides in empty presentation: {len(prs.slides)}")

Očekávaný výstup:

Aspose.Slides FOSS installed successfully
Slides in empty presentation: 1

Můžete také zkontrolovat nainstalovanou verzi pomocí pip:

pip show aspose-slides-foss

Tiskne verzi, autora a licenci (MIT).

Rychlý start: Vytvořte prezentaci s tvarem

Následující skript vytvoří novou prezentaci, přidá obdélník s textem a uloží ji jako a .pptx soubor:

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
from aspose.slides_foss import ShapeType

with slides.Presentation() as prs:
    slide = prs.slides[0]

    ##Add a rectangle shape and set its text
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 400, 150)
    shape.add_text_frame("Hello from Aspose.Slides FOSS!")

    prs.save("hello.pptx", SaveFormat.PPTX)

print("Saved hello.pptx")

Důležité: Vždy používejte Presentation jako správce kontextu (with příkaz). To zajišťuje řádné uvolnění vnitřních zdrojů při ukončení bloku.

Poznámky k platformě

Windows, macOS, Linux: Knihovna je na všech platformách identická. Neexistují žádné platformně specifické cesty kódu ani binární rozšíření nad rámec lxml.

Docker / serverless: Knihovna funguje uvnitř úzkých Docker image (například python:3.12-slim) s pip install aspose-slides-foss. Není potřeba žádné další apt nebo yum balíčky, pokud lxml potřebuje kompilovat ze zdroje (wheel z PyPI pokrývá běžné architektury).

CI/CD: Přidejte pip install aspose-slides-foss do kroku závislostí ve vašem CI pipeline. Není potřeba žádné další nastavení.

Conda: Pokud váš projekt používá Conda, nainstalujte knihovnu z PyPI uvnitř Conda prostředí:

conda create -n slides-env python=3.12
conda activate slides-env
pip install aspose-slides-foss

Další zdroje

 Čeština