Aspose.Slides FOSS
C++
התחלה
התקנה

התקנה

התקנה של 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 או גרסה מאוחרת יותר
מערכת בנייהCMake 3.20 או גרסה מאוחרת יותר
מהדרGCC 10+, Clang 13+, או MSVC 2019+ (כל מהדר עם תמיכה ב‑C++20)
מערכת הפעלהWindows, macOS, Linux
תלויות חיצוניותאין (כל התלויות מסופקות במאגרים או רק כקבצי כותרת)

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 של commit:

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() באופן מפורש אם נדרש; קריאה מרובה היא בטוחה.

הערות פלטפורמה

Windows, macOS, Linux: הספרייה נבנית באופן זהה על כל הפלטפורמות. אין נתיבי קוד ספציפיים לפלטפורמה או הרחבות בינאריות.

Docker / CI: שכפל או שלוף את המאגר שלב הבנייה שלך והפעל CMake. אין צורך בחבילות מערכת נוספות מעבר למקמפל C++20 ו‑CMake.

vcpkg / Conan: לא מפורסם כרגע ל‑vcpkg או Conan. השתמש ב‑FetchContent או בתת‑מודול git במקום זאת.

משאבים נוספים

 עברית