Installation
Installation af Aspose.Slides FOSS for 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.
Forudsætninger
| Krav | Detalje |
|---|---|
| C++-standard | C++20 eller senere |
| Byggesystem | CMake 3.20 eller senere |
| Kompilator | GCC 10+, Clang 13+ eller MSVC 2019+ (enhver kompilator med C++20-understøttelse) |
| Operativsystem | Windows, macOS, Linux |
| Eksterne afhængigheder | Ingen (alle afhængigheder er indlejrede eller kun header‑baserede) |
1. CMake FetchContent (Recommended)
Den enkleste måde at tilføje Aspose.Slides FOSS til dit projekt er CMake FetchContent. Tilføj dette til din 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 downloader repositoryen og gør biblioteksmålet tilgængeligt. Ingen manuel kloning eller system‑niveau installation er nødvendig.
For at fastgøre en specifik version for reproducerbare builds, erstat main med et udgivelsestag eller commit‑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
Hvis du foretrækker at vendore kildekoden inde i dit repository:
git submodule add https://github.com/aspose-slides-foss/Aspose.Slides-FOSS-for-Cpp.git third_party/aspose_slides_fossReferér derefter til den fra din CMakeLists.txt:
add_subdirectory(third_party/aspose_slides_foss)
target_link_libraries(my_app PRIVATE aspose_slides_foss)3. Build and Verify
Efter at have tilføjet afhængigheden, konfigurer og byg dit projekt:
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build buildOpret en minimal main.cpp for at verificere build’en:
#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;
}Forventet output:
Aspose.Slides FOSS built successfully
Slides in empty presentation: 1Hurtig start: Opret en præsentation med en form
Det følgende program opretter en ny præsentation, tilføjer en rektangel med tekst og gemmer den som en .pptx fil:
#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;
}Vigtigt: Presentation bruger RAII. Når objektet går ud af scope, frigives interne ressourcer automatisk. Du kan også kalde pres.dispose() eksplicit hvis nødvendigt; at kalde den flere gange er sikkert.
Platformnoter
Windows, macOS, Linux: Biblioteket bygges identisk på alle platforme. Der er ingen platformspecifikke kodeveje eller binære udvidelser.
Docker / CI: Klon eller hent repository’et i dit build-step og kør CMake. Ingen ekstra systempakker er påkrævet udover en C++20-kompilator og CMake.
vcpkg / Conan: Ikke aktuelt udgivet til vcpkg eller Conan. Brug FetchContent eller git submodule i stedet.
Yderligere ressourcer
- Produktside: Oversigt, funktionsoversigt og hurtig start
- Licens: MIT-licens detaljer, ingen API-nøgle påkrævet
- Udviklerguide: Funktionsguider med kodeeksempler
- API-reference: Klasse- og metode-referencer