Aspose.Slides FOSS
Python
Rozpoczęcie
Instalacja

Instalacja

Instalacja Aspose.Slides FOSS dla Python

Aspose.Slides FOSS for Python is distributed as a pure-Python package on PyPI. Its only external dependency is lxml, które pip instaluje automatycznie: brak natywnych rozszerzeń do kompilacji, brak bibliotek systemowych do instalacji oraz nie jest wymagany Microsoft Office ani inny własnościowy runtime.

Wymagania wstępne

WymaganieSzczegół
Python wersja3.10 or later
Menedżer pakietówpip (dołączony do CPython)
System operacyjnyWindows, macOS, Linux (dowolna platforma uruchamiająca CPython)
Kompilator / narzędzia budowaniaNie wymagane
Automatyczna zależnośćlxml (zainstalowane automatycznie przez pip)

1. Install via pip (Recommended)

Najprostszym sposobem instalacji Aspose.Slides FOSS jest bezpośrednio z PyPI:

pip install aspose-slides-foss

pip pobiera i instaluje pakiet wraz z lxml zależnością. Nie wymagana jest żadna konfiguracja po instalacji.

Aby zainstalować określoną wersję dla powtarzalnych kompilacji:

pip install aspose-slides-foss==26.3.0

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

Użycie środowiska wirtualnego utrzymuje bibliotekę odizolowaną od innych projektów Python i zapobiega konfliktom wersji.

Utwórz i aktywuj środowisko wirtualne:

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

Zainstaluj bibliotekę w aktywowanym środowisku:

pip install aspose-slides-foss

Zapisz zależności w celu reprodukowalności:

pip freeze > requirements.txt

Aby odtworzyć środowisko na innym komputerze:

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

3. Verify the Installation

Po instalacji zweryfikuj, że biblioteka importuje się poprawnie i Presentation można utworzyć:

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

Oczekiwany wynik:

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

Możesz także sprawdzić zainstalowaną wersję za pomocą pip:

pip show aspose-slides-foss

To wypisuje wersję, autora i licencję (MIT).

Szybki start: Utwórz prezentację z kształtem

Poniższy skrypt tworzy nową prezentację, dodaje prostokąt z tekstem i zapisuje ją jako .pptx plik:

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

Ważne: Zawsze używaj Presentation jako menedżer kontekstu (with statement). Zapewnia to prawidłowe czyszczenie wewnętrznych zasobów po zakończeniu bloku.

Informacje o platformie

Windows, macOS, Linux: Biblioteka jest identyczna na wszystkich platformach. Nie ma specyficznych dla platformy ścieżek kodu ani rozszerzeń binarnych poza lxml.

Docker / serverless: Biblioteka działa w lekkich obrazach Docker (takich jak python:3.12-slim) z pip install aspose-slides-foss. Nie są wymagane dodatkowe pakiety apt lub yum, chyba że lxml musi kompilować ze źródła (koło PyPI obejmuje typowe architektury).

CI/CD: Dodaj pip install aspose-slides-foss do kroku zależności w Twoim potoku CI. Nie wymaga dodatkowej konfiguracji.

Conda: Jeśli Twój projekt używa Conda, zainstaluj bibliotekę z PyPI wewnątrz środowiska Conda:

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

Dodatkowe zasoby

 Polski