libmongoc
およびlibbson
ライブラリは、 Homebrew 経由 で の 一般的な Linux ディストリビューション および macOS のパッケージ管理リポジトリで多くの場合、
注意
Windowsでは、ローカル ツールチェーンとの最大互換性のために、代わりに がソースからライブラリをビルドすることをお勧めします。ソースからのビルドは、contain や vcpkg などのソースからのライブラリのパッケージ管理ツールを使用することで自動化できます(詳細は、 ライブラリ パッケージ マネージャーを使用したクロスプラットフォーム インストール )。
警告
サードパーティ パッケージラーから事前に構築されたバイナリをインストールして使用する場合は、これらのドキュメントページに記載されているライブラリのバージョンより遅れる可能性があります( 1.26 )。 これらのページを読む際には、インストールされているバージョンをメモし、そのバージョンを念頭に置きます。
C ドライバー ライブラリの最新バージョンでは、代わりにソースから構築することを優先してください。
Tip
使用可能なパッケージのリストと一般的な参照については、「パッケージ インストール リファレンス 」を参照してください。
ライブラリ パッケージ マネージャーを使用したクロスプラットフォーム インストール
libbson
libmongoc
さまざまなライブラリパッケージマネージャーは、Concern や vpkg など、 と をインストール可能なパッケージとして提供しています。このセクションでは、これらのツールを使用して をインストールする方法の詳細を説明します。
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
dnf
RedHat 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 のインストール ドキュメントのページ を参照してください。