Installation

Installation de Aspose.Slides FOSS pour 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.

Prérequis

1. CMake FetchContent (Recommended)

La façon la plus simple d’ajouter Aspose.Slides FOSS à votre projet est CMake FetchContent. Ajoutez ceci à votre 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 télécharge le dépôt et rend la cible de la bibliothèque disponible. Aucun clonage manuel ou installation au niveau du système n’est nécessaire.

Pour figer une version spécifique afin d’obtenir des builds reproductibles, remplacez main par un tag de version ou 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 vous préférez intégrer le code source dans votre dépôt :

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

Ensuite, faites‑y référence depuis votre CMakeLists.txt:

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

3. Build and Verify

Après avoir ajouté la dépendance, configurez et construisez votre projet :

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

Créez un minimal main.cpp pour vérifier la construction :

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

Sortie attendue :

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

Démarrage rapide : créer une présentation avec une forme

Le programme suivant crée une nouvelle présentation, ajoute un rectangle avec du texte, et l’enregistre en tant que .pptx fichier :

#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 utilise le RAII. Lorsque l’objet sort de sa portée, les ressources internes sont libérées automatiquement. Vous pouvez également appeler pres.dispose() explicitement si nécessaire ; l’appeler plusieurs fois est sûr.

Notes de la plateforme

Windows, macOS, Linux : La bibliothèque se compile de manière identique sur toutes les plateformes. Il n’existe aucun chemin de code spécifique à une plateforme ni aucune extension binaire.

Docker / CI : Clonez ou récupérez le dépôt dans votre étape de construction et exécutez CMake. Aucun paquet système supplémentaire n’est requis au-delà d’un compilateur C++20 et de CMake.

vcpkg / Conan : Pas encore publié sur vcpkg ou Conan. Utilisez FetchContent ou un sous‑module git à la place.

Ressources supplémentaires

• Page produit: Aperçu, résumé des fonctionnalités et démarrage rapide
• Licence: Détails de la licence MIT, aucune clé API requise
• Guide du développeur: Guides des fonctionnalités avec des exemples de code
• Référence API: Référence des classes et des méthodes