Aspose.Slides FOSS
Java
Jak začít s Aspose.Slides FOSS pro Java

Jak začít s Aspose.Slides FOSS pro Java

aspose-slides-foss pro Javu je bezplatná knihovna s licencí MIT pro vytváření a úpravu souborů PowerPoint .pptx — není vyžadován Microsoft Office, dostupná na Maven Central.

Průvodce krok za krokem

Krok 1: Přidejte Maven závislost

Přidejte závislost do svého pom.xml (vyžadováno Java 21 nebo novější):

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

Ověřte, že balíček se správně vyřeší, sestavením projektu:

mvn dependency:resolve

Krok 2: Importovat požadované třídy

Importujte třídy, které potřebujete pro načítání prezentací a ukládání:

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;

Krok 3: Vytvořit prezentaci

Vytvořte Presentation bez argumentů, abyste začali s jedním prázdným snímkem. Vždy používejte try-with-resources k zajištění uvolnění vnitřních zdrojů:

import org.aspose.slides.foss.Presentation;

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

Krok 4: Přidat tvar s textem

Použijte slide.getShapes().addAutoShape() k vložení obdélníku, poté zavolejte addTextFrame() k přidání textového obsahu:

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

Krok 5: Použít výplň a uložit

Nastavte plnou barvu výplně na tvaru před uložením:

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

Časté problémy a opravy

ClassNotFoundException for org.aspose.slides.foss.Presentation Závislost Maven není vyřešena. Spusťte mvn dependency:resolve a zkontrolujte, že artefakt je dostupný v Maven Central. Ověřte verzi v pom.xml.

UnsupportedOperationException při volání určitých metod
Některé funkce (grafy, animace, export do PDF) vyvolávají UnsupportedOperationException v tomto vydání. Zkontrolujte sekci známých omezení v referenci API před použitím pokročilých funkcí.

Souřadnice tvaru se zdají být špatné
Souřadnice a rozměry jsou v EMU (English Metric Units). Jeden bod je přibližně
12700 EMU. Výchozí snímek má rozměry 9144000 × 6858000 EMU.

Soubor nebyl nalezen při načítání existujícího PPTX
Zadejte absolutní cestu nebo se ujistěte, že pracovní adresář je nastaven správně:

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

Často kladené otázky

Vyžaduje aspose-slides-foss Microsoft Office?

Ne. Knihovna vytváří a čte soubory .pptx nativně v čistém Javě bez závislosti na Microsoft Office, COM automatizaci nebo Windows API.

Které verze Javy jsou podporovány?

Java 21 nebo novější. Knihovna běží na Windows, macOS, Linuxu a v Docker kontejnerech.

Je knihovna zdarma pro komerční použití?

Ano. Je vydáno pod licencí MIT. Můžete jej používat, upravovat a redistribuovat pro jakýkoli účel, včetně komerčních aplikací.

Mohu načíst existující soubor PPTX?

Ano. Předávejte cestu k souboru do konstruktoru Presentation:

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

Musím prezentaci explicitně zavřít?

Ano. Presentation implementuje AutoCloseable. Vždy používejte try‑with‑resources (try (Presentation prs = new Presentation()) { ... }), aby byl zajištěn úklid.

Viz také

 Čeština