libmongocおよびlibbson ライブラリは、 Homebrew 経由 で の 一般的な Linux ディストリビューション および macOS のパッケージ管理リポジトリで多くの場合、
注意
Windowsでは、ローカル ツールチェーンとの最大互換性のために、代わりに がソースからライブラリをビルドすることをお勧めします。ソースからのビルドは、Conan や vcpkg などのソースからのライブラリのパッケージ管理ツールを使用することで自動化できます(詳細は、ライブラリ パッケージ マネージャーを使用したクロスプラットフォーム インストール)。
警告
サードパーティ パッケージラーから事前に構築されたバイナリをインストールして使用する場合は、これらのドキュメントページに記載されているライブラリのバージョンより遅れる可能性があります( 1.28 )。 これらのページを読む際には、インストールされているバージョンをメモし、そのバージョンを念頭に置きます。
C ドライバー ライブラリの最新バージョンでは、代わりにソースから構築することを優先してください。
Tip
使用可能なパッケージのリストと一般的な参照については、「パッケージ インストール リファレンス 」を参照してください。
ライブラリ パッケージ マネージャーを使用したクロスプラットフォーム インストール
さまざまなライブラリパッケージマネージャーは、Conan や vcpkg など、libbson と libmongoc をインストール可能なパッケージとして提供しています。このセクションでは、これらのツールを使用して をインストールする方法の詳細を説明します。
vcpkg を使用したインストール
注意
このページでは、 vcpkg の使用を開始する方法について詳しくは、次のとおりです。詳しくは、「 vcpkg を使い始める 」を参照してください。
vcpkg マニフェストモード で、必要なライブラリをプロジェクトの vcpkg.json マニフェストファイルに追加します。
{ // ... "dependencies": [ // ... "mongo-c-driver" ] }
vcpkg 統合を使用して Cake プロジェクトを構築し、 vcpkg.jsonマニフェスト ファイルがある場合、vcpkg は構成フェーズに進む前にプロジェクトの依存関係を自動的にインストールするため、追加の手動作業は必要ありません。
vcpkg クラシックモードでは、libbson と libmongoc は、それぞれ libbson と mongo-c-driver という名前を使用してインストールできます。
$ vcpkg install mongo-c-driver
( mongo-c-driverをインストールするとlibbsonも推移的にインストールされます。)
libmongocとlibbsonパッケージがインストールされ、vcpkg がビルド システムに適切に統合されると、目的のライブラリがインポートできるようになります。
CMax を使用すると、標準の構成ファイル パッケージと、生成されたIMPORTEDターゲットを利用できます。
find_package(mongoc-1.0 CONFIG REQUIRED) target_link_libraries(my-application PRIVATE $<IF:$<TARGET_EXISTS:mongo::mongoc_shared>,mongo::mongoc_shared,mongo::mongoc_static>)
注意
大きな$<IF:$<TARGET_EXISTS...>:...>ジェネレーター式は、 find_package()コマンドから使用可能な形式に基づいて、 libmongocのリンクタイプを切り替えるために使用できます。 libmongocは動的ライブラリ タイプと静的ライブラリ タイプの両方によるビルドをサポートしていますが、vcpkg では一度に 2 つのライブラリ タイプのうち 1 つしかインストールされません。
vcpkg 統合を使用して C# プロジェクトを構成する方法は、 最初の 構成コマンド で CSpec ツールチェーン ファイルを設定する方法によって異なります。
$ cmake -S . -B _build -D CMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake
Linux へのインストール
libbsonとlibmongocをインストールする名前とプロセスはディストリビューションによって異なりますが、通常は同様のパターンに従います。
次の Linux ディストリビューションはlibbson libmongocパッケージと パッケージを提供します。
Fedora via
dnfRedHat Enterprise Linux (RHEL) 7およびそれ以降、RHEL 7以降に基づく および ディストリビューション(CentOS、Rocky Linux、AlmaLinux など)における、
yum/dnfおよび EEL 経由のドキュメントAPT 経由のDebianおよび Debian ベースのディストリビューション( Ubuntuおよび Ubuntu の派生製品を含む)
Tip
使用可能なパッケージとパッケージ オプションのリストについては、「パッケージ インストール リファレンス 」を参照してください。
RedHat ベースのシステム
Fedora 、 CentOS 、 Rocky Linux 、 AlmaLinuxなどの RedHat ベースの Linux ディストリビューションでは、C ドライバー ライブラリはYum/DNF を使用してインストールできます。
注意
バージョン8以降のフェデレーティッド Linux およびエンタープライズ Linux の場合は、 yumコマンドの代わりにdnfコマンドを使用することを推奨します。
重要
Federation: を除く
C ドライバー ライブラリは、それぞれのエンタープライズ Linux ディストリビューションのバージョン7以降でのみ利用できます。 ただし、C ドライバー ライブラリはデフォルトのリポジトリでは使用できませんが、OPEL リポジトリを有効にすることで取得できます。 これは、 epel-releaseパッケージをインストールすることで可能です。
# yum install epel-release
epel-release は、C ドライバー ライブラリのインストールを試みる前にインストールする必要があります(つまり、1 つのyum installコマンドで両方をインストールすることはできません)。
libbsonのみをインストールするには、 libbson-develパッケージをインストールします。
# yum install libbson-devel
完全な C データベース ドライバー( libmongoc )をインストールするには、 mongo-c-driver-develをインストールします。
## (This package will transitively install libbson-devel) # yum install mongo-c-driver-devel
使用可能なバージョンを確認するには、https://packages.fedoraproject.org/pkgs/mongo-c-driver/mongo-c-driver-devel. を参照してください。
開発パッケージ( -devel )には、 libbsonとlibmongocを使用してアプリケーションを構築するために必要なファイルが含まれています。 開発ファイルを含まないライブラリのみをインストールするには、libbson mongo-c-driver-libsパッケージまたは パッケージをインストールします。
Debian ベースのシステム
Ubuntu および Ubuntu の派生製品を含む Debian ベースの Linux ディストリビューションでは、 libbsonとlibmongocは APT 経由でディストリビューション リポジトリで入手でき、それぞれlibbson-devとlibmongoc-devとしてインストールできます。
## Update repository information, if necessary: # apt update
libbsonのみをインストールするには
# apt install libbson-dev
libmongocをインストールする方法( libbsonもインストールされます)
# apt install libmongoc-dev
利用可能なバージョンを確認するには、 apt-cache policy libmongoc-devを実行します。
開発パッケージ( -dev )には、 libbsonとlibmongocを使用してアプリケーションを構築するために必要なファイルが含まれています。 開発ファイルを含まないライブラリのみをインストールするには、libbson-1.0-0 libmongoc-1.0-0パッケージまたは パッケージをインストールします。
Homebrew を使用した macOS へのインストール
macOS システムを使用している場合、 Cドライバー ライブラリ(libmongoc とlibbson の両方を含む)は、次のコマンドで Homebrewパッケージマネージャーを使用してインストールできます。
$ brew install mongo-c-driver
注意
Homebrew では、 libbsonとlibmongocの個別のパッケージは提供されていません。
Tip
Homebrewパッケージマネージャーは macOS にデフォルトではインストールされていません。Homebrew のインストールについて詳しくは、Homebrew のインストール ドキュメントのページ を参照してください。