Aspose.Slides FOSS
Python
Începeți
Instalare

Instalare

Instalarea Aspose.Slides FOSS pentru Python

Aspose.Slides FOSS for Python is distributed as a pure-Python package on PyPI. Its only external dependency is lxml, care pip îl instalează automat: nu sunt extensii native de compilat, nu sunt biblioteci de sistem de instalat și nu este necesar Microsoft Office sau alt runtime proprietar.

Prerechizite

CerințăDetaliu
Python versiune3.10 or later
Manager de pachetepip (livrat împreună cu CPython)
Sistem de operareWindows, macOS, Linux (orice platformă care rulează CPython)
Compilator / unelte de construireNiciunul necesar
Dependență automatălxml (instalat automat de pip)

1. Install via pip (Recommended)

Cea mai simplă modalitate de a instala Aspose.Slides FOSS este direct de pe PyPI:

pip install aspose-slides-foss

pip descarcă și instalează pachetul împreună cu lxml dependență. Nu este necesară nicio configurare post-instalație.

Pentru a instala o versiune fixă pentru construcții reproductibile:

pip install aspose-slides-foss==26.3.0

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

Folosirea unui mediu virtual menține biblioteca izolată de alte proiecte Python și evită conflictele de versiune.

Creați și activați un mediu 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

Instalați biblioteca în mediul activat:

pip install aspose-slides-foss

Înregistrați dependențele pentru reproductibilitate:

pip freeze > requirements.txt

Pentru a recrea mediul pe o altă mașină:

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

3. Verify the Installation

După instalare, verificați că biblioteca se importă corect și un Presentation poate fi 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)}")

Ieșire așteptată:

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

De asemenea, puteți verifica versiunea instalată cu pip:

pip show aspose-slides-foss

Aceasta afișează versiunea, autorul și licența (MIT).

Începe rapid: Crează o prezentare cu o formă

Scriptul următor creează o nouă prezentare, adaugă un dreptunghi cu text și o salvează ca .pptx fișier:

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: Folosiți întotdeauna Presentation ca manager de context (with declarație). Acest lucru asigură curățarea corectă a resurselor interne atunci când blocul se închide.

Note de platformă

Windows, macOS, Linux: Biblioteca este identică pe toate platformele. Nu există căi de cod specifice platformei sau extensii binare dincolo de lxml.

Docker / serverless: Biblioteca funcționează în interiorul imaginilor Docker subțiri (cum ar fi python:3.12-slim) cu pip install aspose-slides-foss. Nu sunt necesare pachete suplimentare apt sau yum, cu excepția cazului în care lxml trebuie să compileze din sursă (roata PyPI acoperă arhitecturile comune).

CI/CD: Adăugați pip install aspose-slides-foss la pasul de dependență al pipeline-ului CI. Nu este necesară nicio configurare suplimentară.

Conda: Dacă proiectul tău folosește Conda, instalează biblioteca din PyPI într-un mediu Conda:

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

Resurse suplimentare

 Română