Pemasangan

Pemasangan Aspose.Slides FOSS untuk Python

Aspose.Slides FOSS for Python is distributed as a pure-Python package on PyPI. Its only external dependency is lxml, yang dipasang secara automatik oleh pip: tiada sambungan asli untuk dikompilasi, tiada perpustakaan sistem untuk dipasang, dan tiada Microsoft Office atau runtime proprietari lain diperlukan.


Prasyarat

KeperluanButiran
Python versi3.10 or later
Pengurus pakejpip (terpaket bersama CPython)
Sistem operasiWindows, macOS, Linux (sebarang platform yang menjalankan CPython)
Pengkompil / alat binaTiada diperlukan
Kebergantungan automatiklxml (dipasang secara automatik oleh pip)

1. Install via pip (Recommended)

Cara paling mudah untuk memasang Aspose.Slides FOSS ialah terus dari PyPI:

pip install aspose-slides-foss

pip memuat turun dan memasang pakej bersama dengan lxml kebergantungan. Tiada konfigurasi selepas pemasangan diperlukan.

Untuk memasang versi yang dipinkan bagi binaan yang boleh diulang:

pip install aspose-slides-foss==26.3.0

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

Menggunakan persekitaran maya memastikan perpustakaan terasing daripada projek Python lain dan mengelakkan konflik versi.

Cipta dan aktifkan persekitaran maya:

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

Pasang perpustakaan di dalam persekitaran yang telah diaktifkan:

pip install aspose-slides-foss

Catat kebergantungan untuk kebolehulangan:

pip freeze > requirements.txt

Untuk mencipta semula persekitaran pada mesin lain:

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

3. Verify the Installation

Selepas memasang, sahkan bahawa perpustakaan diimport dengan betul dan satu Presentation boleh dicipta:

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

Output yang dijangka:

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

Anda juga boleh menyemak versi yang dipasang dengan pip:

pip show aspose-slides-foss

Ini mencetak versi, pengarang, dan lesen (MIT).


Mula Cepat: Cipta Persembahan dengan Bentuk

Skrip berikut mencipta persembahan baru, menambah segi empat tepat dengan teks, dan menyimpannya sebagai a .pptx fail:

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

Penting: Sentiasa gunakan Presentation sebagai pengurus konteks (with pernyataan). Ini memastikan pembersihan yang betul bagi sumber dalaman apabila blok berakhir.


Nota Platform

Windows, macOS, Linux: Perpustakaan ini serupa pada semua platform. Tiada laluan kod khusus platform atau sambungan binari selain lxml.

Docker / serverless: Perpustakaan ini berfungsi di dalam imej Docker yang nipis (seperti python:3.12-slim) dengan pip install aspose-slides-foss. Tiada pakej apt atau yum tambahan diperlukan melainkan lxml perlu dikompilasi dari sumber (roda PyPI meliputi seni bina umum).

CI/CD: Tambah pip install aspose-slides-foss ke langkah kebergantungan pipeline CI anda. Tiada persediaan tambahan diperlukan.

Conda: Jika projek anda menggunakan Conda, pasang perpustakaan dari PyPI di dalam persekitaran Conda:

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

Sumber Tambahan

 Bahasa Melayu