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

KravDetalje
C++-standardC++20 eller senere
ByggesystemCMake 3.20 eller senere
KompilatorGCC 10+, Clang 13+ eller MSVC 2019+ (enhver kompilator med C++20-understøttelse)
OperativsystemWindows, macOS, Linux
Eksterne afhængighederIngen (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_foss

Referé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 build

Opret 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: 1

Hurtig 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

 Dansk