Aspose.Slides FOSS
C++
Començar
Instal·lació

Instal·lació

Instal·lació de Aspose.Slides FOSS per a 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.

Requisits previs

RequisitDetall
Estàndard C++C++20 o posterior
Sistema de construccióCMake 3.20 o posterior
CompiladorGCC 10+, Clang 13+, o MSVC 2019+ (qualsevol compilador amb suport C++20)
Sistema operatiuWindows, macOS, Linux
Dependències externesCap (totes les dependències són incloses o només de capçalera)

1. CMake FetchContent (Recommended)

La manera més senzilla d’afegir Aspose.Slides FOSS al teu projecte és CMake FetchContent. Afegeix això al teu 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 descarrega el repositori i posa a disposició l’objectiu de la biblioteca. No cal cap clonació manual ni instal·lació a nivell de sistema.

Per fixar una versió específica per a construccions reproduïbles, substitueix main amb una etiqueta de llançament o un hash de commit:

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

Si preferiu incloure el codi font dins del vostre repositori:

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

Llavors fes referència des del teu CMakeLists.txt:

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

3. Build and Verify

Després d’afegir la dependència, configureu i compileu el vostre projecte:

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

Crea un mínim main.cpp per verificar la construcció:

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

Sortida esperada:

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

Inici ràpid: Crea una presentació amb una forma

El programa següent crea una nova presentació, afegeix un rectangle amb text i l’guarda com a .pptx fitxer:

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

Important: Presentation utilitza RAII. Quan l’objecte surt del seu àmbit, els recursos interns es liberen automàticament. També podeu cridar pres.dispose() explícitament si cal; cridar-lo diverses vegades és segur.

Notes de la plataforma

Windows, macOS, Linux: La biblioteca es compila de manera idèntica en totes les plataformes. No hi ha camins de codi específics de plataforma ni extensions binàries.

Docker / CI: Cloneu o recupereu el repositori en el vostre pas de construcció i executeu CMake. No es necessiten paquets de sistema addicionals més enllà d’un compilador C++20 i CMake.

vcpkg / Conan: Actualment no està publicat a vcpkg ni a Conan. Useu FetchContent o un submòdul git en el seu lloc.

Recursos addicionals

 Català