نصب

نصب 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.

پیش‌نیازها

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'
}

یا در 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 / بدون سرور: کتابخانه داخل تصاویر Docker سبک (مانند eclipse-temurin:21-jre-alpine). هیچ بستهٔ سیستم اضافی مورد نیاز نیست.

CI/CD: وابستگی Maven را به پروژه‌تان اضافه کنید. pom.xml و خط لوله CI شما به‌صورت خودکار آن را حل خواهد کرد.

منابع اضافی

• صفحه محصول: مرور کلی، خلاصه ویژگی‌ها، و شروع سریع
• مجوز: جزئیات مجوز MIT، بدون نیاز به کلید API
• راهنمای توسعه‌دهنده: راهنماهای ویژگی با مثال‌های کد
• مرجع API: مرجع کلاس و متد