Aspose.Slides FOSS
Java
البدء
التثبيت

التثبيت

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

Aspose.Slides FOSS for Java is distributed as a standard Maven artifact. It has no native extensions, no system libraries to install, and no Microsoft Office or other proprietary runtime required.

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

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

1. Install via Maven (Recommended)

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

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

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

2. Install via 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. Verify the Installation

بعد إضافة الاعتماد، تحقق من أن المكتبة تُحمَّل بشكل صحيح و 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. يضمن ذلك تنظيفًا صحيحًا للموارد الداخلية عند خروج الكتلة.

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

ويندوز، macOS، لينكس: المكتبة متطابقة على جميع المنصات. إنها Java صافية دون أي شفرة أصلية خاصة بالمنصة.

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

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

موارد إضافية

 العربية