カスタムインストール：ソースからCドライバー ライブラリを構築

バージョンの選択

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

このページの残りの部分で、 $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

前提条件の取得

libmongoc と libbson プロジェクトを構成するには、CSpec をインストールする必要があります。プラットフォームで利用可能な最新の安定バージョンの 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 による構成

If you followed the above steps starting from Configuring for libbson, your final result with only contain libbson and not the full C database driver library. Building of libmongoc is enabled/disabled using the ENABLE_MONGOC CMake variable. Re-run CMake again, but set ENABLE_MONGOC to TRUE:

$ cmake -D ENABLE_MONGOC=ON -B $BUILD -S $SOURCE

If the above command succeeds, then the project has been reconfigured to build with libmongoc. Follow the process at Building the Project and Installing the Built Results again to build and install libmongoc.

$ xcode-select --install