Kaip pradėti dirbti su Aspose.Slides FOSS for Java

aspose-slides-foss for Java yra nemokama, MIT licencijuota biblioteka, skirta kurti ir redaguoti PowerPoint .pptx failus — nereikia Microsoft Office, prieinama Maven Central.

Žingsnis po žingsnio vadovas

Žingsnis 1: pridėkite Maven priklausomybę

Pridėkite priklausomybę prie savo pom.xml (reikalinga Java 21 arba vėlesnė):

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

Patikrinkite, ar paketas teisingai išsprendžiamas, sukurdami projektą:

mvn dependency:resolve

Žingsnis 2: Importuoti reikiamas klases

Importuokite klases, kurių reikia prezentacijų įkėlimui ir išsaugojimui:

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;

Žingsnis 3: Sukurti prezentaciją

Sukurkite Presentation be argumentų, kad pradėtumėte su viena tuščia skaidre. Visada naudokite try-with-resources, kad užtikrintumėte vidinių išteklių atlaisvinimą:

import org.aspose.slides.foss.Presentation;

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

Žingsnis 4: Pridėti formą su tekstu

Naudokite slide.getShapes().addAutoShape(), kad įterptumėte stačiakampį, tada iškvieskite addTextFrame()
pridėti teksto turinį:

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

Žingsnis 5: taikyti užpildą ir išsaugoti

Nustatykite vientiso užpildymo spalvą figūrai prieš išsaugant:

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

Dažnos problemos ir sprendimai

ClassNotFoundException for org.aspose.slides.foss.Presentation Maven priklausomybė nėra išspręsta. Paleiskite mvn dependency:resolve ir patikrinkite, ar artefaktas yra prieinamas Maven Central. Patikrinkite versiją pom.xml.

UnsupportedOperationException kai iškviečiami tam tikri metodai Kai kurios funkcijos (diagramos, animacijos, PDF eksportas) išmeta UnsupportedOperationException šiame leidime. Patikrinkite žinomų apribojimų skyrių API nuorodoje prieš naudojant išplėstines funkcijas.

Formos koordinatės atrodo neteisingos Koordinatės ir matmenys yra EMU (English Metric Units). Vienas taškas yra maždaug 12700 EMU. Numatytoji skaidrė yra 9144000 × 6858000 EMU.

Failas nerastas įkeliant esamą PPTX Pateikite absoliutų kelią arba įsitikinkite, kad darbo katalogas nustatytas teisingai:

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

Dažniausiai užduodami klausimai

Ar aspose-slides-foss reikalauja Microsoft Office?

Ne. Biblioteka natūraliai sukuria ir skaito .pptx failus grynoje Java be jokios priklausomybės nuo Microsoft Office, COM automatizacijos ar Windows API.

Kokios Java versijos palaikomos?

Java 21 arba vėlesnė. Biblioteka veikia Windows, macOS, Linux ir Docker konteineriuose.

Ar biblioteka yra nemokama komerciniam naudojimui?

Taip. Ji išleista pagal MIT licenciją. Galite naudoti, modifikuoti ir platinti ją bet kokiam tikslui, įskaitant komercines programas.

Ar galiu įkelti esamą PPTX failą?

Taip. Perduokite failo kelią Presentation konstruktoriui:

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

Ar reikia aiškiai uždaryti prezentaciją?

Taip. Presentation įgyvendina AutoCloseable. Visada naudokite try-with-resources
(try (Presentation prs = new Presentation()) { ... }), kad užtikrintumėte išvalymą.