Aspose.Slides FOSS
Java
Как да започнете с Aspose.Slides FOSS за Java

Как да започнете с 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 реализира AutoCloseable. Винаги използвайте try-with-resources
(try (Presentation prs = new Presentation()) { ... }), за да гарантирате почистване.

Вижте също

 Български