التثبيت

تثبيت Aspose.Slides FOSS لـ Python

Aspose.Slides FOSS for Python is distributed as a pure-Python package on PyPI. Its only external dependency is lxml,التي يتم تثبيت النطاق التلقائي: لا توجد إضافات أصلية لتركيبها، لا مكتبات النظام لتثبتها ولا مايكروسوفت أو أي وقت تشغيل خاص آخر مطلوب.

المعايير

1. Install via pip (Recommended)

أسهل طريقة لتثبيت Aspose.Slides FOSS هي مباشرة من PyPI:

pip install aspose-slides-foss

يرفع الباب ويقوم بتثبيت الحزمة مع lxml لا حاجة إلى تثبيت ما بعد التثبيط.

لتثبيت نسخة مرفوعة للتركيبات قابلة للتكرار:

pip install aspose-slides-foss

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

منصة ملاحظات

ويندوز، ماكوس، لينكس: المكتبة هي نفسها على جميع المنصات.لا توجد مسارات رمزية محددة للمنصة أو التمديدات الثنائية خارج lxml.

الخادم / الخادمة : يعمل المكتبة داخل صور Docker الضيقة (مثل: python:3.12-slim) مع pip install aspose-slides-foss.لا تحتاج إلى حزم إضافية من apt أو yum ما لم تكن مطلوبة. lxml تحتاج إلى تجميع من المصدر (تغطي عجلة PyPI الهندسة المعمارية المشتركة).

CI/CD: إضافة pip install aspose-slides-foss إلى مرحلة الاعتماد على خط أنابيب CI الخاص بك. لا يتطلب إعدادات إضافية.

كوندا : إذا كان مشروعك يستخدم كوندا، قم بتثبيت مكتبة من PyPI داخل بيئة كوندا:

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

الموارد الإضافية

• صفحة المنتج: نظرة عامة ، ملخص الميزات ، والبدء السريع
• الترخيص: تفاصيل رخصة MIT ، لا مطلوب مفتاح API
• دليل المطور: دليل الميزات مع أمثلة الرمز
• إشارة API: الدرجة والطريقة مرجعية