Installation
설치
이 페이지에서는 기존 CMake 프로젝트에 Aspose.PDF FOSS for C++를 추가하는 방법을 설명합니다.
전제 조건
| 요구 사항 | 세부 사항 |
|---|---|
| C++ 컴파일러 | C++20 지원 (clang 16+, gcc 13+, 또는 MSVC 2022 17.5+) |
| CMake | 3.22 이상 |
| Python 3 | 빌드 시에만 — 생성 단계에서 번들된 Standard-14 글꼴 윤곽선을 생성된 소스 파일에 삽입합니다 |
| 런타임 종속성 | 없음 — 라이브러리는 C++ 표준 라이브러리 외에는 아무것도 링크되지 않습니다 |
1단계 — CMake 하위 디렉터리로 추가 (권장)
리포지터리를 프로젝트 트리에 벤더하거나 클론한 뒤, 하위 디렉터리로 추가하고 정적 라이브러리 타깃을 링크합니다:
add_subdirectory(aspose.pdf-foss-for-cpp)
target_link_libraries(your_app PRIVATE aspose_pdf_foss)이렇게 하면 라이브러리의 공개 헤더가 노출되고 aspose_pdf_foss가 your_app에 패키지 매니저 단계 없이 링크됩니다.
2단계 — 또는 독립적으로 빌드하고 설치
별도로 빌드된 아티팩트를 선호한다면, 구성하고 소스 외부에서 빌드하십시오:
cmake -S . -B build
cmake --build build정적 라이브러리는 build/libaspose_pdf_foss.a에 위치합니다(MSVC에서는 aspose_pdf_foss.lib). 최적화된 빌드를 위해 빌드 유형을 설정하십시오:
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build생성된 정적 라이브러리를 링크하고, 저장소의 include/ 디렉터리를 프로젝트의 include 경로에 추가하십시오.
3단계 — 툴체인 확인
헤더에 대해 최소 프로그램을 컴파일하여 툴체인과 링크 단계가 올바르게 해결되는지 확인하십시오:
#include <aspose/pdf/document.hpp>
#include <iostream>
int main() {
Aspose::Pdf::Document doc;
std::cout << "Aspose.PDF FOSS for C++ linked OK — pages: "
<< doc.Pages().Count() << "\n";
}성공적인 컴파일 및 링크가 이루어지고, 새로 만든 Document에 대해 pages: 0을 출력하면 설치가 정상 작동함을 확인할 수 있습니다.
