Установка

О чём эта страница

Установите Aspose.Slides for Java из Maven-репозитория Aspose или как JAR-файл, настройте предварительные требования Linux и проверьте установку с помощью первой программы.

Обзор

В этой статье объясняется, как добавить Aspose.Slides for Java в проект. Aspose.Slides for Java публикуется в собственном Maven‑репозитории Aspose, а не в Maven Central, поэтому Maven‑проект должен объявить этот репозиторий. Вы также можете скачать файл JAR и добавить его в путь классов вручную. Оба пути завершаются небольшим программным примером, подтверждающим, что библиотека работает.

Aspose.Slides for Java не требует Microsoft PowerPoint. Он программно генерирует необходимые файлы презентаций. Однако для просмотра сгенерированных презентаций может потребоваться Microsoft PowerPoint или другой просмотрщик презентаций.

Требования

Java Development Kit (JDK). Проект и команды в этой статье требуют JDK 11 или новее. В JDK 11 программа, проверяющая установку, выводит предупреждение, начинающееся с «WARNING: An illegal reflective access operation has occurred»; оно не влияет на результат и может быть проигнорировано.
Apache Maven, если вы используете Maven‑маршрут.
В Linux требуется библиотека fontconfig и по крайней мере один установленный шрифт. См. Linux.

Установка из Maven‑репозитория

Aspose размещает свои Java‑библиотеки в собственном Maven‑репозитории. Чтобы использовать Aspose.Slides for Java в Maven‑проекте, добавьте две записи в ваш pom.xml.

Указать репозиторий Maven Aspose.

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

Добавить зависимость Aspose.Slides for Java.

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

Классификатор jdk8 обязателен: он выбирает сборку библиотеки для Java SE. Замените 26.10 на последнюю версию, указанную в репозитории. Репозиторий публикует файл контрольной суммы SHA‑1 рядом с каждым JAR, который Maven проверяет при загрузке библиотеки.

Проверка установки

Чтобы проверить настройку в новом проекте:

Создайте папку для проекта и сохраните в ней этот 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>

Помимо репозитория и зависимости, этот pom.xml задаёт целевую версию Java для компиляции, указывает класс, который запускает mvn exec:java, и фиксирует плагин компилятора, поскольку старый плагин, используемый по умолчанию в некоторых установках Maven, игнорирует настройку maven.compiler.release.

Сохраните первый пример из Create Presentations как src/main/java/HelloSlides.java.
В папке проекта выполните:
```
mvn compile exec:java
```

Maven загружает Aspose.Slides for Java, компилирует программу и запускает её. Программа сохраняет new_presentation.pptx в папке проекта.

Использование JAR‑файла без Maven

Скачайте aspose-slides-26.10-jdk8.jar из папки версии в репозитории. Для другой версии откройте её папку в репозитории и скачайте файл, оканчивающийся на -jdk8.jar.
Сохраните первый пример из Create Presentations как HelloSlides.java в той же папке, что и JAR‑файл.

В этой папке выполните:

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

JDK компилирует и запускает единственный исходный файл, и программа сохраняет new_presentation.pptx в папке. В вашем собственном приложении добавьте JAR‑файл в путь классов вашего инструмента сборки или IDE.

Linux

Aspose.Slides for Java использует поддержку шрифтов Java, которая в Linux требует библиотеку fontconfig и как минимум один установленный шрифт. Без них сохранение презентации завершается ошибкой «Fontconfig head is null, check your fonts or fonts configuration». Минимальные серверные и контейнерные образы могут не содержать ни того, ни другого; например, официальный контейнерный образ Ubuntu не содержит ни того, ни другого.

В Debian и Ubuntu эта команда устанавливает JDK, Maven, fontconfig и шрифты DejaVu:

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

Шрифты, используемые в ваших презентациях, или подходящие их заменители также должны быть установлены для корректного отображения текста.

FAQ

Как проверить, что Aspose.Slides интегрирован правильно?

Соберите ваш проект, создайте пустой объект Presentation и сохраните его под новым именем. Если файл создаётся без выбрасывания исключений, библиотека успешно интегрирована.

Как ограничить потребление памяти при обработке больших презентаций?

Увеличивайте лимиты памяти JVM только до необходимого уровня и вызывайте dispose для каждого экземпляра Presentation в блоке finally, чтобы быстро освобождать кэш. Это предотвращает ошибки out‑of‑memory и сохраняет предсказуемое общее использование памяти во время пакетных операций.

Можно ли исключить ненужные форматы экспорта, чтобы уменьшить конечный размер JAR?

Текущие выпускаемые версии Aspose.Slides поставляются как единая монолитная библиотека, поэтому отключить отдельные экспортеры, такие как PDF или SVG, на этапе сборки невозможно.

Декларация Как запустить Aspose.Slides для Java в Docker