Inštalácia

Inštalácia Aspose.Slides FOSS pre 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.


Predpoklady

PožiadavkaPodrobnosť
Štandard C++C++20 alebo novší
Systém zostavovaniaCMake 3.20 alebo novší
KompilátorGCC 10+, Clang 13+ alebo MSVC 2019+ (akýkoľvek kompilátor s podporou C++20)
Operačný systémWindows, macOS, Linux
Externé závislostiŽiadne (všetky závislosti sú zahrnuté alebo len hlavičkové)

1. CMake FetchContent (Recommended)

Najjednoduchší spôsob, ako pridať Aspose.Slides FOSS do vášho projektu, je CMake FetchContent. Pridajte toto do vášho 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 stiahne repozitár a sprístupní cieľ knižnice. Nie je potrebné ručné klonovanie ani inštalácia na úrovni systému.

Ak chcete pripnúť konkrétnu verziu pre reprodukovateľné zostavy, nahraďte main verziou značky vydania alebo hashom commitu:

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

Ak radšej zahrniete zdrojový kód priamo do svojho repozitára:

git submodule add https://github.com/aspose-slides-foss/Aspose.Slides-FOSS-for-Cpp.git third_party/aspose_slides_foss

Potom na to odkazujte zo svojho CMakeLists.txt:

add_subdirectory(third_party/aspose_slides_foss)
target_link_libraries(my_app PRIVATE aspose_slides_foss)

3. Build and Verify

Po pridaní závislosti nakonfigurujte a zostavte svoj projekt:

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

Vytvorte minimálny main.cpp na overenie zostavy:

#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;
}

Očakávaný výstup:

Aspose.Slides FOSS built successfully
Slides in empty presentation: 1

Rýchly štart: Vytvorenie prezentácie s tvarom

Nasledujúci program vytvorí novú prezentáciu, pridá obdĺžnik s textom a uloží ho ako .pptx súbor:

#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;
}

Dôležité: Presentation používa RAII. Keď objekt opustí rozsah, interné zdroje sa uvoľnia automaticky. Môžete tiež zavolať pres.dispose() explicitne, ak je to potrebné; volanie viackrát je bezpečné.


Poznámky k platformám

Windows, macOS, Linux: Knižnica sa zostavuje rovnako na všetkých platformách. Neexistujú žiadne platformovo špecifické cesty kódu ani binárne rozšírenia.

Docker / CI: Klonujte alebo načítajte repozitár vo vašom kroku zostavovania a spustite CMake. Nie sú potrebné žiadne ďalšie systémové balíky okrem C++20 kompilátora a CMake.

vcpkg / Conan: Momentálne nie je publikované pre vcpkg ani Conan. Použite namiesto toho FetchContent alebo git submodule.


Ďalšie zdroje

 Slovenčina