Installation
安装
本页说明如何将 Aspose.PDF FOSS for C++ 添加到现有的 CMake 项目中。
先决条件
| 要求 | 详情 |
|---|---|
| C++ 编译器 | C++20 支持 (clang 16+, gcc 13+, 或 MSVC 2022 17.5+) |
| CMake | 3.22 或更高版本 |
| Python 3 | 仅在构建时 — 生成步骤将捆绑的 Standard-14 字体轮廓嵌入生成的源文件中 |
| 运行时依赖 | 无 — 该库仅链接 C++ 标准库 |
步骤 1 — 作为 CMake 子目录添加（推荐）
在项目树中 vendor 或克隆该仓库，然后将其作为子目录添加并链接静态库目标：
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/ 目录添加到项目的包含路径中。
步骤 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，即可确认安装正常工作。
