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 تازه ساختهشده چاپ میکند، تأیید میکند نصب بهدرستی کار میکند.
گامهای بعدی
- شروع سریع — یک PDF باز کنید، متن را استخراج کنید و یک صفحه را رندر کنید
- License — شرایط مجوز MIT و الزامات ذکر منبع
- راهنمای توسعهدهنده — مستندات سطح ویژگی