التثبيت

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

Aspose.Slides FOSS for C++ is a header-and-source library built with CMake. It has no binary distribution; you integrate it directly into your CMake project from the GitHub repository. No Microsoft Office or other proprietary runtime is required.


المعايير

مطلوبالتفاصيل
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.3.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)

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 بدلا من ذلك.


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

 العربية