התקנה

התקנה של 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 או בזמן ריצה קנייני אחר.

דרישות קדם

1. Install via pip (Recommended)

הדרך הפשוטה ביותר להתקין את Aspose.Slides FOSS היא ישירות מ‑PyPI:

pip install aspose-slides-foss

pip מוריד ומתקין את החבילה יחד עם ה lxml תלות. אין צורך בתצורת post-install.

להתקנת גרסה קבועה לבנייה ניתנת לשחזור:

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 / serverless: הספרייה פועלת בתוך תמונות Docker רזות (כגון python:3.12-slim) עם pip install aspose-slides-foss. אין צורך בחבילות apt או yum נוספות אלא אם lxml צריך לקמפל ממקור (גלגלת PyPI מכסה ארכיטקטורות נפוצות).

CI/CD: הוסף pip install aspose-slides-foss לתלות של צינור ה‑CI שלך. אין צורך בהגדרה נוספת.

Conda: אם הפרויקט שלך משתמש ב‑Conda, התקן את הספרייה מ‑PyPI בתוך סביבת Conda:

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

משאבים נוספים

• דף מוצר: סקירה, סיכום תכונות, והתחלה מהירה
• רישיון: פרטי רישיון MIT, אין צורך במפתח API
• מדריך למפתחים: מדריכי תכונות עם דוגמאות קוד
• תיעוד API: תיעוד מחלקות ושיטות