Инсталиране

Инсталиране на Aspose.Slides FOSS за Java

Aspose.Slides FOSS for Java се разпространява като стандартен Maven артефакт. Няма native разширения, няма системни библиотеки за инсталиране и не се изисква Microsoft Office или друг пропъртиран runtime.


Предпоставки

ИзискванеПодробности
Версия на Java21 или по-нова
Инструмент за изгражданеMaven 3.8+ or 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: Библиотеката е идентична на всички платформи. Тя е чист Java без специфичен за платформа native код.

Docker / serverless: Библиотеката работи в тънки Docker образи (като eclipse-temurin:21-jre-alpine). Не са необходими допълнителни системни пакети.

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


Допълнителни ресурси

  • Product Page: Общ преглед, резюме на функциите и бърз старт
  • License: Подробности за MIT лиценз, без необходимост от API ключ
  • Developer Guide: Ръководства за функции с примерен код
  • API Reference: Справка за класове и методи
 Български