Cum să începeți cu Aspose.Slides FOSS pentru Java

aspose-slides-foss pentru Java este o bibliotecă gratuită, licențiată MIT, pentru crearea și editarea fișierelor PowerPoint .pptx — nu este necesar Microsoft Office, disponibilă pe Maven Central.

Ghid pas cu pas

Pasul 1: Adăugați dependența Maven

Adăugați dependența la pom.xml (Java 21 sau o versiune ulterioară este necesară):

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

Verificați că pachetul se rezolvă corect prin construirea proiectului:

mvn dependency:resolve

Pasul 2: Importă clasele necesare

Importați clasele de care aveți nevoie pentru încărcarea prezentărilor și salvare:

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;

Pasul 3: Creare prezentare

Construiți un Presentation fără argumente pentru a începe cu un diapozitiv gol. Folosiți întotdeauna
try-with-resources pentru a asigura eliberarea resurselor interne:

import org.aspose.slides.foss.Presentation;

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

Pasul 4: Adaugă o formă cu text

Folosiți slide.getShapes().addAutoShape() pentru a insera un dreptunghi, apoi apelați addTextFrame()
pentru a adăuga conținut text:

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

Pasul 5: Aplică o umplere și salvează

Setați o culoare de umplere solidă pe formă înainte de a salva:

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

Probleme comune și soluții

ClassNotFoundException pentru org.aspose.slides.foss.Presentation Dependența Maven nu este rezolvată. Rulați mvn dependency:resolve și verificați că artefactul este disponibil în Maven Central. Verificați versiunea în pom.xml.

UnsupportedOperationException la apelarea anumitor metode
Unele funcționalități (grafice, animații, export PDF) aruncă UnsupportedOperationException
în această versiune. Verificați secțiunea de limitări cunoscute din referința API înainte de a utiliza
funcționalități avansate.

Coordonatele formei par incorecte
Coordonatele și dimensiunile sunt în EMU (English Metric Units). Un punct este aproximativ
12700 EMU. Diapozitivul implicit este 9144000 × 6858000 EMU.

Fișierul nu a fost găsit la încărcarea unui PPTX existent
Furnizați o cale absolută sau asigurați-vă că directorul de lucru este setat corect:

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

Întrebări frecvente

Necesită aspose‑slides‑foss Microsoft Office?

Nu. Biblioteca creează și citește fișiere .pptx în mod nativ în Java pur, fără nicio dependență de Microsoft Office, automatizare COM sau API-uri Windows.

Ce versiuni de Java sunt suportate?

Java 21 sau o versiune ulterioară. Biblioteca rulează pe Windows, macOS, Linux și containere Docker.

Este biblioteca gratuită pentru utilizare comercială?

Da. Este lansat sub Licența MIT. Puteți utiliza, modifica și redistribui pentru orice scop, inclusiv aplicații comerciale.

Pot să încarc un fișier PPTX existent?

Da. Transmite calea fișierului către constructorul Presentation:

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

Trebuie să închid explicit prezentarea?

Da. Presentation implementează AutoCloseable. Folosiți întotdeauna try-with-resources (try (Presentation prs = new Presentation()) { ... }) pentru a garanta curățarea.