Aspose.Slides FOSS
C++
시작하기
설치

설치

Aspose.Slides FOSS for C++ 설치

Aspose.Slides FOSS for C++ is a header-and-source library built with CMake. It has no binary distribution; you integrate it directly into your CMake project from the GitHub repository. No Microsoft Office or other proprietary runtime is required.

전제 조건

요구 사항세부 사항
C++ 표준C++20 이상
빌드 시스템CMake 3.20 이상
컴파일러GCC 10+, Clang 13+, 또는 MSVC 2019+ (C++20을 지원하는 모든 컴파일러)
운영 체제Windows, macOS, Linux
외부 종속성없음 (모든 종속성이 vendored 또는 헤더 전용)

1. CMake FetchContent (Recommended)

프로젝트에 Aspose.Slides FOSS를 추가하는 가장 간단한 방법은 CMake FetchContent입니다. 다음을 프로젝트에 추가하세요 CMakeLists.txt:

cmake_minimum_required(VERSION 3.20)
project(my_slides_app LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

include(FetchContent)
FetchContent_Declare(
    aspose_slides_foss
    GIT_REPOSITORY https://github.com/aspose-slides-foss/Aspose.Slides-FOSS-for-Cpp.git
    GIT_TAG        main
)
FetchContent_MakeAvailable(aspose_slides_foss)

add_executable(my_app main.cpp)
target_link_libraries(my_app PRIVATE aspose_slides_foss)

CMake가 저장소를 다운로드하고 라이브러리 타깃을 사용할 수 있게 합니다. 수동 클론이나 시스템 수준 설치가 필요하지 않습니다.

재현 가능한 빌드를 위해 특정 버전을 고정하려면, 다음을 교체하세요 main 릴리스 태그 또는 커밋 해시로:

FetchContent_Declare(
    aspose_slides_foss
    GIT_REPOSITORY https://github.com/aspose-slides-foss/Aspose.Slides-FOSS-for-Cpp.git
    GIT_TAG        v26.3.0
)

2. Git Submodule

저장소 내부에 소스 코드를 직접 포함하고 싶다면:

git submodule add https://github.com/aspose-slides-foss/Aspose.Slides-FOSS-for-Cpp.git third_party/aspose_slides_foss

그런 다음 여러분의 CMakeLists.txt:

add_subdirectory(third_party/aspose_slides_foss)
target_link_libraries(my_app PRIVATE aspose_slides_foss)

3. Build and Verify

의존성을 추가한 후, 프로젝트를 구성하고 빌드합니다:

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

최소한의 것을 생성합니다 main.cpp 빌드를 확인하기 위해:

#include <Aspose/Slides/Foss/presentation.h>
#include <Aspose/Slides/Foss/export/save_format.h>
#include <Aspose/Slides/Foss/slide.h>
#include <Aspose/Slides/Foss/slide_collection.h>

#include <iostream>

using namespace Aspose::Slides::Foss;

int main() {
    Presentation pres;
    std::cout << "Aspose.Slides FOSS built successfully" << std::endl;
    std::cout << "Slides in empty presentation: " << pres.slides().size() << std::endl;
    return 0;
}

예상 출력:

Aspose.Slides FOSS built successfully
Slides in empty presentation: 1

빠른 시작: 도형이 포함된 프레젠테이션 만들기

다음 프로그램은 새 프레젠테이션을 만들고, 텍스트가 포함된 사각형을 추가한 뒤, 이를 .pptx 파일:

#include <Aspose/Slides/Foss/auto_shape.h>
#include <Aspose/Slides/Foss/export/save_format.h>
#include <Aspose/Slides/Foss/presentation.h>
#include <Aspose/Slides/Foss/shape_collection.h>
#include <Aspose/Slides/Foss/shape_type.h>
#include <Aspose/Slides/Foss/slide.h>
#include <Aspose/Slides/Foss/slide_collection.h>
#include <Aspose/Slides/Foss/text_frame.h>

#include <iostream>

using namespace Aspose::Slides::Foss;

int main() {
    Presentation pres;
    auto& slide = pres.slides()[0];

    // Add a rectangle shape and set its text
    auto& shape = slide.shapes().add_auto_shape(ShapeType::RECTANGLE, 50, 50, 400, 150);
    shape.text_frame()->set_text("Hello from Aspose.Slides FOSS!");

    pres.save("hello.pptx", SaveFormat::PPTX);
    std::cout << "Saved hello.pptx" << std::endl;
    return 0;
}

중요: Presentation RAII를 사용합니다. 객체가 스코프를 벗어나면 내부 리소스가 자동으로 해제됩니다. 필요하다면 또한 호출할 수 있습니다 pres.dispose() 필요에 따라 명시적으로 호출할 수 있습니다; 여러 번 호출해도 안전합니다.

플랫폼 참고

Windows, macOS, Linux: 이 라이브러리는 모든 플랫폼에서 동일하게 빌드됩니다. 플랫폼별 코드 경로나 바이너리 확장이 없습니다.

Docker / CI: 빌드 단계에서 저장소를 클론하거나 가져오고 CMake를 실행합니다. C++20 컴파일러와 CMake 외에 추가 시스템 패키지는 필요하지 않습니다.

vcpkg / Conan: 현재 vcpkg나 Conan에 게시되어 있지 않습니다. 대신 FetchContent 또는 git 서브모듈을 사용하세요.

추가 리소스

 한국어