التثبيت

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

Aspose.Slides FOSS for Java يتم توزيعه كحزمة Maven قياسية. لا يحتوي على امتدادات أصلية، ولا مكتبات نظام لتثبيتها، ولا يتطلب Microsoft Office أو أي بيئة تشغيل مملوكة أخرى.


المتطلبات المسبقة

المتطلبالتفاصيل
إصدار Java21 أو أحدث
أداة البناءMaven 3.8+ أو Gradle 7+
نظام التشغيلWindows، macOS، Linux (أي منصة تشغل JDK)
المترجم / أدوات البناءJDK 21+ (للتجميع)

1. التثبيت عبر Maven (مستحسن)

أضف التبعية التالية إلى pom.xml الخاص بك:

<dependency>
    <groupId>org.aspose.slides.foss</groupId>
    <artifactId>aspose-slides-foss</artifactId>
    <version>1.0.0</version>
</dependency>

يقوم Maven بتنزيل وتثبيت الحزمة مع جميع التبعيات المتعاقبة. لا يلزم أي تكوين بعد التثبيت.


2. التثبيت عبر Gradle

أضف ما يلي إلى build.gradle الخاص بك:

dependencies {
    implementation 'org.aspose.slides.foss:aspose-slides-foss:1.0.0'
}

أو في Kotlin DSL (build.gradle.kts):

dependencies {
    implementation("org.aspose.slides.foss:aspose-slides-foss:1.0.0")
}

3. التحقق من التثبيت

بعد إضافة الاعتماد، تحقق من أن المكتبة تُحمَّل بشكل صحيح ويمكن إنشاء Presentation:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.export.SaveFormat;

public class VerifyInstall {
    public static void main(String[] args) {
        try (Presentation prs = new Presentation()) {
            System.out.println("Aspose.Slides FOSS installed successfully");
            System.out.println("Slides in empty presentation: " + prs.getSlides().size());
        }
    }
}

الإخراج المتوقع:

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

البدء السريع: إنشاء عرض تقديمي مع شكل

البرنامج التالي ينشئ عرضًا تقديميًا جديدًا، يضيف مستطيلًا يحتوي على نص، ويحفظه كملف .pptx:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.export.SaveFormat;

public class QuickStart {
    public static void main(String[] args) {
        try (Presentation prs = new Presentation()) {
            var slide = prs.getSlides().get(0);

            // Add a rectangle shape and set its text
            var shape = slide.getShapes().addAutoShape(ShapeType.RECTANGLE, 50, 50, 400, 150);
            shape.addTextFrame("Hello from Aspose.Slides FOSS!");

            prs.save("hello.pptx", SaveFormat.PPTX);
        }
        System.out.println("Saved hello.pptx");
    }
}

مهم: يجب دائمًا استخدام Presentation داخل كتلة try-with-resources. هذا يضمن تنظيفًا صحيحًا للموارد الداخلية عند خروج الكتلة.


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

Windows, macOS, Linux: المكتبة متطابقة على جميع الأنظمة. إنها جافا صافية بدون أي شفرة أصلية خاصة بالمنصة.

Docker / serverless: المكتبة تعمل داخل صور Docker الخفيفة (مثل eclipse-temurin:21-jre-alpine). لا توجد حزم نظام إضافية مطلوبة.

CI/CD: أضف تبعية Maven إلى pom.xml وسيقوم خط أنابيب CI الخاص بك بحلها تلقائيًا.


موارد إضافية

  • Product Page: نظرة عامة، ملخص الميزات، والبدء السريع
  • License: تفاصيل MIT License، لا يلزم مفتاح API
  • Developer Guide: أدلة الميزات مع أمثلة الشيفرة
  • API Reference: مرجع الفئات والطرق
 العربية