Aspose.Slides FOSS
C++
Rozpoczęcie
Instalacja

Instalacja

Instalacja Aspose.Slides FOSS dla 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.

Wymagania wstępne

WymaganieSzczegół
Standard C++C++20 lub nowszy
System budowaniaCMake 3.20 lub nowszy
KompilatorGCC 10+, Clang 13+ lub MSVC 2019+ (dowolny kompilator z obsługą C++20)
System operacyjnyWindows, macOS, Linux
Zewnętrzne zależnościBrak (wszystkie zależności są wbudowane lub tylko nagłówkowe)

1. CMake FetchContent (Recommended)

Najprostszym sposobem dodania Aspose.Slides FOSS do twojego projektu jest CMake FetchContent. Dodaj to do swojego 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 pobiera repozytorium i udostępnia cel biblioteki. Nie jest potrzebne ręczne klonowanie ani instalacja na poziomie systemu.

Aby zablokować konkretną wersję dla powtarzalnych kompilacji, zamień main na tag wydania lub hash commita:

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

Jeśli wolisz włączyć kod źródłowy bezpośrednio w swoje repozytorium:

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

Następnie odwołaj się do niego ze swojego CMakeLists.txt:

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

3. Build and Verify

Po dodaniu zależności, skonfiguruj i zbuduj swój projekt:

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

Utwórz minimalny main.cpp aby zweryfikować kompilację:

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

Oczekiwany wynik:

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

Szybki start: Utwórz prezentację z kształtem

Poniższy program tworzy nową prezentację, dodaje prostokąt z tekstem i zapisuje ją jako .pptx plik:

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

Ważne: Presentation używa RAII. Gdy obiekt wychodzi poza zakres, wewnętrzne zasoby są zwalniane automatycznie. Możesz także wywołać pres.dispose() jawnie w razie potrzeby; wywoływanie go wielokrotnie jest bezpieczne.

Informacje o platformie

Windows, macOS, Linux: Biblioteka buduje się identycznie na wszystkich platformach. Nie ma specyficznych dla platformy ścieżek kodu ani rozszerzeń binarnych.

Docker / CI: Sklonuj lub pobierz repozytorium w kroku budowania i uruchom CMake. Nie są wymagane żadne dodatkowe pakiety systemowe poza kompilatorem C++20 i CMake.

vcpkg / Conan: Obecnie nie jest publikowane w vcpkg ani w Conan. Użyj FetchContent lub git submodule zamiast tego.

Dodatkowe zasoby

 Polski