Aspose.Slides FOSS
Python
Започване
Инсталация

Инсталация

Инсталиране на Aspose.Slides FOSS за Python

Aspose.Slides FOSS for Python is distributed as a pure-Python package on PyPI. Its only external dependency is lxml, което pip инсталира автоматично: без нужда от компилиране на native extensions, без нужда от инсталиране на системни библиотеки и без необходимост от Microsoft Office или друг собственически runtime.

Предварителни изисквания

ИзискванеПодробност
Python версия3.10 or later
Мениджър на пакетиpip (включен в CPython)
Операционна системаWindows, macOS, Linux (всяка платформа, която изпълнява CPython)
Компилатор / инструменти за изгражданеНе се изисква
Автоматична зависимостlxml (инсталира се автоматично от pip)

1. Install via pip (Recommended)

Най‑лесният начин да инсталирате Aspose.Slides FOSS е директно от PyPI:

pip install aspose-slides-foss

pip изтегля и инсталира пакета заедно с lxml зависимост. Не е необходима конфигурация след инсталацията.

За да инсталирате фиксирана версия за възпроизводими изграждания:

pip install aspose-slides-foss==26.3.0

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

Използването на виртуална среда държи библиотеката изолирана от други Python проекти и избягва конфликти на версии.

Създайте и активирайте виртуална среда:

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

Инсталирайте библиотеката в активираната среда:

pip install aspose-slides-foss

Запишете зависимостите за възпроизводимост:

pip freeze > requirements.txt

За да възстановите средата на друга машина:

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

3. Verify the Installation

След инсталиране проверете дали библиотеката се импортира правилно и Presentation може да се създаде:

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

Очакван изход:

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

Можете също да проверите инсталираната версия с pip:

pip show aspose-slides-foss

Това отпечатва версията, автора и лиценза (MIT).

Бърз старт: Създаване на презентация с форма

Следният скрипт създава нова презентация, добавя правоъгълник с текст и я запазва като .pptx файл:

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

Важно: Винаги използвайте Presentation като контекстен мениджър (with израз). Това осигурява правилно почистване на вътрешните ресурси, когато блокът излезе.

Забележки за платформата

Windows, macOS, Linux: Библиотеката е идентична на всички платформи. Няма специфични за платформа кодови пътеки или бинарни разширения, освен lxml.

Docker / без сървър: Библиотеката работи в тънки Docker образи (например python:3.12-slim) с pip install aspose-slides-foss. Не са необходими допълнителни apt или yum пакети, освен ако lxml трябва да се компилира от източник (PyPI колелото покрива често срещаните архитектури).

CI/CD: Добавете pip install aspose-slides-foss към стъпката за зависимости във вашия CI pipeline. Не е необходима допълнителна настройка.

Conda: Ако вашият проект използва Conda, инсталирайте библиотеката от PyPI в Conda среда:

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

Допълнителни ресурси

 Български