Aspose.Slides FOSS
Python
Bắt đầu
Cài đặt

Cài đặt

Cài đặt Aspose.Slides FOSS cho Python

Aspose.Slides FOSS for Python is distributed as a pure-Python package on PyPI. Its only external dependency is lxml, mà pip cài đặt tự động: không cần biên dịch phần mở rộng gốc, không cần cài đặt thư viện hệ thống, và không yêu cầu Microsoft Office hay bất kỳ môi trường chạy độc quyền nào khác.

Các yêu cầu trước

Yêu cầuChi tiết
Python phiên bản3.10 or later
Trình quản lý góipip (được tích hợp sẵn trong CPython)
Hệ điều hànhWindows, macOS, Linux (bất kỳ nền tảng nào chạy CPython)
Trình biên dịch / công cụ xây dựngKhông cần thiết
Phụ thuộc tự độnglxml (được pip cài đặt tự động)

1. Install via pip (Recommended)

Cách đơn giản nhất để cài đặt Aspose.Slides FOSS là trực tiếp từ PyPI:

pip install aspose-slides-foss

pip tải xuống và cài đặt gói cùng với lxml phụ thuộc. Không cần cấu hình sau khi cài đặt.

Để cài đặt một phiên bản cố định cho các bản dựng có thể tái tạo:

pip install aspose-slides-foss==26.3.0

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

Sử dụng môi trường ảo giúp thư viện được cô lập khỏi các dự án Python khác và tránh xung đột phiên bản.

Tạo và kích hoạt môi trường ảo:

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

Cài đặt thư viện trong môi trường đã kích hoạt:

pip install aspose-slides-foss

Ghi lại các phụ thuộc để tái tạo:

pip freeze > requirements.txt

Để tái tạo môi trường trên máy khác:

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

3. Verify the Installation

Sau khi cài đặt, xác minh rằng thư viện được nhập đúng và một Presentation có thể được tạo:

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

Kết quả mong đợi:

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

Bạn cũng có thể kiểm tra phiên bản đã cài đặt bằng pip:

pip show aspose-slides-foss

Điều này in ra phiên bản, tác giả và giấy phép (MIT).

Bắt đầu nhanh: Tạo một Bài thuyết trình với một Hình dạng

Kịch bản sau tạo một bản trình bày mới, thêm một hình chữ nhật có văn bản, và lưu nó dưới dạng một .pptx tệp:

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

Quan trọng: Luôn sử dụng Presentation như một trình quản lý ngữ cảnh (with câu lệnh). Điều này đảm bảo việc dọn dẹp đúng cách các tài nguyên nội bộ khi khối kết thúc.

Ghi chú nền tảng

Windows, macOS, Linux: Thư viện giống hệt trên mọi nền tảng. Không có các đường dẫn mã hoặc phần mở rộng nhị phân đặc thù cho nền tảng nào ngoài lxml.

Docker / serverless: Thư viện hoạt động bên trong các image Docker gọn (chẳng hạn như python:3.12-slim) với pip install aspose-slides-foss. Không cần gói apt hoặc yum bổ sung trừ khi lxml cần biên dịch từ mã nguồn (bánh xe PyPI bao phủ các kiến trúc phổ biến).

CI/CD: Thêm pip install aspose-slides-foss vào bước phụ thuộc của pipeline CI của bạn. Không cần cài đặt bổ sung.

Conda: Nếu dự án của bạn sử dụng Conda, cài đặt thư viện từ PyPI trong môi trường Conda:

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

Tài nguyên bổ sung

 Tiếng Việt