Hvordan man begynder med Aspose.Slides FOSS til Java

aspose-slides-foss for Java er et gratis, MIT-licenseret bibliotek til at oprette og redigere. PowerPoint .pptx filer der ikke kræves Microsoft Office, som er tilgængelige på Maven Central.

Trin-for-trin vejledning

Trin 1: Tilføj Maven-afhængigheden

Tilføj afhængigheden til din pom.xml (Krav til Java 21 eller nyere):

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

Kontrollér, at pakken løser korrekt ved at bygge projektet:

mvn dependency:resolve

Trin 2: Import af krævede klasser

Import af klasser, du har brug for til at indlæse og gemme præsentationer:

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;

Trin 3: Lav en præsentation

Konstruer en Presentation Med en tom slide. Brug altid at sikre, at interne ressourcer frigives:

import org.aspose.slides.foss.Presentation;

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

Trin 4: Tilføj en form med tekst

Anvendelse: slide.getShapes().addAutoShape() at indsætte et rektangel, og derefter ringe til addTextFrame() at tilføje tekstindhold:

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

Trin 5: Anvend en fyld og gem den

Indstil en solid fyldfarve på formen før du gemmer:

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

Almindelige problemer og løsninger

ClassNotFoundException for: org.aspose.slides.foss.Presentation Maven-afhængigheden er ikke løst. mvn dependency:resolve og kontrollere, at den Det er muligt at få artefaktet i Maven Central. pom.xml.

UnsupportedOperationException ved opkald af visse metoder Nogle funktioner (diagrammer, animationer, PDF-eksport) kasserer UnsupportedOperationException I denne udgave. Tjek de kendte begrænsninger i API-referencen, før du bruger avancerede funktioner.

Formen koordinater ser ud til at være off Koordinater og dimensioner er i EMU (engelsk metrisk enhed). Et punkt er ca. 12700 EMU. The default slide is 9144000 × 6858000 EMU.

Filer ikke fundet ved indlæse af et eksisterende PPTX-program Passer en absolut vej eller sørg for, at arbejdsmappen er korrekt indsat:

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

Ofte stillede spørgsmål

Er det nødvendigt at bruge Microsoft Office?

Biblioteket skaber og læser. .pptx filer i Java uden afhængighed på Microsoft Office, COM-automation eller Windows API’er.

Hvilke Java-versioner understøttes?

Java 21 eller nyere. Biblioteket kører på Windows, macOS, Linux og Docker-containere.

Er biblioteket gratis til kommerciel brug?

Ja. Den er udgivet under MIT-licensen. Du kan bruge, ændre og videregiv den til ethvert formål, herunder kommercielle applikationer.

Kan jeg indlæse en eksisterende PPTX fil?

Ja, giv filvejen til… Presentation konstruktor:

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

Skal jeg lukke præsentationen?

Ja, det er jeg. Presentation indgrebsværktøjer AutoCloseable.- Brug altid ressourcer. (try (Presentation prs = new Presentation()) { ... }) for at sikre rengøring.