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.

Требования

ТребованиеПодробности
Java версия21 or later
Инструмент сборкиMaven 3.8+ or 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. Это обеспечивает правильную очистку внутренних ресурсов при выходе из блока.

Примечания к платформе

Windows, macOS, Linux: Библиотека идентична на всех платформах. Она полностью написана на Java и не содержит специфичного для платформы нативного кода.

Docker / serverless: Библиотека работает внутри облегчённых Docker-образов (например, eclipse-temurin:21-jre-alpine). Не требуется дополнительных системных пакетов.

CI/CD: Добавьте зависимость Maven в ваш pom.xml и ваш CI pipeline автоматически её разрешит.

Дополнительные ресурсы

 Русский