Εγκατάσταση

Εγκατάσταση του 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 εγκαθιστά αυτόματα: χωρίς εγγενείς επεκτάσεις για μεταγλώττιση, χωρίς βιβλιοθήκες συστήματος για εγκατάσταση, και χωρίς να απαιτείται 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).


Γρήγορη Εκκίνηση: Δημιουργία Παρουσίασης με Σχήμα

Το παρακάτω script δημιουργεί μια νέα παρουσίαση, προσθέτει ένα ορθογώνιο με κείμενο και το αποθηκεύει ως ένα .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 / serverless: Η βιβλιοθήκη λειτουργεί μέσα σε ελαφριές εικόνες 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

Πρόσθετοι Πόροι

 Ελληνικά