Instalacja

O czym jest ta strona

Zainstaluj Aspose.Slides for Java z repozytorium Maven firmy Aspose lub jako plik JAR, skonfiguruj wymagania wstępne dla systemu Linux i sprawdź instalację pierwszym programem.

Przegląd

Ten artykuł wyjaśnia, jak dodać Aspose.Slides for Java do projektu. Aspose.Slides for Java jest publikowany w własnym repozytorium Maven firmy Aspose, a nie w Maven Central, więc projekt Maven musi zadeklarować to repozytorium. Można również pobrać plik JAR i ręcznie dodać go do classpath. Obie drogi kończą się krótkim programem, który potwierdza, że biblioteka działa.

Aspose.Slides for Java nie wymaga programu Microsoft PowerPoint. Programowo generuje niezbędne pliki prezentacji. Jednak aby oglądać wygenerowane prezentacje, może być potrzebny Microsoft PowerPoint lub inny przeglądarka prezentacji.

Wymagania wstępne

Zestaw Java Development Kit (JDK). Projekt oraz polecenia w tym artykule wymagają JDK 11 lub nowszego. W JDK 11 program sprawdzający instalację wypisuje ostrzeżenie zaczynające się od “WARNING: An illegal reflective access operation has occurred”; nie wpływa to na wynik i może być zignorowane.
Apache Maven, jeśli używasz drogi Maven.
Na Linuxie wymagana jest biblioteka fontconfig oraz co najmniej jedna zainstalowana czcionka. Zobacz Linux.

Instalacja z repozytorium Maven

Aspose udostępnia swoje biblioteki Java w własnym repozytorium Maven. Aby używać Aspose.Slides for Java w projekcie Maven, dodaj dwa wpisy do swojego pom.xml.

Zadeklaruj repozytorium Maven Aspose.

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

Dodaj zależność Aspose.Slides for Java.

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

Klasyfikator jdk8 jest wymagany: wybiera wersję biblioteki dla Java SE. Zastąp 26.10 najnowszą wersją wymienioną w repozytorium. Repozytorium publikuje plik sumy kontrolnej SHA‑1 obok każdego pliku JAR, który Maven weryfikuje podczas pobierania biblioteki.

Sprawdź instalację

Aby sprawdzić konfigurację w nowym projekcie:

Utwórz folder dla projektu i zapisz w nim ten pom.xml:

<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>

Oprócz repozytorium i zależności, ten pom.xml określa wersję Java do kompilacji, podaje nazwę klasy, którą uruchamia mvn exec:java, oraz ustawia konkretną wersję wtyczki kompilatora, ponieważ starsza wtyczka wykorzystywana domyślnie w niektórych instalacjach Maven ignoruje ustawienie maven.compiler.release.

Zapisz pierwszy przykład z Utwórz prezentacje jako src/main/java/HelloSlides.java.
W folderze projektu uruchom:
```
mvn compile exec:java
```

Maven pobiera Aspose.Slides for Java, kompiluje program i go uruchamia. Program zapisuje new_presentation.pptx w folderze projektu.

Użyj pliku JAR bez Maven

Pobierz aspose-slides-26.10-jdk8.jar z folderu wersji w repozytorium. Dla innej wersji otwórz jej folder w repozytorium i pobierz plik kończący się na -jdk8.jar.
Zapisz pierwszy przykład z Utwórz prezentacje jako HelloSlides.java w tym samym folderze co plik JAR.

W tym folderze uruchom:

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

JDK kompiluje i uruchamia pojedynczy plik źródłowy, a program zapisuje new_presentation.pptx w folderze. W własnej aplikacji dodaj plik JAR do classpath w używanym narzędziu budującym lub IDE.

Linux

Aspose.Slides for Java korzysta z obsługi czcionek Javy, co na Linuxie wymaga biblioteki fontconfig oraz co najmniej jednej zainstalowanej czcionki. Bez nich zapisywanie prezentacji kończy się błędem “Fontconfig head is null, check your fonts or fonts configuration”. Minimalne obrazy serwerów i kontenerów mogą nie mieć żadnego z nich; oficjalny obraz kontenera Ubuntu, na przykład, nie posiada żadnego.

W Debianie i Ubuntu to polecenie instalujące JDK, Maven, fontconfig i czcionki DejaVu:

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

Czcionki używane w Twoich prezentacjach lub odpowiednie zamienniki muszą być również zainstalowane, aby tekst był renderowany prawidłowo.

FAQ

Jak mogę zweryfikować, że Aspose.Slides jest poprawnie zintegrowany?

Zbuduj swój projekt, utwórz pustą Presentation i zapisz ją pod nową nazwą. Jeśli plik zostanie utworzony bez wyrzucania wyjątków, biblioteka została pomyślnie zintegrowana.

Jak mogę ograniczyć zużycie pamięci przy przetwarzaniu dużych prezentacji?

Podnoś limity pamięci JVM tylko do potrzebnego poziomu oraz wywołuj dispose na każdej instancji Presentation w bloku finally, aby niezwłocznie zwolnić pamięć podręczną. Zapobiega to błędom braku pamięci i utrzymuje przewidywalne zużycie pamięci podczas operacji wsadowych.

Czy mogę wykluczyć niepotrzebne formaty eksportu, aby zmniejszyć ostateczny rozmiar JAR?

Obecne wydania Aspose.Slides są dostarczane jako jedyna monolityczna biblioteka, więc nie można wyłączyć konkretnych eksporterów, takich jak PDF czy SVG, w czasie budowania.

Deklaracja Jak uruchomić Aspose.Slides dla języka Java w Dockerze