Aspose.Slides FOSS
C++
快速入门
安装

安装

安装 Aspose.Slides FOSS for 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.

前置条件

要求细节
C++ 标准C++20 或更高版本
构建系统CMake 3.20 或更高版本
编译器GCC 10+、Clang 13+ 或 MSVC 2019+（任何支持 C++20 的编译器）
操作系统Windows、macOS、Linux
外部依赖无（所有依赖均已 vendored 或仅为头文件）

1. CMake FetchContent (Recommended)

将 Aspose.Slides FOSS 添加到项目的最简方式是 CMake FetchContent。将此添加到你的 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 会下载仓库并提供库目标。无需手动克隆或系统级安装。.

要锁定特定版本以实现可复现的构建，请替换 main 为发布标签或提交哈希：:

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

如果你更倾向于将源代码放入自己的仓库中：:

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

然后在你的 CMakeLists.txt:

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

3. Build and Verify

添加依赖后，配置并构建你的项目：:

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

创建一个最小的 main.cpp 以验证构建：:

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

预期输出：:

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

快速入门：使用形状创建演示文稿

以下程序创建一个新的演示文稿，添加一个带文本的矩形，并将其保存为一个 .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;
}

重要：: Presentation 使用 RAII。当对象超出作用域时，内部资源会自动释放。您也可以调用 pres.dispose() 显式地（如果需要）；多次调用也是安全的。.

平台说明

Windows、macOS、Linux：: 该库在所有平台上构建方式完全相同。没有平台特定的代码路径或二进制扩展。.

Docker / CI：: 在构建步骤中克隆或获取仓库并运行 CMake。除 C++20 编译器和 CMake 外，无需其他系统软件包。.

vcpkg / Conan：: 目前未发布到 vcpkg 或 Conan。请改用 FetchContent 或 git 子模块。.

附加资源

 中文