Telepítés

A Aspose.Slides FOSS telepítése a Python számára

Aspose.Slides FOSS for Python is distributed as a pure-Python package on PyPI. Its only external dependency is lxml, amelyet a pip automatikusan telepít: nincs lefordítandó natív kiterjesztés, nincs telepítendő rendszerkönyvtár, és nem szükséges a Microsoft Office vagy más tulajdonosi futtatókörnyezet.


Előfeltételek

KövetelményRészlet
Python verzió3.10 or later
Csomagkezelőpip (a CPython-nal együtt szállítva)
Operációs rendszerWindows, macOS, Linux (bármely platform, amely futtatja a CPython-t)
Fordító / build eszközökNem szükséges
Automatikus függőséglxml (automatikusan a pip által telepítve)

1. Install via pip (Recommended)

A legegyszerűbb módja a Aspose.Slides FOSS telepítésének közvetlenül a PyPI-ról:

pip install aspose-slides-foss

a pip letölti és telepíti a csomagot a lxml függőséggel együtt. Nem szükséges utólagos konfiguráció.

Egy rögzített verzió telepítéséhez a reprodukálható buildekhez:

pip install aspose-slides-foss==26.3.0

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

A virtuális környezet használata izolálja a könyvtárat a többi Python projekttől, és elkerüli a verzióütközéseket.

Hozz létre és aktiválj egy virtuális környezetet:

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

Telepítsd a könyvtárat az aktivált környezeten belül:

pip install aspose-slides-foss

Rögzítsd a függőségeket a reprodukálhatóság érdekében:

pip freeze > requirements.txt

A környezet újbóli létrehozásához egy másik gépen:

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

3. Verify the Installation

Telepítés után ellenőrizze, hogy a könyvtár helyesen importálható-e, és egy Presentation létrehozható:

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

Várható kimenet:

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

A telepített verziót a pip segítségével is ellenőrizheted:

pip show aspose-slides-foss

Ez kiírja a verziót, a szerzőt és a licencet (MIT).


Gyors kezdés: Prezentáció létrehozása alakzattal

A következő szkript új prezentációt hoz létre, hozzáad egy szöveges téglalapot, és elmenti mint .pptx fájl:

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

Fontos: Mindig használja Presentation kontextuskezelőként (with utasítás). Ez biztosítja a belső erőforrások megfelelő tisztítását, amikor a blokk kilép.


Platform megjegyzések

Windows, macOS, Linux: A könyvtár minden platformon azonos. Nincsenek platform‑specifikus kódelágazások vagy bináris kiterjesztések, azon kívül lxml.

Docker / serverless: A könyvtár működik vékony Docker képekben (például python:3.12-slim) a következővel pip install aspose-slides-foss. Nem szükséges további apt vagy yum csomag, hacsak lxml fordításra van szükség forrásból (a PyPI kerék lefedi a gyakori architektúrákat).

CI/CD: Adja hozzá pip install aspose-slides-foss a CI pipeline függőségi lépéséhez. Nem szükséges további beállítás.

Conda: Ha a projektje Conda-t használ, telepítse a könyvtárat a PyPI-ról egy Conda környezeten belül:

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

További erőforrások

 Magyar