Kā sākt darbu ar Aspose.Slides FOSS for Java

aspose-slides-foss Java valodai ir bezmaksas, MIT licencēta bibliotēka PowerPoint .pptx failu izveidei un rediģēšanai — nav vajadzīgs Microsoft Office, pieejama Maven Central.

Solī pa solim ceļvedis

1. solis: Pievienojiet Maven atkarību

Pievienojiet atkarību savam pom.xml (nepieciešams Java 21 vai jaunāks):

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

Pārbaudiet, vai pakotne tiek pareizi atrisināta, veidojot projektu:

mvn dependency:resolve

2. solis: Importēt nepieciešamās klases

Importējiet klases, kas nepieciešamas prezentāciju ielādēšanai un saglabāšanai:

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;

3. solis: Izveidot prezentāciju

Izveidojiet Presentation bez argumentiem, lai sāktu ar vienu tukšu slaidu. Vienmēr izmantojiet
try-with-resources, lai nodrošinātu iekšējo resursu atbrīvošanu:

import org.aspose.slides.foss.Presentation;

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

4. solis: Pievienot formu ar tekstu

Izmantojiet slide.getShapes().addAutoShape(), lai ievietotu taisnstūri, pēc tam izsauciet addTextFrame() lai pievienotu teksta saturu:

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

Solis 5: Pielietojiet aizpildījumu un saglabājiet

Iestatiet vienkrāsainu aizpildījuma krāsu uz formas pirms saglabāšanas:

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

Vispārējās problēmas un risinājumi

ClassNotFoundException for org.aspose.slides.foss.Presentation
Maven atkarība nav atrisināta. Izpildiet mvn dependency:resolve un pārbaudiet, vai
artefakts ir pieejams Maven Central. Pārbaudiet versiju pom.xml.

UnsupportedOperationException izsaucot noteiktas metodes Dažas funkcijas (diagrammas, animācijas, PDF eksportēšana) izsauc UnsupportedOperationException šajā laidienā. Pārbaudiet zināmo ierobežojumu sadaļu API atsaucē, pirms izmantojat papildu funkcijas.

Formas koordinātas izskatās nepareizi Koordinātas un izmēri ir EMU (English Metric Units). Viens punkts ir aptuveni 12700 EMU. Noklusējuma slaids ir 9144000 × 6858000 EMU.

Fails nav atrasts, ielādējot esošu PPTX Norādiet absolūto ceļu vai pārliecinieties, ka darba direktorija ir pareizi iestatīta:

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

Biežāk uzdotie jautājumi

Vai aspose-slides-foss pieprasa Microsoft Office?

Nē. Bibliotēka izveido un lasa .pptx failus ērti tīrā Java, bez atkarības no Microsoft Office, COM automatizācijas vai Windows API.

Kādas Java versijas tiek atbalstītas?

Java 21 vai jaunāka. Bibliotēka darbojas Windows, macOS, Linux un Docker konteineros.

Vai bibliotēka ir bezmaksas komerciālai lietošanai?

Jā. Tas ir izlaists zem MIT licences. Jūs varat izmantot, modificēt un izplatīt to par jebkuru mērķi, ieskaitot komerciālas lietojumprogrammas.

Vai es varu ielādēt esošu PPTX failu?

Jā. Padodiet faila ceļu Presentation konstruktoram:

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

Vai man jāaizver Presentation eksplicīti?

Jā. Presentation implementē AutoCloseable. Vienmēr lietojiet try-with-resources (try (Presentation prs = new Presentation()) { ... }), lai nodrošinātu tīrīšanu.