Aspose.Slides FOSS
Python
Començar
Instal·lació

Instal·lació

Instal·lació de Aspose.Slides FOSS per a Python

Aspose.Slides FOSS for Python is distributed as a pure-Python package on PyPI. Its only external dependency is lxml, que pip instal·la automàticament: cap extensió nativa per compilar, cap biblioteca del sistema per instal·lar, i no es requereix Microsoft Office ni cap altre entorn d’execució propietari.

Requisits previs

RequisitDetall
Python versió3.10 or later
Gestor de paquetspip (inclòs amb CPython)
Sistema operatiuWindows, macOS, Linux (qualsevol plataforma que executi CPython)
Compilador / eines de construccióCap necessari
Dependència automàticalxml (instal·lat per pip automàticament)

1. Install via pip (Recommended)

La manera més senzilla d’instal·lar Aspose.Slides FOSS és directament des de PyPI:

pip install aspose-slides-foss

pip descarrega i instal·la el paquet juntament amb el lxml dependència. No cal cap configuració postinstal·lació.

Per instal·lar una versió fixa per a construccions reproduïbles:

pip install aspose-slides-foss==26.3.0

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

Utilitzar un entorn virtual manté la biblioteca aïllada d’altres projectes Python i evita conflictes de versions.

Crea i activa un entorn virtual:

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

Instal·la la biblioteca dins de l’entorn activat:

pip install aspose-slides-foss

Registra les dependències per a la reproduïbilitat:

pip freeze > requirements.txt

Per recrear l’entorn en una altra màquina:

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

3. Verify the Installation

Després d’instal·lar, verifica que la biblioteca s’importi correctament i un Presentation pot ser creat:

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

Sortida esperada:

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

També pots comprovar la versió instal·lada amb pip:

pip show aspose-slides-foss

Això imprimeix la versió, l’autor i la llicència (MIT).

Inici ràpid: Crea una presentació amb una forma

L’script següent crea una nova presentació, afegeix un rectangle amb text i l’guarda com a .pptx fitxer:

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

Important: Utilitza sempre Presentation com a gestor de context (with enunciat). Això assegura una neteja adequada dels recursos interns quan el bloc surt.

Notes de la plataforma

Windows, macOS, Linux: La biblioteca és idèntica a totes les plataformes. No hi ha camins de codi específics de plataforma ni extensions binàries més enllà de lxml.

Docker / serverless: La biblioteca funciona dins d’imatges Docker lleugers (com ara python:3.12-slim) amb pip install aspose-slides-foss. No es requereixen paquets apt o yum addicionals a menys que lxml necessiti compilar des del codi font (la roda PyPI cobreix arquitectures comunes).

CI/CD: Afegeix pip install aspose-slides-foss al pas de dependències del teu pipeline CI. No es requereix cap configuració addicional.

Conda: Si el teu projecte utilitza Conda, instal·la la llibreria des de PyPI dins d’un entorn Conda:

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

Recursos addicionals

 Català