Как да започнете с 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 Винаги използвайте: да се осигури освобождаването на вътрешни ресурси:

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 за: org.aspose.slides.foss.Presentation Зависимостта от Мейвън не е разрешена. mvn dependency:resolve и проверете дали Артефактът е на разположение в Maven Central. Проверете версията в pom.xml.

UnsupportedOperationException при повикване на определени методи Някои функции (чарти, анимации, PDF експорт) хвърляне UnsupportedOperationException Проверете раздела за известни ограничения на API референцията преди да използвате усъвършенствани функции.

Координатите на формата изглеждат различни. Координатите и размерите са в ЕМУ (английски метрични единици). 12700 EMU. The default slide is 9144000 × 6858000 EMU.

Файл не е намерен при зареждане на съществуващ PPTX Преминаване на абсолютен път или осигуряване правилното задаване в работната директория:

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

Често задавани въпроси

Искат ли се 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 (Presentation prs = new Presentation()) { ... }) за гарантиране на почистването.