Installazione

Installazione di Aspose.Slides FOSS per Python

Aspose.Slides FOSS for Python is distributed as a pure-Python package on PyPI. Its only external dependency is lxml, che pip installa automaticamente: nessuna estensione nativa da compilare, nessuna libreria di sistema da installare e nessun Microsoft Office o altro runtime proprietario richiesto.


Prerequisiti

RequisitoDettaglio
Python versione3.10 or later
Gestore di pacchettipip (incluso con CPython)
Sistema operativoWindows, macOS, Linux (qualsiasi piattaforma che esegue CPython)
Compilatore / strumenti di buildNessuno richiesto
Dipendenza automaticalxml (installata automaticamente da pip)

1. Install via pip (Recommended)

Il modo più semplice per installare Aspose.Slides FOSS è direttamente da PyPI:

pip install aspose-slides-foss

pip scarica e installa il pacchetto insieme al lxml dipendenza. Nessuna configurazione post‑installazione è necessaria.

Per installare una versione fissata per build riproducibili:

pip install aspose-slides-foss==26.3.0

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

Usare un ambiente virtuale mantiene la libreria isolata da altri progetti Python ed evita conflitti di versione.

Crea e attiva un ambiente virtuale:

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

Installa la libreria all’interno dell’ambiente attivato:

pip install aspose-slides-foss

Registra le dipendenze per la riproducibilità:

pip freeze > requirements.txt

Per ricreare l’ambiente su un’altra macchina:

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

3. Verify the Installation

Dopo l’installazione, verifica che la libreria venga importata correttamente e che un Presentation possa essere creato:

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

Output previsto:

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

Puoi anche controllare la versione installata con pip:

pip show aspose-slides-foss

Questo stampa la versione, l’autore e la licenza (MIT).


Guida rapida: Crea una presentazione con una forma

Lo script seguente crea una nuova presentazione, aggiunge un rettangolo con testo e lo salva come un .pptx file:

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

Importante: Usa sempre Presentation come gestore di contesto (with istruzione). Questo garantisce una corretta pulizia delle risorse interne quando il blocco termina.


Note sulla piattaforma

Windows, macOS, Linux: La libreria è identica su tutte le piattaforme. Non ci sono percorsi di codice specifici per piattaforma o estensioni binarie oltre a lxml.

Docker / serverless: La libreria funziona all’interno di immagini Docker leggere (come ad esempio python:3.12-slim) con pip install aspose-slides-foss. Non sono richiesti pacchetti apt o yum aggiuntivi a meno che lxml necessiti di compilare dal sorgente (la ruota PyPI copre le architetture comuni).

CI/CD: Aggiungi pip install aspose-slides-foss al passaggio delle dipendenze del tuo pipeline CI. Non è necessaria alcuna configurazione aggiuntiva.

Conda: Se il tuo progetto utilizza Conda, installa la libreria da PyPI all’interno di un ambiente Conda:

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

Risorse aggiuntive

 Italiano