Installatie

Waar deze pagina over gaat

Installeer Aspose.Slides for Java vanuit de Maven-repository van Aspose of als JAR-bestand, configureer de Linux-vereisten en controleer de installatie met een eerste programma.

Overzicht

Dit artikel legt uit hoe u Aspose.Slides for Java aan een project kunt toevoegen. Aspose.Slides for Java wordt gepubliceerd in de eigen Maven-repository van Aspose, niet in Maven Central, dus een Maven‑project moet die repository declareren. U kunt ook het JAR‑bestand downloaden en zelf aan het class‑path toevoegen. Beide routes eindigen met een klein programma dat bevestigt dat de bibliotheek werkt.

Aspose.Slides for Java vereist Microsoft PowerPoint niet. Het genereert programmatisch de noodzakelijke presentatiebestanden. Om de gegenereerde presentaties te bekijken, heeft u echter Microsoft PowerPoint of een andere presentatieweergave nodig.

Voorvereisten

Een Java Development Kit (JDK). Het project en de opdrachten in dit artikel hebben JDK 11 of hoger nodig. Bij JDK 11 geeft het programma dat de installatie controleert een waarschuwing weer die begint met “WARNING: An illegal reflective access operation has occurred”; dit beïnvloedt het resultaat niet en kan worden genegeerd.
Apache Maven, als u de Maven‑route gebruikt.
Op Linux zijn de fontconfig‑bibliotheek en ten minste één geïnstalleerd lettertype vereist. Zie Linux.

Installeren vanuit de Maven-repository

Aspose host de Java‑bibliotheken in zijn eigen Maven-repository. Om Aspose.Slides for Java in een Maven‑project te gebruiken, voegt u twee items toe aan uw pom.xml.

Declareer de Aspose Maven‑repository.

<repositories>
    <repository>
        <id>AsposeJavaAPI</id>
        <name>Aspose Java API</name>
        <url>https://releases.aspose.com/java/repo/</url>
    </repository>
</repositories>

Voeg de Aspose.Slides for Java‑afhankelijkheid toe.

<dependencies>
    <dependency>
        <groupId>com.aspose</groupId>
        <artifactId>aspose-slides</artifactId>
        <version>26.10</version>
        <classifier>jdk8</classifier>
    </dependency>
</dependencies>

De jdk8‑classifier is vereist: deze selecteert de Java‑SE‑build van de bibliotheek. Vervang 26.10 door de nieuwste versie die in de repository staat vermeld. De repository publiceert een SHA‑1‑checksum‑bestand naast elke JAR, die Maven controleert bij het downloaden van de bibliotheek.

Controleer de installatie

Om de installatie met een nieuw project te controleren:

Maak een map voor het project en sla dit pom.xml daarin op:

<project xmlns="http://maven.apache.org/POM/4.0.0">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>hello-slides</artifactId>
    <version>1.0</version>

    <properties>
        <maven.compiler.release>11</maven.compiler.release>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <exec.mainClass>HelloSlides</exec.mainClass>
    </properties>

    <repositories>
        <repository>
            <id>AsposeJavaAPI</id>
            <name>Aspose Java API</name>
            <url>https://releases.aspose.com/java/repo/</url>
        </repository>
    </repositories>

    <dependencies>
        <dependency>
            <groupId>com.aspose</groupId>
            <artifactId>aspose-slides</artifactId>
            <version>26.10</version>
            <classifier>jdk8</classifier>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.15.0</version>
            </plugin>
        </plugins>
    </build>
</project>

Naast de repository en de afhankelijkheid stelt dit pom.xml de Java‑release in waarvoor moet worden gecompileerd, geeft de klas op die mvn exec:java uitvoert, en pin de compiler‑plugin, omdat de oudere plugin die sommige Maven‑installaties standaard gebruiken de instelling maven.compiler.release negeert.

Sla het eerste voorbeeld in Presentaties maken op als src/main/java/HelloSlides.java.
Voer in de projectmap uit:
```
mvn compile exec:java
```

Maven download Aspose.Slides for Java, compileert het programma en voert het uit. Het programma slaat new_presentation.pptx op in de projectmap.

Gebruik het JAR‑bestand zonder Maven

Download aspose-slides-26.10-jdk8.jar uit de versiemap in de repository. Voor een andere versie opent u de map in de repository en downloadt u het bestand dat eindigt op -jdk8.jar.
Sla het eerste voorbeeld in Presentaties maken op als HelloSlides.java in dezelfde map als het JAR‑bestand.

Voer in die map uit:

java -cp aspose-slides-26.10-jdk8.jar HelloSlides.java

De JDK compileert en voert het enkele bronbestand uit, en het programma slaat new_presentation.pptx op in de map. Voeg in uw eigen toepassing het JAR‑bestand toe aan het class‑path in uw build‑tool of IDE.

Linux

Aspose.Slides for Java maakt gebruik van de lettertype‑ondersteuning van Java, die op Linux de fontconfig‑bibliotheek en ten minste één geïnstalleerd lettertype nodig heeft. Zonder deze faalt het opslaan van een presentatie met de foutmelding “Fontconfig head is null, check your fonts or fonts configuration”. Minimale server‑ en container‑images kunnen beide missen; de officiële Ubuntu‑container‑image bijvoorbeeld heeft geen van beide.

Op Debian en Ubuntu installeert deze opdracht een JDK, Maven, fontconfig en de DejaVu‑lettertypen:

sudo apt-get update && sudo apt-get install -y default-jdk maven fontconfig fonts-dejavu-core

De lettertypen die in uw presentaties worden gebruikt, of geschikte vervangers, moeten ook geïnstalleerd zijn zodat tekst correct wordt weergegeven.

FAQ

Hoe kan ik verifiëren dat Aspose.Slides correct is geïntegreerd?

Bouw uw project, maak een lege Presentation aan en sla deze onder een nieuwe naam op. Als het bestand wordt aangemaakt zonder uitzondering te werpen, is de bibliotheek succesvol geïntegreerd.

Hoe kan ik het memory‑verbruik beperken bij het verwerken van grote presentaties?

Verhoog de JVM‑geheugenlimieten alleen zoveel als nodig is, en roep dispose aan op elke Presentation‑instantie in een finally‑blok om de cache snel vrij te geven. Dit voorkomt out‑of‑memory‑fouten en houdt het totale geheugengebruik voorspelbaar tijdens batch‑operaties.

Kan ik ongewenste exportformaten uitsluiten om de uiteindelijke JAR‑grootte te verkleinen?

Huidige Aspose.Slides‑releases worden geleverd als één monolithische bibliotheek, dus u kunt specifieke exporters zoals PDF of SVG niet uitschakelen tijdens het bouwen.

Declaratie Hoe Aspose.Slides voor Java te gebruiken in Docker