Instalação

Instalação de Aspose.Slides FOSS para C++

Aspose.Slides FOSS para C++ é uma biblioteca de cabeçalho e fonte construída com CMake. Não tem distribuição binária; você integra diretamente em seu projeto CMak do repositório GitHub. Nenhum Microsoft Office ou outro tempo de execução proprietário é necessário.


Precondições

RequirementDetail
C++ standardC++20 or later
Build systemCMake 3.20 or later
CompilerGCC 10+, Clang 13+, or MSVC 2019+ (any compiler with C++20 support)
Operating systemWindows, macOS, Linux
External dependenciesNone (all dependencies are vendored or header-only)

1. CMake FetchContent (recomendado)

A maneira mais simples de adicionar Aspose.Slides FOSS ao seu projeto é CMake FetchContent . Adicione isso à sua 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)

O CMake descarta o repositório e disponibiliza a biblioteca-alvo. Não é necessário clonagem manual ou instalação em nível de sistema.

Para fixar uma versão específica para compilações reproduzíveis, substitua ``main por um rótulo de lançamento ou comprometa hash:

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. Submódulo Git

Se preferir vender o código-fonte dentro do seu repositório:

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

Então, faça referência a partir do seu `CMakeLists.txt':

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

3. Construir e Verificar

Depois de adicionar a dependência, configure e construa o seu projeto:

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

Criar um mínimo main.cpp para verificar a compilação:

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

Produção prevista:

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

Começo rápido: Crie uma apresentação com um formato

O seguinte programa cria uma nova apresentação, adiciona um retângulo com texto e o salva como arquivo .pptx:

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

Importante: Presentation usa RAII. Quando o objeto sai do escopo, os recursos internos são liberados automaticamente. Você também pode chamar explicitamente ⌒pres.dispose ((() ヽ se necessário; chamá-lo várias vezes é seguro.


Notas da plataforma

Windows, macOS, Linux: A biblioteca é construída de forma idêntica em todas as plataformas. Não há caminhos de código específicos para a plataforma ou extensões binárias.

Docker / CI: Clone ou traga o repositório em sua etapa de construção e execute CMake. Não são necessários pacotes adicionais do sistema além de um compilador C ++ 20 e CMike .

vcpkg / Conan: Atualmente não publicado para vCpKG ou Conon. Use FetchContent ou submódulo git em vez disso.


Recursos adicionais

  • Página do produto: visão geral, resumo das características e início rápido
  • Licença: Detalhes da licença MIT, não é necessária a chave API.
  • Guia de Desenvolvedor: Guías de recursos com exemplos de código
  • Referência API: referência de classe e método

Ver também:

  • Aspose.Slides para C++ Documentação Empresarial
 Português