Instalacija

Instalacija Aspose.Slides FOSS za Python

Aspose.Slides FOSS for Python is distributed as a pure-Python package on PyPI. Its only external dependency is lxml, koji pip instalira automatski: nema izvornih ekstenzija za kompilaciju, nema sistemskih biblioteka za instalaciju i ne treba Microsoft Office niti drugi vlasnički runtime.


Preduvjeti

ZahtjevDetalj
Python verzija3.10 or later
Upravitelj paketapip (ugrađen u CPython)
Operativni sustavWindows, macOS, Linux (bilo koja platforma koja pokreće CPython)
Kompajler / alati za izgradnjuNije potrebno
Automatska ovisnostlxml (instalira pip automatski)

1. Install via pip (Recommended)

Najjednostavniji način za instalaciju Aspose.Slides FOSS je izravno s PyPI-ja:

pip install aspose-slides-foss

pip preuzima i instalira paket zajedno s lxml ovisnošću. Nije potrebna nikakva post‑instalacijska konfiguracija.

Za instalaciju fiksirane verzije radi reproduktivnih izgradnji:

pip install aspose-slides-foss==26.3.0

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

Korištenje virtualnog okruženja drži biblioteku odvojenom od drugih Python projekata i izbjegava sukobe verzija.

Stvorite i aktivirajte virtualno okruženje:

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

Instalirajte biblioteku unutar aktiviranog okruženja:

pip install aspose-slides-foss

Zabilježite ovisnosti radi reprodukcije:

pip freeze > requirements.txt

Za ponovno stvaranje okruženja na drugom računalu:

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

3. Verify the Installation

Nakon instalacije, provjerite da se biblioteka ispravno učitava i da se Presentation može se stvoriti:

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čekivani izlaz:

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

Također možete provjeriti instaliranu verziju pomoću pip-a:

pip show aspose-slides-foss

Ovo ispisuje verziju, autora i licencu (MIT).


Brzi početak: Stvaranje prezentacije s oblikom

Sljedeći skript stvara novu prezentaciju, dodaje pravokutnik s tekstom i sprema ga kao .pptx datoteku:

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

Važno: Uvijek koristite Presentation kao upravitelj kontekstom (with izjava). Ovo osigurava pravilno čišćenje unutarnjih resursa kada blok završi.


Napomene o platformi

Windows, macOS, Linux: Biblioteka je identična na svim platformama. Nema platformno‑specifičnih kodnih putanja ili binarnih ekstenzija izvan lxml.

Docker / serverless: Biblioteka radi unutar tankih Docker slika (kao što su python:3.12-slim) pip install aspose-slides-foss. Nema dodatnih apt ili yum paketa potrebnih osim ako lxml treba kompilirati iz izvornog koda (PyPI kotač pokriva uobičajene arhitekture).

CI/CD: Dodajte pip install aspose-slides-foss u korak ovisnosti vašeg CI pipelinea. Nije potrebno dodatno postavljanje.

Conda: Ako vaš projekt koristi Conda, instalirajte biblioteku s PyPI unutar Conda okruženja:

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

Dodatni resursi

 Hrvatski