설치

이 페이지의 내용

Aspose의 Maven 저장소 또는 JAR 파일에서 Aspose.Slides for Java를 설치하고, Linux 전제 조건을 설정한 뒤 첫 번째 프로그램으로 설치를 확인합니다.

개요

이 문서는 프로젝트에 Aspose.Slides for Java를 추가하는 방법을 설명합니다. Aspose.Slides for Java는 Maven Central이 아니라 Aspose 자체 Maven 저장소에 게시되므로 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 저장소에 호스팅합니다. Maven 프로젝트에서 Aspose.Slides for Java를 사용하려면 pom.xml에 두 항목을 추가합니다.

Aspose Maven 저장소 선언.

<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.9</version>
        <classifier>jdk16</classifier>
    </dependency>
</dependencies>

jdk16 분류자는 필수입니다. 이는 라이브러리의 Java SE 빌드를 선택합니다. 26.9를 저장소에 나열된 최신 버전으로 교체하세요. 저장소는 각 JAR 옆에 SHA-1 체크섬 파일을 게시하며, 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.9</version>
            <classifier>jdk16</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.compiler.release 설정을 적용하기 위해 컴파일러 플러그인을 고정합니다.

Create Presentations에 있는 첫 번째 예제를 src/main/java/HelloSlides.java로 저장합니다.
프로젝트 폴더에서 다음을 실행합니다:
```
mvn compile exec:java
```

Maven이 Aspose.Slides for Java를 다운로드하고 프로그램을 컴파일하여 실행합니다. 프로그램은 new_presentation.pptx 파일을 프로젝트 폴더에 저장합니다.

Maven 없이 JAR 파일 사용

저장소의 버전 폴더에서 aspose-slides-26.9-jdk16.jar를 다운로드합니다. 다른 버전의 경우 저장소에서 해당 폴더를 열고 -jdk16.jar로 끝나는 파일을 다운로드하세요.
Create Presentations에 있는 첫 번째 예제를 JAR 파일과 동일한 폴더에 HelloSlides.java로 저장합니다.

해당 폴더에서 다음을 실행합니다:

java -cp aspose-slides-26.9-jdk16.jar HelloSlides.java

JDK가 단일 소스 파일을 컴파일하고 실행하며, 프로그램은 폴더에 new_presentation.pptx를 저장합니다. 자체 애플리케이션에서는 빌드 도구나 IDE에 JAR 파일을 클래스 경로에 추가하세요.

Linux

Aspose.Slides for 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 메모리 제한을 높이고, finally 블록에서 각 Presentation 인스턴스에 대해 dispose를 호출해 캐시를 즉시 해제하세요. 이렇게 하면 메모리 부족 오류를 방지하고 배치 작업 중 메모리 사용량을 예측 가능하게 유지할 수 있습니다.

불필요한 내보내기 형식을 제외해 최종 JAR 크기를 줄일 수 있나요?

현재 Aspose.Slides 릴리스는 단일 모놀리식 라이브러리로 제공되므로 빌드 시 PDF나 SVG와 같은 특정 내보내기 기능을 비활성화할 수 없습니다.

선언 Docker에서 Aspose.Slides for Java 실행 방법