Installation

التثبيت

توضح هذه الصفحة كيفية إضافة Aspose.PDF FOSS للـ 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 (أو aspose_pdf_foss.lib على MSVC). للحصول على بناء مُحسّن، اضبط نوع البناء:

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

اربط المكتبة الثابتة الناتجة وأضف دليل include/ الخاص بالمستودع إلى مسار التضمين في مشروعك.


بديل — التثبيت عبر NuGet (Visual Studio)

إذا كنت تبني باستخدام Visual Studio، فيمكنك تثبيت الحزمة المنشورة بدلاً من إضافة المصدر إلى مشروعك؛ تخطَّ الخطوتين 1–2 وتابع بالخطوة 3:

dotnet add package Aspose.PDF.Cpp.FOSS

الخطوة 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";
}

ترجمة وربط ناجحان، يطبعان pages: 0 لDocument الذي تم إنشاؤه حديثًا، يؤكدان أن التثبيت يعمل.


الخطوات التالية

انظر أيضاً

 العربية