Aspose.Slides FOSS
Python
Začíname
Inštalácia

Inštalácia

Inštalácia Aspose.Slides FOSS pre Python

Aspose.Slides FOSS for Python is distributed as a pure-Python package on PyPI. Its only external dependency is lxml, ktorý pip inštaluje automaticky: žiadne natívne rozšírenia na kompiláciu, žiadne systémové knižnice na inštaláciu a nie je potrebný Microsoft Office ani iný proprietárny runtime.

Predpoklady

PožiadavkaDetail
Python verzia3.10 or later
Správca balíkovpip (zabalený s CPython)
Operačný systémWindows, macOS, Linux (akákoľvek platforma, ktorá spúšťa CPython)
Kompilátor / nástroje na zostavenieNie sú potrebné
Automatická závislosťlxml (inštaluje sa pipom automaticky)

1. Install via pip (Recommended)

Najjednoduchší spôsob, ako nainštalovať Aspose.Slides FOSS, je priamo z PyPI:

pip install aspose-slides-foss

pip stiahne a nainštaluje balík spolu s lxml závislosťou. Nie je potrebná žiadna konfigurácia po inštalácii.

Ak chcete nainštalovať pevne určenú verziu pre reprodukovateľné zostavenia:

pip install aspose-slides-foss==26.3.0

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

Použitie virtuálneho prostredia udržiava knižnicu oddelenú od ostatných projektov Python a zabraňuje konfliktom verzií.

Vytvorte a aktivujte virtuálne prostredie:

##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

Nainštalujte knižnicu v aktivovanom prostredí:

pip install aspose-slides-foss

Zaznamenajte závislosti pre reprodukovateľnosť:

pip freeze > requirements.txt

Ak chcete znovu vytvoriť prostredie na inom 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 inštalácii overte, že knižnica sa načíta správne a Presentation môže byť vytvorený:

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čakávaný výstup:

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

Môžete tiež skontrolovať nainštalovanú verziu pomocou pip:

pip show aspose-slides-foss

Toto vypíše verziu, autora a licenciu (MIT).

Rýchly štart: Vytvorenie prezentácie s tvarom

Nasledujúci skript vytvorí novú prezentáciu, pridá obdĺžnik s textom a uloží ho ako .pptx súbor:

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žívajte Presentation ako správcu kontextu (with príkaz). Toto zabezpečuje správne uvoľnenie interných zdrojov pri ukončení bloku.

Poznámky k platformám

Windows, macOS, Linux: Knižnica je na všetkých platformách identická. Neexistujú žiadne platformovo špecifické cesty kódu ani binárne rozšírenia okrem lxml.

Docker / serverless: Knižnica funguje v úzkych Docker obrazoch (napríklad python:3.12-slim) s pip install aspose-slides-foss. Nie sú potrebné žiadne ďalšie apt alebo yum balíky, pokiaľ lxml potrebuje kompilovať zo zdroja (PyPI wheel pokrýva bežné architektúry).

CI/CD: Pridajte pip install aspose-slides-foss do kroku závislostí vo vašom CI pipeline. Nie je potrebné žiadne ďalšie nastavenie.

Conda: Ak váš projekt používa Conda, nainštalujte knižnicu z PyPI v rámci Conda prostredia:

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

Ďalšie zdroje

 Slovenčina