التثبيت

تثبيت Aspose.Slides FOSS لـ C++

Aspose.Slides FOSS for C++ مكتبة تتألف من ملفات رأسية ومصدرية تُبنى باستخدام CMake. في Windows مع MSVC يمكنك تثبيت حزمة NuGet الجاهزة (Aspose.Slides.Cpp.FOSS)، وعلى أي منصة يمكنك دمجها مباشرةً في مشروع CMake من مستودع GitHub. لا يلزم Microsoft Office أو أي بيئة تشغيل مملوكة أخرى.


المعايير

مطلوبالتفاصيل
C++ المعيارC++20 أو أحدث
بناء النظامكوميديا 3.20 أو أحدث
الكوميدياGCC 10+ أو Clang 13+، أو MSVC 2019+ (أي نسخة مع دعم C++20)
نظام التشغيلويندوز، ماكوس، لينكس
الاعتماد الخارجيلا (كل الإدمانات يتم بيعها أو العنوان فقط)

1. CMake FetchContent (Recommended)

أسهل طريقة لإضافة Aspose.Slides FOSS إلى مشروعك هي CMake FetchContent. CMakeLists.txt:

cmake_minimum_required(VERSION 3.20)
project(my_slides_app LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

include(FetchContent)
FetchContent_Declare(
    aspose_slides_foss
    GIT_REPOSITORY https://github.com/aspose-slides-foss/Aspose.Slides-FOSS-for-Cpp.git
    GIT_TAG        main
)
FetchContent_MakeAvailable(aspose_slides_foss)

add_executable(my_app main.cpp)
target_link_libraries(my_app PRIVATE aspose_slides_foss)

يلغي CMake مخزن المستودع ويجعل المكتبة المستهدفة متاحة.لا حاجة إلى الاستنشاق اليدوي أو التثبيت على مستوى النظام.

لتشريع نسخة محددة للبناءات قابلة للتكرار، استبدال main مع علامة الإصدار أو تعهد hash:

FetchContent_Declare(
    aspose_slides_foss
    GIT_REPOSITORY https://github.com/aspose-slides-foss/Aspose.Slides-FOSS-for-Cpp.git
    GIT_TAG        v26.9.0
)

2. Git Submodule

إذا كنت تفضل توفير رمز المصدر داخل مستودعك:

git submodule add https://github.com/aspose-slides-foss/Aspose.Slides-FOSS-for-Cpp.git third_party/aspose_slides_foss

ثم اذكرها منك CMakeLists.txt:

add_subdirectory(third_party/aspose_slides_foss)
target_link_libraries(my_app PRIVATE aspose_slides_foss)

بديل: التثبيت عبر NuGet (Windows، MSVC)

إذا كنت تبني باستخدام MSVC على Windows، فيمكنك تثبيت الحزمة الجاهزة بدلاً من البناء من المصدر:

dotnet add package Aspose.Slides.Cpp.FOSS

3. Build and Verify

بعد إضافة الإدمان ، قم بتكوين وبناء مشروعك:

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

إنشاء الحد الأدنى main.cpp للتحقق من البناء:

#include <Aspose/Slides/Foss/presentation.h>
#include <Aspose/Slides/Foss/export/save_format.h>
#include <Aspose/Slides/Foss/slide.h>
#include <Aspose/Slides/Foss/slide_collection.h>

#include <iostream>

using namespace Aspose::Slides::Foss;

int main() {
    Presentation pres;
    std::cout << "Aspose.Slides FOSS built successfully" << std::endl;
    std::cout << "Slides in empty presentation: " << pres.slides().size() << std::endl;
    return 0;
}

الناتج المتوقع :

Aspose.Slides FOSS built successfully
Slides in empty presentation: 1

بدء سريع: إنشاء عرض مع شكل

يخلق البرنامج التالي عرضًا جديدًّا ، ويضيف مستطيلًًَّا مع النص ، ويتم حفظه كعرض .pptx ملف :

#include <Aspose/Slides/Foss/auto_shape.h>
#include <Aspose/Slides/Foss/export/save_format.h>
#include <Aspose/Slides/Foss/presentation.h>
#include <Aspose/Slides/Foss/shape_collection.h>
#include <Aspose/Slides/Foss/shape_type.h>
#include <Aspose/Slides/Foss/slide.h>
#include <Aspose/Slides/Foss/slide_collection.h>
#include <Aspose/Slides/Foss/text_frame.h>

#include <iostream>

using namespace Aspose::Slides::Foss;

int main() {
    Presentation pres;
    auto& slide = pres.slides()[0];

    // Add a rectangle shape and set its text
    auto& shape = slide.shapes().add_auto_shape(ShapeType::RECTANGLE, 50, 50, 400, 150);
    shape.text_frame()->set_text("Hello from Aspose.Slides FOSS!");

    pres.save("hello.pptx", SaveFormat::PPTX);
    std::cout << "Saved hello.pptx" << std::endl;
    return 0;
}

أهمية : الـمـنـتـهـيPresentation استخدام RAII.عندما يخرج الكائن من نطاق، يتم إطلاق الموارد الداخلية تلقائيا.يمكنك أيضا الاتصال pres.dispose() إذا لزم الأمر ، فمن الأفضل أن تسميها عدة مرات.


منصة ملاحظات

ويندوز، ماكوس، لينكس: يبدو أن المكتبة هي نفسها على جميع المنصات، ولا توجد مسارات رمزية محددة للمنصة أو التمديدات الثنائية.

دكتوراه / CI : قم بتصميم أو إدراج المستودع في خطوة البناء وتشغيل CMake.لا تتطلب أي حزم نظام إضافية خارج C++20 وCMake .

كونان / Conan : غير نشرت حاليا في vcpkg أو Conan. استخدم FetchContent أو git submodule بدلا من ذلك.


الموارد الإضافية

 العربية