インストール

Overview

このガイドでは、開発マシン上で Aspose.Cells FOSS for C++ をセットアップし、ライブラリをビルドし、最小限のスプレッドシート作成プログラムで設定を検証する方法を示します。

前提条件

ステップ 1 — リポジトリをクローン

以下のように Aspose.Cells FOSS for C++ のソースリポジトリをクローンします:

git clone https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Cpp.git
cd Aspose.Cells-FOSS-for-Cpp

ステップ 2 — サンプルをビルド

バンドルされている CMake 設定を使用してサンプルプロジェクトをビルドします。これによりライブラリもコンパイルされます:

cd samples
mkdir build
cd build
cmake ..
cmake --build .

ビルド出力はコンパイルされたバイナリを build/ ディレクトリに配置します。

ステップ3 — ライブラリをプロジェクトに組み込む

FetchContent またはローカルパスのインクルードを使用して、ライブラリのヘッダーとソースツリーを自分の CMakeLists.txt に追加します:

cmake_minimum_required(VERSION 3.15)
project(MyProject CXX)

set(CMAKE_CXX_STANDARD 17)

# Option A: local path
add_subdirectory(path/to/Aspose.Cells-FOSS-for-Cpp)

add_executable(MyApp main.cpp)
target_link_libraries(MyApp PRIVATE Aspose.Cells.Foss.Cpp)

代替案: NuGet でインストールする

プロジェクトがすでに C++ の依存関係管理に NuGet を使用している場合、ソースからビルドする代わりに公開パッケージをインストールできます:

dotnet add package Aspose.Cells.Cpp.FOSS

その後、通常通りプロジェクトでパッケージにリンクします。上記のステップ1〜3は省略し、ステップ4に進んでインストールを確認してください。

ステップ4 — インストールの確認

XLSX ファイルを作成して保存する最小限の main.cpp を作成します:

#include "aspose/cells_foss/Workbook.h"
#include "aspose/cells_foss/WorksheetCollection.h"
#include "aspose/cells_foss/Worksheet.h"
#include "aspose/cells_foss/Cell.h"

using namespace Aspose::Cells_FOSS;

int main() {
    Workbook workbook;
    Worksheet& sheet = workbook.GetWorksheets()[0];
    sheet.SetName("Hello");
    sheet.GetCells()["A1"].PutValue("Hello, Aspose.Cells FOSS!");
    workbook.Save("hello.xlsx");
    return 0;
}

ビルドして実行します。作業ディレクトリに hello.xlsx が作成されれば、インストールは成功です。

ヒントとベストプラクティス

• 他のライブラリとのシンボル衝突を防ぐため、常に Aspose::Cells_FOSS 名前空間を使用してください。
• ほとんどの操作のインクルードエントリーポイントは aspose/cells_foss/Workbook.h です；必要に応じて Worksheet.h や Cell.h などの追加ヘッダーをインクルードしてください。
• CMake 3.15 以降を使用してください。古いバージョンではバンドルされたターゲット構成がサポートされない可能性があります。
• 本番ビルドでは、最適化を有効にするために -DCMAKE_BUILD_TYPE=Release を cmake に渡してください。
• クローンしたディレクトリをライブラリのルートとして保持してください。個々のヘッダーをコピーしないでください — ライブラリヘッダー内の相対インクルードパスは元のディレクトリ構成に依存しています。

一般的な問題

次のステップ

• License — Aspose.Cells の C++ 用 FOSS に関する MIT ライセンス条項を確認する。
• Features — サポートされているすべてのスプレッドシート機能を閲覧する。
• スプレッドシート管理の操作 — ワークブックとワークシートの操作を学ぶ。

参照

• Aspose.Cells for C++ — Enterprise Documentation