Εγκατάσταση

Εγκατάσταση του 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 submodule αντ’ αυτού.


Πρόσθετοι Πόροι

 Ελληνικά