Erste Schritte mit Aspose.Slides FOSS für Java

aspose-slides-foss für Java ist eine kostenlose, MIT‑lizenzierte Bibliothek zum Erstellen und Bearbeiten von PowerPoint .pptx‑Dateien — kein Microsoft Office erforderlich, verfügbar im Maven Central.

Schritt-für-Schritt-Anleitung

Schritt 1: Maven‑Abhängigkeit hinzufügen

Fügen Sie die Abhängigkeit zu Ihrem pom.xml hinzu (Java 21 oder höher erforderlich):

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

Überprüfen Sie, ob das Paket korrekt aufgelöst wird, indem Sie das Projekt bauen:

mvn dependency:resolve

Schritt 2: Erforderliche Klassen importieren

Importieren Sie die Klassen, die Sie zum Laden von Präsentationen und zum Speichern benötigen:

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;

Schritt 3: Präsentation erstellen

Erstellen Sie ein Presentation ohne Argumente, um mit einer leeren Folie zu beginnen. Verwenden Sie stets
try-with-resources, um sicherzustellen, dass interne Ressourcen freigegeben werden:

import org.aspose.slides.foss.Presentation;

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

Schritt 4: Eine Form mit Text hinzufügen

Verwenden Sie slide.getShapes().addAutoShape(), um ein Rechteck einzufügen, dann rufen Sie addTextFrame()
auf, um Textinhalt hinzuzufügen:

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");
}

Schritt 5: Füllung anwenden und speichern

Legen Sie vor dem Speichern eine einfarbige Füllfarbe für die Form fest:

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");
}

Häufige Probleme und Lösungen

ClassNotFoundException für org.aspose.slides.foss.Presentation
Die Maven‑Abhängigkeit ist nicht aufgelöst. Führen Sie mvn dependency:resolve aus und prüfen Sie, dass das
Artefakt in Maven Central verfügbar ist. Überprüfen Sie die Version in pom.xml.

UnsupportedOperationException beim Aufrufen bestimmter Methoden Einige Funktionen (Diagramme, Animationen, PDF‑Export) werfen UnsupportedOperationException in dieser Version. Überprüfen Sie den Abschnitt „Bekannte Einschränkungen“ der API‑Referenz, bevor Sie erweiterte Funktionen verwenden.

Formkoordinaten scheinen falsch zu sein Koordinaten und Abmessungen sind in EMU (English Metric Units). Ein Punkt entspricht ungefähr 12700 EMU. Die Standardfolie hat 9144000 × 6858000 EMU.

Datei nicht gefunden beim Laden einer bestehenden PPTX
Geben Sie einen absoluten Pfad an oder stellen Sie sicher, dass das Arbeitsverzeichnis korrekt gesetzt ist:**

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

Häufig gestellte Fragen

Benötigt aspose-slides-foss Microsoft Office?

Nein. Die Bibliothek erstellt und liest .pptx‑Dateien nativ in reinem Java ohne Abhängigkeit von Microsoft Office, COM‑Automatisierung oder Windows‑APIs.

Welche Java-Versionen werden unterstützt?

Java 21 oder höher. Die Bibliothek läuft unter Windows, macOS, Linux und Docker‑Containern.

Ist die Bibliothek für die kommerzielle Nutzung kostenlos?

Ja. Es wird unter der MIT-Lizenz veröffentlicht. Sie dürfen es für jeden Zweck nutzen, modifizieren und weiterverbreiten, einschließlich kommerzieller Anwendungen.

Kann ich eine vorhandene PPTX-Datei laden?

Ja. Übergeben Sie den Dateipfad an den Presentation‑Konstruktor:

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

Muss ich die Presentation explizit schließen?

Ja. Presentation implementiert AutoCloseable. Verwenden Sie immer try-with-resources (try (Presentation prs = new Presentation()) { ... }), um die Bereinigung zu gewährleisten.