Aspose.Slides FOSS
C++
はじめに
インストール

インストール

C++ 用 Aspose.Slides FOSS のインストール

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
外部依存関係なし（すべての依存関係はベンダー化されているかヘッダーオンリーです）

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 サブモジュールを使用してください。.

追加リソース

 日本語