Aspose.Slides FOSS
Python
快速入门
安装

安装

安装 Aspose.Slides FOSS for Python

Aspose.Slides FOSS for Python is distributed as a pure-Python package on PyPI. Its only external dependency is lxml,，pip 会自动安装：无需编译本地扩展，无需安装系统库，也不需要 Microsoft Office 或其他专有运行时。.

前置条件

需求细节
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 流水线的依赖步骤中。无需额外设置。.

Conda：: 如果你的项目使用 Conda，请在 Conda 环境中从 PyPI 安装该库：:

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

附加资源

 中文