高度な構成とインストールのオプション

項目一覧

統合演算子の追加オプション

パッケージマネージャーを使用したインストール
Vcpkg インストール手順
Console をインストールする手順
Homebrew のインストール手順
MongoDB Cドライバーをインストール
高度な構成（静的構成）
mongocxx 3.2 .x 以降で構成する
mongocxx 3.5.0以降で構成する
テストを無効にする
非標準のディレクトリへのインストール
mongocxx 3.1 .x または3.0 .x で構成
トラブルシューティング
macOS でのLibrary not loadedエラーの修正
Linuxでの「共有オブジェクトファイルを開くことができません」エラーの修正

統合演算子の追加オプション

BSON C++ ライブラリや C++ ドライバーを作成して他のコンポーネントに埋め込み、標準ビルドまたはディストリビューションパッケージマネージャーからインストールされたコンポーネントとの競合の可能性を避けたい場合は、次を使用できます: BSONCXX_OUTPUT_BASENAMEおよびMONGOCXX_OUTPUT_BASENAMEオプションをcmakeに適用します。

cmake ..                                            \
    -DBSONCXX_OUTPUT_BASENAME=custom_bsoncxx        \
    -DMONGOCXX_OUTPUT_BASENAME=custom_mongocxx

上記のコマンドでは、 libcustom_bsoncxx.soとlibcustom_mongocxx.soという名前のライブラリ（またはビルドプラットフォームに適した拡張機能）が生成されます。これらのライブラリは標準のシステムディレクトリまたは代替の場所に配置でき、リンクのコマンドラインで-lcustom_mongocxx -lcustom_bsoncxxなどを指定することでにリンクできます（特定のフラグをリンクカーに必要なものに調整できる場合があります）。

パッケージマネージャーを使用したインストール

C++ドライバーをインストールするには、次のパッケージマネージャーを使用できます。

vcpkg
Conan
Homebrew

Vcpkg インストール手順

Vcpkg がまだインストールされていない場合は、次のコマンドを使用してインストールします。

$ git clone https://github.com/Microsoft/vcpkg.git
$ cd vcpkg
$ ./bootstrap-vcpkg.sh

オプションで、Visual Studio 統合を使用してをインストールするには、次の手順に従います。

vcpkg integrate install

ドライバーをインストールします。最新バージョンのドライバーを取得するには、 git pullが必要になる場合があります。

$ ./vcpkg install mongo-cxx-driver

ツールチェーンファイルvcpkg.cmakeを使用して、CSpec に開発ファイルを見つける場所をたとえば次のように指示できます。

-DCMAKE_TOOLCHAIN_FILE=/<path to vcpkg repo>/vcpkg/scripts/buildsystems/vcpkg.cmake

ヘッダーファイルは次の場所にあります。

vcpkg/installed/<CPU ARCHITECTURE>-<OPERATING SYSTEM>/include/

ライブラリのファイルは次の場所にあります。

vcpkg/installed/<CPU ARCHITECTURE>-<OPERATING SYSTEM>/lib/

Console をインストールする手順

パッケージ指定子: mongo-cxx-driver/3.8.0

接続をまだインストールしていない場合は、インストールして接続コマンドを実行します。

$ pip install conan
$ conan profile detect --force

以下をconanfile.txtに追加します。

[requires]
mongo-cxx-driver/3.8.0
[generators]
CMakeDeps
CMakeToolchain

Console 経由でドライバーをインストールし、プロジェクトをビルドします。

$ conan install conanfile.txt --output-folder=build --build=missing
$ cmake \
  -B build \
  -DCMAKE_TOOLCHAIN_FILE=conan_toolchain.cmake \
  -DCMAKE_BUILD_TYPE=Release
$ cmake --build build

Homebrew のインストール手順

MacOS ユーザーは Homebrew を使用して、次のコマンドを実行中してC++ドライバーをインストールできます。

brew install mongo-cxx-driver

Apple Silicon Mac の場合

ヘッダーは次の場所にあります。

/opt/homebrew/include/mongocxx/v_noabi/
/opt/homebrew/include/bsoncxx/v_noabi/

ライブラリファイルは次の場所にあります。

/opt/homebrew/lib/

Intel Mac の場合

ヘッダーは次の場所にあります。

/usr/local/include/mongocxx/v_noabi/
/usr/local/include/bsoncxx/v_noabi/

ライブラリファイルは次の場所にあります。

/usr/local/lib/

MongoDB Cドライバーをインストール

mongocx ドライバーはMongoDB C ドライバー上に構築されます。

mongocx- 3.9.0のビルド C ドライバーが検出されない場合は、は C ドライバーを自動的にダウンロードし、インストールします C ドライバーの既存のインストールを使用するには、C ドライバーがインストールされたディレクトリにCMAKE_PREFIX_PATHを設定します。

mongocx- 3.11 .x の場合 libmongoc 1.28.0以降が必要です。
mongocx- 3.10 .x の場合 libmongoc 1.25.0以降が必要です。
mongocx- 3.9 .x の場合 libmongoc 1.25.0以降が必要です。
mongocx- 3.8 .x の場合 libmongoc 1.24.0以降が必要です。
mongocx- 3.7 .x の場合 libmongoc 1.22.1以降が必要です。
mongocx- 3.6 .x の場合 libmongoc 1.17.0以降が必要です。
mongocx- 3.5 .x の場合 libmongoc 1.15.0以降が必要です。
mongocx- 3.4 .x の場合 libmongoc 1.13.0以降が必要です。
mongocx- 3.3 .x の場合 libmongoc 1.10.1以降が必要です。
mongocx- 3.2 .x の場合 libmongoc 1.9.2以降が必要です。
mongocx- 3.1.4 + の場合、 libmongoc 1.7.0以降が必要です。
mongocx- 3.1 .[ 0 - 3 ] の場合、 libmongoc 1.5.0以降が必要です。
mongocx- 3.0 .x の場合最後の1.4 .x libmongoc のバージョン

パッケージマネージャーが十分に最新のバージョンを提供していることがわかっていない限り、ソースコードをダウンロードしてビルドする必要があります。 Cドライバーリリースページから tarball を取得します。

libmongoc のインストールで、tarball からビルドする手順に従ってください。

業界のベストプラクティスと一部の規制では、TLS 1.1以上の使用が必要です。 MongoDB C ドライバーは、OpenSSL が少なくともバージョン1.0.1の場合、Linux で TLS 1.1をサポートします。 macOS および Windows では、C ドライバーは TLS 1.1をサポートするネイティブ TLS 実装を使用します。

高度な構成（静的構成）

次のサブセクションでは、C++ ドライバーやその依存関係を、一般的な共有ライブラリではなく静的ライブラリとして構成するための詳細オプションについて詳しく説明します。これらのオプションを指定すると、動作の異なるライブラリアーティファクトが生成されます。これらのオプションを利用する前に、さまざまなリンクに関するアプローチの影響を完全に理解していることを確認してください。

.x 以降で構成する`mongocxx`3.2

ユーザーは、 mongocxxを静的ライブラリとして構築するオプションがあります。 これは初めてユーザーには推奨されません。 ユーザーは-DBUILD_SHARED_LIBSオプションを使用してこの動作を有効にできます。

cmake ..                                            \
    -DCMAKE_BUILD_TYPE=Release                      \
    -DBUILD_SHARED_LIBS=OFF

以降で構成する`mongocxx`3.5.0

ユーザーは、 mongocxxを静的ライブラリと共有ライブラリの両方として構築するオプションがあります。ユーザーは-DBUILD_SHARED_AND_STATIC_LIBSオプションを使用してこの動作を有効にできます。

cmake ..                                            \
    -DCMAKE_BUILD_TYPE=Release                      \
    -DBUILD_SHARED_AND_STATIC_LIBS=ON

ユーザーは、静的にリンクされたlibmongocを持つ共有ライブラリとしてmongocxxを構築するオプションがあります。 これは初めてユーザーには推奨されません。 ユーザーは-DBUILD_SHARED_LIBS_WITH_STATIC_MONGOCオプションを使用してこの動作を有効にできます。

cmake ..                                            \
    -DCMAKE_BUILD_TYPE=Release                      \
    -DBUILD_SHARED_LIBS_WITH_STATIC_MONGOC=ON

テストを無効にする

テストターゲットの構成を無効にするには、cmake オプションとして-DENABLE_TESTS=OFFを渡します。

cmake .. -DENABLE_TESTS=OFF
cmake --build .. --target help
# No test targets are configured.

非標準のディレクトリへのインストール

C++ ドライバーを非標準のディレクトリにインストールするには、目的のインストールパスにCMAKE_INSTALL_PREFIXを指定します。

cmake ..                                            \
    -DCMAKE_BUILD_TYPE=Release                      \
    -DCMAKE_INSTALL_PREFIX=$HOME/mongo-cxx-driver

インストールのlibディレクトリに-DCMAKE_INSTALL_RPATH=オプションを指定することも検討してください。これにより、libmongocx.son が libbsoncx.so を見つけられるようになります。

cmake ..                                             \
    -DCMAKE_BUILD_TYPE=Release                       \
    -DCMAKE_INSTALL_PREFIX=$HOME/mongo-cxx-driver    \
    -DCMAKE_INSTALL_RPATH=$HOME/mongo-cxx-driver/lib

C ドライバーが非標準のディレクトリにインストールされている場合は、C ドライバーのインストールパスにCMAKE_PREFIX_PATHを指定します。

cmake ..                                            \
    -DCMAKE_BUILD_TYPE=Release                      \
    -DCMAKE_PREFIX_PATH=$HOME/mongo-c-driver        \
    -DCMAKE_INSTALL_PREFIX=$HOME/mongo-cxx-driver

注意

CMax PATH 変数に複数のパスが必要な場合は、次のようにセミコロンで区切ります。 -DCMAKE_PREFIX_PATH="/your/cdriver/prefix;/some/other/path"

`mongocxx` 3.1 .x または 3.0 .x で構成

-DCMAKE_PREFIX_PATHオプションの代わりに、 -DLIBMONGOC_DIRと-DLIBBSON_DIRオプションを使用してlibmongocインストールディレクトリを指定する必要があります。

cmake ..                                            \
    -DCMAKE_BUILD_TYPE=Release                      \
    -DLIBMONGOC_DIR=$HOME/mongo-c-driver            \
    -DLIBBSON_DIR=$HOME/mongo-c-driver              \
    -DCMAKE_INSTALL_PREFIX=$HOME/mongo-cxx-driver

トラブルシューティング

`Library not loaded`macOS でのエラーの修正

非標準のディレクトリインストールにリンクしているアプリケーションでは、実行時に C++ ドライバーをロードする際にエラーが発生する可能性があります。例:

# Tell pkg-config where to find C++ driver installation.
export PKG_CONFIG_PATH=$HOME/mongo-cxx-driver/lib/pkgconfig
clang++ app.cpp -std=c++11 $(pkg-config --cflags --libs libmongocxx) -o ./app.out
./app.out
# Prints the following error:
# dyld[3217]: Library not loaded: '@rpath/libmongocxx._noabi.dylib'
#   Referenced from: '/Users/kevin.albertson/code/app.out'
#   Reason: tried: '/usr/local/lib/libmongocxx._noabi.dylib' (no such file), '/usr/lib/libmongocxx._noabi.dylib' (no such file)
# zsh: abort      ./app.out

macOS 上の C++ ドライバーのデフォルトのinstall nameには@rpathが含まれます。

otool -D $HOME/mongo-cxx-driver/lib/libmongocxx.dylib
# Prints:
# /Users/kevin.albertson/mongo-cxx-driver/lib/libmongocxx.dylib:
# @rpath/libmongocxx._noabi.dylib

インストール名に@rpathを含めると、リンク中のアプリケーションがライブラリの検索パスのリストを制御できるようになります。

app.out には、 @rpath/libmongocxx._noabi.dylibのロードコマンドが含まれています。 app.outには@rpathを置き換えるエントリがありません。

macOS でこれを解決するために、次の方法が検討されています。

C++ ドライバーライブラリを含むディレクトリにDYLD_FALLBACK_LIBRARY_PATHを渡します。

DYLD_FALLBACK_LIBRARY_PATH=$HOME/mongo-cxx-driver/lib ./app.out
# Prints "successfully connected with C++ driver"

あるいは、リンクオプション-Wl,-rpathを渡して、 @rpathを置き換えるエントリを追加することもできます。

# Tell pkg-config where to find C++ driver installation.
export PKG_CONFIG_PATH=$HOME/mongo-cxx-driver/lib/pkgconfig
# Pass the linker option -rpath to set an rpath in the final executable.
clang++ app.cpp -std=c++11 -Wl,-rpath,$HOME/mongo-cxx-driver/lib $(pkg-config --cflags --libs libmongocxx) -o ./app.out
./app.out
# Prints "successfully connected with C++ driver"

cmake を使用してアプリケーションを構築する場合、デフォルトの RBATH 設定ビルドツリーの使用されているすべてのライブラリへの完全な RBATH を含めます。ただし、インストール時に、cmake はこれらのターゲットの RBATH をクリアするため、空の RBATH を持つ状態でインストールされます。これにより、インストール後にLibrary not loadedエラーが発生する可能性があります。

例:

# Build application ``app`` using the C++ driver from a non-standard install.
cmake \
    -DCMAKE_PREFIX_PATH=$HOME/mongo-cxx-driver \
    -DCMAKE_INSTALL_PREFIX=$HOME/app \
    -DCMAKE_CXX_STANDARD=11 \
    -Bcmake-build -S.
cmake --build cmake-build --target app.out
# Running app.out from build tree includes rpath to C++ driver.
./cmake-build ./cmake-build/app.out
# Prints: "successfully connected with C++ driver"
cmake --build cmake-build --target install
# Running app.out from install tree does not include rpath to C++ driver.
$HOME/app/bin/app.out
# Prints "Library not loaded" error.

実行可能ファイルの R パスがインストールターゲットに保持されるように、 -DCMAKE_INSTALL_RPATH_USE_LINK_PATH=TRUEを設定することを検討してください。

# Build application ``app`` using the C++ driver from a non-standard install.
# Use CMAKE_INSTALL_RPATH_USE_LINK_PATH=TRUE to keep rpath entry on installed app.
cmake \
    -DCMAKE_PREFIX_PATH=$HOME/mongo-cxx-driver \
    -DCMAKE_INSTALL_PREFIX=$HOME/app \
    -DCMAKE_INSTALL_RPATH_USE_LINK_PATH=TRUE \
    -DCMAKE_CXX_STANDARD=11 \
    -Bcmake-build -S.
cmake --build cmake-build --target install
$HOME/app/bin/app.out
# Prints "successfully connected with C++ driver"

RBATH 処理については、cmake のドキュメントを参照してください。詳しくは、を参照してください。

Linuxでの「共有オブジェクトファイルを開くことができません」エラーの修正

# Tell pkg-config where to find C++ driver installation.
export PKG_CONFIG_PATH=$HOME/mongo-cxx-driver/lib/pkgconfig
g++ -std=c++11 app.cpp $(pkg-config --cflags --libs libmongocxx) -o ./app.out
./app.out
# Prints the following error:
# ./app.out: error while loading shared libraries: libmongocxx.so._noabi: cannot open shared object file: No such file or directory

Linux でこれを解決する方法がいくつかあります。

C++ ドライバーライブラリを含むディレクトリにLD_LIBRARY_PATHを渡します。

LD_LIBRARY_PATH=$HOME/mongo-cxx-driver/lib ./app.out
# Prints "successfully connected with C++ driver"

あるいは、リンクオプション-Wl,-rpathを渡してrpathエントリを追加することもできます。

# Tell pkg-config where to find C++ driver installation.
export PKG_CONFIG_PATH=$HOME/mongo-cxx-driver/lib/pkgconfig
# Pass the linker option -rpath to set an rpath in the final executable.
g++ app.cpp -std=c++11 -Wl,-rpath,$HOME/mongo-cxx-driver/lib $(pkg-config --cflags --libs libmongocxx) -o ./app.out
./app.out
# Prints "successfully connected with C++ driver"

例:

# Build application ``app`` using the C++ driver from a non-standard install.
cmake \
    -DCMAKE_PREFIX_PATH=$HOME/mongo-cxx-driver \
    -DCMAKE_INSTALL_PREFIX=$HOME/app \
    -DCMAKE_CXX_STANDARD=11 \
    -Bcmake-build -S.
cmake --build cmake-build --target app.out
# Running app.out from build tree includes rpath to C++ driver.
./cmake-build ./cmake-build/app.out
# Prints: "successfully connected with C++ driver"
cmake --build cmake-build --target install
# Running app.out from install tree does not include rpath to C++ driver.
$HOME/app/bin/app.out
# Prints "cannot open shared object file" error.