Aspose.Slides FOSS
Java
Kako započeti s Aspose.Slides FOSS za Javu

Kako započeti s Aspose.Slides FOSS za Javu

aspose-slides-foss za Javu je besplatna, MIT‑licencirana biblioteka za stvaranje i uređivanje PowerPoint .pptx datoteka — nije potreban Microsoft Office, dostupna na Maven Centralu.

Vodič korak po korak

Korak 1: Dodajte Maven ovisnost

Dodajte ovisnost u svoj pom.xml (potreban je Java 21 ili noviji):

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

Provjerite je li paket ispravno razriješen izgradnjom projekta:

mvn dependency:resolve

Korak 2: Uvezi potrebne klase

Uvezite klase koje su vam potrebne za učitavanje prezentacija i spremanje:

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;

Korak 3: Izradi prezentaciju

Konstruirajte Presentation bez argumenata kako biste započeli s jednim praznim slajdom. Uvijek koristite
try-with-resources kako biste osigurali da se interni resursi oslobode:

import org.aspose.slides.foss.Presentation;

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

Korak 4: Dodaj oblik s tekstom

Koristite slide.getShapes().addAutoShape() za umetanje pravokutnika, a zatim pozovite addTextFrame() za dodavanje tekstualnog sadržaja:

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

Korak 5: Primijeni ispunu i spremi

Postavite jednolitru boju ispune na oblik prije spremanja:

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

Uobičajeni problemi i rješenja

ClassNotFoundException for org.aspose.slides.foss.Presentation Maven ovisnost nije razriješena. Pokrenite mvn dependency:resolve i provjerite je li artefakt dostupan u Maven Centralu. Provjerite verziju u pom.xml.

UnsupportedOperationException prilikom pozivanja određenih metoda
Neke značajke (grafikoni, animacije, izvoz u PDF) bacaju UnsupportedOperationException u ovoj verziji. Provjerite odjeljak poznatih ograničenja u referenciji API-ja prije korištenja naprednih značajki.

Koordinate oblika izgledaju pogrešno
Koordinate i dimenzije su u EMU (English Metric Units). Jedna točka je približno 12700 EMU. Zadani slajd je 9144000 × 6858000 EMU.

Datoteka nije pronađena prilikom učitavanja postojećeg PPTX Proslijedite apsolutnu putanju ili osigurajte da je radni direktorij ispravno postavljen:

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

Često postavljana pitanja

Zahtijeva li aspose-slides-foss Microsoft Office?

Ne. Biblioteka stvara i čita .pptx datoteke izvorno u čistom Javi bez ovisnosti o Microsoft Officeu, COM automatizaciji ili Windows API‑ima.

Koje Java verzije su podržane?

Java 21 ili noviji. Biblioteka radi na Windowsu, macOS‑u, Linuxu i Docker kontejnerima.

Je li biblioteka besplatna za komercijalnu upotrebu?

Da. Objavljen je pod licencom MIT. Možete ga koristiti, mijenjati i redistribuirati u bilo koju svrhu, uključujući komercijalne aplikacije.

Mogu li učitati postojeću PPTX datoteku?

Da. Proslijedite putanju datoteke konstruktoru Presentation:

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

Treba li eksplicitno zatvoriti Presentation?

Da. Presentation implementira AutoCloseable. Uvijek koristite try-with-resources (try (Presentation prs = new Presentation()) { ... }) kako biste osigurali čišćenje.

Vidi također

 Hrvatski