Aspose.Slides FOSS
Python
Começar a Fazer
Instalação

Instalação

Instalação de Aspose.Slides FOSS para Python

Aspose.Slides FOSS for Python is distributed as a pure-Python package on PyPI. Its only external dependency is lxml, que o pip instala automaticamente: não há extensões nativas para compilar, nenhuma biblioteca de sistema a instalar e nenhum Microsoft Office ou outro tempo de execução proprietário necessário.

Precondições

RequisitosDetalhes
Versão Python3.10 or later
Gestor de pacotespip (juntado com CPython)
Sistema de operaçãoWindows, macOS, Linux (qualquer plataforma que execute CPython)
Ferramentas de compilador / compilaçãoNão é necessário.
Dependência automáticalxml (instalado por pip automaticamente)

1. Install via pip (Recommended)

A maneira mais simples de instalar o Aspose.Slides FOSS é diretamente do PyPI:

pip install aspose-slides-foss

Pip descarrega e instala o pacote juntamente com a lxml Não é necessária nenhuma configuração pós-instalação.

Para instalar uma versão fixa para compilações reproduzíveis:

pip install aspose-slides-foss

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

Usar um ambiente virtual mantém a biblioteca isolada de outros projetos Python e evita conflitos de versão.

Criar e ativar um ambiente 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

Instalar a biblioteca dentro do ambiente ativado:

pip install aspose-slides-foss

Dependências de registo para a reproducibilidade:

pip freeze > requirements.txt

Para recriar o ambiente em outra máquina:

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

3. Verify the Installation

Após a instalação, verifique se a biblioteca importa corretamente e um sistema de Presentation podem ser criados:

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

Produção prevista:

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

Você também pode verificar a versão instalada com pip:

pip show aspose-slides-foss

Isto imprime a versão, autor e licença (MIT).

Começo rápido: Crie uma apresentação com um formato

O seguinte script cria uma nova apresentação, adiciona um retângulo com texto e salva-o como um .pptx Arquivo:

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: Usar sempre: Presentation como gestor de contexto (with Esta operação assegura a limpeza adequada dos recursos internos quando o bloco sai.

Notas da plataforma

Windows, macOS, Linux: A biblioteca é idêntica em todas as plataformas. Não há caminhos de código específicos para a plataforma ou extensões binárias além do que o sistema operacional pode fazer com uma única versão da mesma. lxml.

Docker / sem servidor: A biblioteca funciona dentro de imagens docker (como o Docker) e é uma das mais importantes. python:3.12-slim) com o seguinte: pip install aspose-slides-foss.Não são necessários pacotes adicionais de apt ou yum, salvo se: lxml precisa compilar a partir da fonte (a roda PyPI abrange arquiteturas comuns).

CI/CD: Adicionar pip install aspose-slides-foss Não é necessário qualquer configuração adicional.

- Não .: Se o seu projeto usar Conda, instale a biblioteca do PyPI dentro de um ambiente Cunda:

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

Recursos adicionais

Ver também:

 Português