Як розпочати роботу з Aspose.Slides FOSS для Java

aspose-slides-foss для Java — це безкоштовна бібліотека з ліцензією MIT для створення та редагування файлів PowerPoint .pptx — без необхідності у Microsoft Office, доступна в Maven Central.

Покроковий посібник

Крок 1: Додайте залежність Maven

Додайте залежність до вашого pom.xml (потрібен Java 21 або новіший):

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

Перевірте, чи пакет правильно розв’язується, збираючи проект:

mvn dependency:resolve

Крок 2: Імпорт необхідних класів

Імпортуйте класи, які потрібні для завантаження презентацій та збереження:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.FillType;

Крок 3: Створити презентацію

Створіть Presentation без аргументів, щоб розпочати з одного порожнього слайду. Завжди використовуйте
try-with-resources, щоб забезпечити звільнення внутрішніх ресурсів:

import org.aspose.slides.foss.Presentation;

try (Presentation prs = new Presentation()) {
    System.out.println("Slides: " + prs.getSlides().size());
    prs.save("new_presentation.pptx");
}

Крок 4: Додати форму з текстом

Використайте slide.getShapes().addAutoShape(), щоб вставити прямокутник, потім викличте addTextFrame(), щоб додати текстовий вміст:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IPortionFormat;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.NullableBool;

try (Presentation prs = new Presentation()) {
    ISlide slide = prs.getSlides().get(0);
    IAutoShape shape = slide.getShapes().addAutoShape(
        ShapeType.RECTANGLE, 50, 50, 400, 150
    );
    ITextFrame tf = shape.addTextFrame("Hello from Aspose.Slides FOSS!");
    IPortionFormat fmt = tf.getParagraphs().get(0).getPortions().get(0).getPortionFormat();
    fmt.setFontHeight(24);
    fmt.setFontBold(NullableBool.TRUE);
    prs.save("with_shape.pptx");
}

Крок 5: Застосувати заповнення та зберегти

Встановіть суцільний колір заливки для форми перед збереженням:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.drawing.Color;

try (Presentation prs = new Presentation()) {
    IAutoShape shape = prs.getSlides().get(0).getShapes().addAutoShape(
        ShapeType.RECTANGLE, 100, 100, 400, 200
    );
    shape.getFillFormat().setFillType(FillType.SOLID);
    shape.getFillFormat().getSolidFillColor().setColor(new Color(70, 130, 180));
    shape.addTextFrame("Styled shape");
    prs.save("styled.pptx");
}

Поширені проблеми та виправлення

ClassNotFoundException for org.aspose.slides.foss.Presentation Залежність Maven не розв’язана. Запустіть mvn dependency:resolve і перевірте, чи артефакт доступний у Maven Central. Перевірте версію у pom.xml.

UnsupportedOperationException при виклику певних методів
Деякі функції (діаграми, анімації, експорт PDF) генерують UnsupportedOperationException
у цьому випуску. Перевірте розділ відомих обмежень у довідці API перед використанням
розширених функцій.

Координати форми здаються неправильними
Координати та розміри вказані в EMU (English Metric Units). Одна точка приблизно
12700 EMU. Типовий слайд має розмір 9144000 × 6858000 EMU.

Файл не знайдено під час завантаження існуючого PPTX
Вкажіть абсолютний шлях або переконайтеся, що робочий каталог встановлений правильно:

import java.nio.file.Paths;
String path = Paths.get("presentations", "existing.pptx").toAbsolutePath().toString();
try (Presentation prs = new Presentation(path)) { ... }

Часті запитання

Чи потребує aspose-slides-foss Microsoft Office?

Ні. Бібліотека створює та читає файли .pptx нативно на чистій Java без залежності від Microsoft Office, COM‑автоматизації чи Windows API.

Які версії Java підтримуються?

Java 21 або новішої версії. Бібліотека працює на Windows, macOS, Linux та в Docker‑контейнерах.

Чи є бібліотека безкоштовною для комерційного використання?

Так. Він випущений під ліцензією MIT. Ви можете використовувати, змінювати та розповсюджувати його для будь-яких цілей, включаючи комерційні застосування.

Чи можу я завантажити існуючий файл PPTX?

Так. Передайте шлях до файлу конструктору Presentation:

try (Presentation prs = new Presentation("existing.pptx")) {
    System.out.println("Loaded " + prs.getSlides().size() + " slides");
    prs.save("copy.pptx");
}

Чи потрібно явно закривати Presentation?

Так. Presentation реалізує AutoCloseable. Завжди використовуйте try-with-resources (try (Presentation prs = new Presentation()) { ... }), щоб гарантувати очищення.