Εγκατάσταση
Εγκατάσταση του 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 αντ’ αυτού.
Πρόσθετοι Πόροι
- Σελίδα Προϊόντος: Επισκόπηση, σύνοψη χαρακτηριστικών και γρήγορη εκκίνηση
- Άδεια: Λεπτομέρειες άδειας MIT, δεν απαιτείται κλειδί API
- Οδηγός Προγραμματιστή: Οδηγοί χαρακτηριστικών με παραδείγματα κώδικα
- Αναφορά API: Αναφορά κλάσης και μεθόδου