Aspose.Slides FOSS
C++
Začínáme
Instalace

Instalace

Instalace Aspose.Slides FOSS pro 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.

Předpoklady

PožadavekDetail
Standard C++C++20 nebo novější
Systém sestaveníCMake 3.20 nebo novější
KompilátorGCC 10+, Clang 13+ nebo MSVC 2019+ (libovolný překladač s podporou C++20)
Operační systémWindows, macOS, Linux
Externí závislostiŽádné (všechny závislosti jsou vendored nebo jen hlavičkové)

1. CMake FetchContent (Recommended)

Nejjednodušší způsob, jak přidat Aspose.Slides FOSS do vašeho projektu, je CMake FetchContent. Přidejte toto do vašeho 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 stáhne repozitář a zpřístupní cíl knihovny. Není potřeba ruční klonování ani instalace na úrovni systému.

Pro připnutí konkrétní verze pro reprodukovatelné sestavení nahraďte main vydaným tagem nebo hash 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

Pokud dáváte přednost zahrnutí zdrojového kódu přímo do svého repozitáře:

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

Pak na to odkažte ze svého CMakeLists.txt:

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

3. Build and Verify

Po přidání závislosti nakonfigurujte a sestavte svůj projekt:

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

Vytvořte minimální main.cpp k ověření sestavení:

#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čekávaný výstup:

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

Rychlý start: Vytvořte prezentaci s tvarem

Následující program vytvoří novou prezentaci, přidá obdélník s textem a uloží ji jako .pptx soubor:

#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žívá RAII. Když objekt opustí rozsah, interní prostředky jsou uvolněny automaticky. Můžete také zavolat pres.dispose() explicitně, pokud je potřeba; volání vícekrát je bezpečné.

Poznámky k platformě

Windows, macOS, Linux: Knihovna se sestavuje identicky na všech platformách. Neexistují žádné platformně specifické cesty kódu ani binární rozšíření.

Docker / CI: Klónujte nebo stáhněte repozitář ve vašem kroku sestavení a spusťte CMake. Kromě C++20 kompilátoru a CMake nejsou vyžadovány žádné další systémové balíčky.

vcpkg / Conan: Momentálně není publikováno na vcpkg ani Conan. Použijte místo toho FetchContent nebo git submodule.

Další zdroje

 Čeština