Aspose.Slides FOSS for Java 시작 방법

aspose-slides-foss for Java는 무료이며 MIT 라이선스를 가진 라이브러리로, PowerPoint .pptx 파일을 생성하고 편집할 수 있습니다 — Microsoft Office가 필요 없으며, Maven Central에서 사용할 수 있습니다.

단계별 가이드

1단계: Maven 의존성 추가

귀하의 pom.xml에 종속성을 추가하십시오 (Java 21 이상 필요):

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

패키지가 올바르게 해결되는지 프로젝트를 빌드하여 확인하십시오:

mvn dependency:resolve

2단계: 필요한 클래스 가져오기

프레젠테이션을 로드하고 저장하는 데 필요한 클래스를 가져옵니다:

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;

3단계: 프레젠테이션 만들기

인수가 없는 Presentation을 생성하여 빈 슬라이드 하나로 시작합니다. 항상 try-with-resources를 사용하여 내부 리소스가 해제되도록 하십시오:

import org.aspose.slides.foss.Presentation;

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

4단계: 텍스트가 있는 도형 추가

slide.getShapes().addAutoShape()를 사용하여 사각형을 삽입하고, addTextFrame()를 호출하여 텍스트 내용을 추가합니다:

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

5단계: 채우기를 적용하고 저장

저장하기 전에 도형에 단색 채우기 색을 설정하십시오:

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

일반적인 문제 및 해결 방법

ClassNotFoundException for org.aspose.slides.foss.Presentation Maven 종속성이 해결되지 않았습니다. mvn dependency:resolve을 실행하고 아티팩트가 Maven Central에 있는지 확인하십시오. pom.xml에서 버전을 확인하십시오.

UnsupportedOperationException 특정 메서드를 호출할 때
일부 기능(차트, 애니메이션, PDF 내보내기)은 이 릴리스에서 UnsupportedOperationException을 발생시킵니다.
API 참조의 알려진 제한 사항 섹션을 확인한 후 고급 기능을 사용하십시오.

Shape coordinates seem off
좌표와 치수는 EMU(English Metric Units) 단위입니다. 한 포인트는 대략 12700 EMU입니다. 기본 슬라이드 크기는 9144000 × 6858000 EMU.

기존 PPTX를 로드할 때 파일을 찾을 수 없음
절대 경로를 전달하거나 작업 디렉터리가 올바르게 설정되었는지 확인하십시오:

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

자주 묻는 질문

aspose-slides-foss는 Microsoft Office가 필요합니까?

아니요. 이 라이브러리는 Microsoft Office, COM 자동화 또는 Windows API에 대한 의존성 없이 순수 Java로 .pptx 파일을 네이티브하게 생성하고 읽습니다.

지원되는 Java 버전은 무엇입니까?

Java 21 이상. 라이브러리는 Windows, macOS, Linux 및 Docker 컨테이너에서 실행됩니다.

이 라이브러리는 상업적 사용이 무료인가요?

예. MIT 라이선스 하에 배포됩니다. 사용, 수정 및 재배포를 위해
모든 목적에 사용할 수 있으며, 상업적 응용 프로그램도 포함됩니다.

기존 PPTX 파일을 로드할 수 있나요?

예. 파일 경로를 Presentation 생성자에 전달하십시오:

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

Presentation을 명시적으로 닫아야 하나요?

예. Presentation는 AutoCloseable를 구현합니다. 항상 try-with-resources (try (Presentation prs = new Presentation()) { ... })를 사용하여 정리를 보장하십시오.