Installation

نصب

این صفحه توضیح می‌دهد چطور Aspose.PDF FOSS برای C++ را به یک پروژه CMake موجود اضافه کنید.


پیش‌نیازها

الزامجزئیات
کامپایلر C++پشتیبانی از C++20 (clang 16+، gcc 13+، یا MSVC 2022 17.5+)
CMake۳.۲۲ یا بالاتر
Python 3فقط در زمان ساخت — یک مرحلهٔ تولید‌کننده، خطوط قلم‌های Standard-14 بسته‌بندی‌شده را در یک فایل منبع تولید‌شده جاسازی می‌کند
وابستگی‌های زمان اجراهیچ‌کدام — کتابخانه فقط به کتابخانه استاندارد C++ لینک می‌شود

مرحله ۱ — Add as a CMake subdirectory (recommended)

Vendor یا clone مخزن را به درخت پروژه‌تان اضافه کنید، سپس آن را به‌عنوان زیرشاخه اضافه کنید و هدف کتابخانهٔ استاتیک را لینک کنید:

add_subdirectory(aspose.pdf-foss-for-cpp)
target_link_libraries(your_app PRIVATE aspose_pdf_foss)

این کار هدرهای عمومی کتابخانه را در دسترس قرار می‌دهد و aspose_pdf_foss را به your_app لینک می‌کند بدون هیچ مرحله‌ای از مدیر بسته.


مرحله ۲ — Or build and install standalone

اگر ترجیح می‌دهید یک محصول به‌صورت جداگانه ساخته شود، آن را پیکربندی کنید و خارج از منبع بسازید:

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 پروژه‌تان اضافه کنید.


مرحله ۳ — تأیید ابزار زنجیره‌ای

یک برنامهٔ حداقل را در برابر سرایندها کامپایل کنید تا اطمینان حاصل شود ابزار زنجیره‌ای و مرحلهٔ لینک به‌درستی حل می‌شوند:

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

یک کامپایل و لینک موفق که pages: 0 را برای یک Document تازه ساخته‌شده چاپ می‌کند، تأیید می‌کند نصب به‌درستی کار می‌کند.


گام‌های بعدی

همچنین ببینید:

 فارسی