التثبيت

تثبيت 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 الاعتماد. لا حاجة إلى أي تكوين بعد التثبيت.

لتثبيت نسخة محددة لضمان بناءات قابلة لإعادة الإنتاج:

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 عبارة). يضمن هذا تنظيفًا صحيحًا للموارد الداخلية عند خروج الكتلة.

ملاحظات المنصة

ويندوز، macOS، لينكس: المكتبة متطابقة على جميع الأنظمة. لا توجد مسارات شفرة أو امتدادات ثنائية خاصة بالمنصة تتجاوز 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: مرجع الفئات والطرق