ソースから C ドライバー ライブラリを構築

バージョンの選択

開始する前に、ダウンロードする mongo-c-driver のバージョンを確認してください。使用可能なバージョンのリストは、 Githubリポジトリタグ ページ で確認できます。（このドキュメントに記載されている現在のバージョンは 1.28.0 です。）

このページの残りの部分で、 $VERSIONは、このチュートリアル用にビルドするmongo-c-driverのバージョン番号を示します。

ソースの取得

mongo-c-driverソースコードを取得するには、主に次の 2 つの方法があります。

1. gitを使用してリポジトリをクローンする（推奨）。 （以下参照）

2. 特定のバージョンのソース アーカイブをダウンロードします。 （以下参照）

$ git clone https://github.com/mongodb/mongo-c-driver.git --branch="$VERSION" "$SOURCE"

## Download using wget:
$ wget "https://github.com/mongodb/mongo-c-driver/archive/refs/tags/$VERSION.tar.gz" \
     --output-document="mongo-c-driver-$VERSION.tar.gz"
## Extract using tar:
$ tar xf "mongo-c-driver-$VERSION.tar.gz"

## Using curl:
$ curl "https://github.com/mongodb/mongo-c-driver/archive/refs/tags/$VERSION.tar.gz" \
     --output="mongo-c-driver-$VERSION.tar.gz"
## Extract using tar:
$ tar xf "mongo-c-driver-$VERSION.tar.gz"

## Use Invoke-WebRequest:
PS> $url = "https://github.com/mongodb/mongo-c-driver/archive/refs/tags/$VERSION.zip"
PS> $file = "mongo-c-driver-$VERSION.zip"
PS> Invoke-WebRequest -UseBasicParsing -Uri $url -OutFile $file
## Extract using Expand-Archive:
PS> Expand-Archive mongo-c-driver-$VERSION.zip

前提条件の取得

プロジェクトをビルドするには、いくつかの前提条件が利用可能である必要があります。

libmongoc プロジェクトと libbson プロジェクトはどちらもビルド構成に CSpec を使用しています。

$ sh cmake-3.27.0-linux-x86_64.sh --prefix="$HOME/.local" --exclude-subdir --skip-license

このページの残りの部分では、 cmakeがPATH環境変数のコマンドとして使用でき、shell から「 cmake 」として実行できることを前提とします。 これは、コマンドラインから CSpec に--versionをリクエストすることでテストできます。

 $ cmake --version
 cmake version 3.21.4
CMake suite maintained and supported by Kitware (kitware.com/cmake).

libbson の構成

名前$BUILDをパス$SOURCE/_buildにします。 これは、ビルドされたファイルが CSpec によって書き込まれるディレクトリになります。

$SOURCEとビルド ディレクトリ$BUILDのmongo-c-driverのソース ディレクトリがある場合、コマンドラインから次のコマンドを実行して、 libbsonとlibmongocの両方でプロジェクトを構成できます。

$ cmake -S $SOURCE -B $BUILD \
   -D ENABLE_EXTRA_ALIGNMENT=OFF \
   -D ENABLE_AUTOMATIC_INIT_AND_CLEANUP=OFF \
   -D CMAKE_BUILD_TYPE=RelWithDebInfo \
   -D BUILD_VERSION="$VERSION" \
   -D ENABLE_MONGOC=OFF

すべての依存関係が満たされている場合、上記のコマンドは成功し、次の結果で終了します。

$ cmake …
## … (Lines of output) …
-- Generating done
-- Build files have been written to: $BUILD

構成がエラーで失敗した場合、エラー メッセージと情報については CSpec 出力を参照してください。 続行する前に、構成が成功していることを確認してください。

プロジェクトを構築する

プロジェクトが正常に構成されたら、CMax を使用してビルドを実行できます。

$ cmake --build $BUILD --config RelWithDebInfo --parallel

正しく構成され、すべての依存関係が満たされている場合、上記のコマンドは構成されたコンポーネントのコンパイルとリンクに進みます。 上記のコマンドが失敗する場合は、環境にエラーがあるか、サポートされていないかテストされていないプラットフォームを使用している可能性があります。 詳細については、ビルド ツールの出力を参照してください。

ビルド結果のインストール

$PREFIXをパス$SOURCE/_installにします。 CSpec を使用してビルドされた結果をインストールできます。

$ cmake --install "$BUILD" --prefix "$PREFIX" --config RelWithDebInfo

このコマンドは、 mongo-c-driverのビルド結果を$PREFIXディレクトリにインストールします。

libmongoc による構成

libbson 用の構成から上記の手順に沿った場合、 を含む最終結果にはlibbsonのみが含まれ、完全な C データベース ドライバー ライブラリは含まれません。 libmongocのビルドは、 ENABLE_MONGOC Cake 変数を使用して有効または無効にします。 CMax を再度実行しますが、 ENABLE_MONGOCをTRUEに設定します。

$ cmake -D ENABLE_MONGOC=ON $BUILD

上記のコマンドが成功した場合、プロジェクトはlibmongocで構築するように再構成されました。 プロジェクトをビルドし、ビルド結果を再度インストールするのプロセスに従って、 libmongocをビルドしてインストールします。

$ xcode-select --install