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

バージョンの選択

開始する前に、ダウンロードするmongo-c-driver のバージョンを確認してください。使用可能なバージョンのリストは、 GitHubリポジトリタグ ページ で確認できます。このチュートリアルでは、現在のドライバー バージョン v.. について説明します。1291

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

ソースの取得

次のいずれかの方法で mongo-c-driverソースコードを取得します。

• git を使用してリポジトリをクローンします（推奨）。 詳細については、「 Git を使用したダウンロード 」を参照してください。

• 特定のバージョンのソース アーカイブをダウンロードします。 詳細については、「 リリースアーカイブのダウンロード 」を参照してください。

$ 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

前提条件の取得

と プロジェクトを構成するには、CSpeclibmongoclibbson をインストールする必要があります。プラットフォームで利用可能な最新の安定バージョンの Cake をダウンロードすることを強くお勧めします。

オペレーティング システムに対応するタブを選択し、手順に従って CSpec をダウンロードします。

このページでは、cmake が PATH 環境変数のコマンドとして使用でき、 シェルから "cmake" として実行できることを前提としています。 次のコードに示すように、コマンドラインから CMax に --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