libmongoc
およびlibbson
ライブラリは、 Homebrew 経由 で の 一般的な Linux ディストリビューション および macOS のパッケージ管理リポジトリで多くの場合、
注意
For Windows, it is recommended to instead build the libraries from source, for maximum compatibility with the local toolchain. Building from source can be automated by using a from-source library package management tool such as Conan or vcpkg (See: Cross Platform Installs Using Library Package Managers).
警告
サードパーティ パッケージラーから事前に構築されたバイナリをインストールして使用する場合は、これらのドキュメントページに記載されているライブラリのバージョンより遅れる可能性があります( 1.27 )。 これらのページを読む際には、インストールされているバージョンをメモし、そのバージョンを念頭に置きます。
C ドライバー ライブラリの最新バージョンでは、代わりにソースから構築することを優先してください。
Tip
使用可能なパッケージのリストと一般的な参照については、「パッケージ インストール リファレンス 」を参照してください。
ライブラリ パッケージ マネージャーを使用したクロスプラットフォーム インストール
Various library package managers offer libbson
and libmongoc
as installable packages, including Conan and vcpkg. This section will detail how to install using those tools.
vcpkg を使用したインストール
注意
This page will not detail how to get started using vcpkg. For that, refer to Get started with vcpkg
In vcpkg manifest mode, add the desired libraries to your project's vcpkg.json
manifest file:
{ // ... "dependencies": [ // ... "mongo-c-driver" ] }
vcpkg 統合を使用して Cake プロジェクトを構築し、 vcpkg.json
マニフェスト ファイルがある場合、vcpkg は構成フェーズに進む前にプロジェクトの依存関係を自動的にインストールするため、追加の手動作業は必要ありません。
In vcpkg classic mode, libbson
and libmongoc
can be installed through the names libbson
and mongo-c-driver
, respectively:
$ 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
To check which version is available, see 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 へのインストール
If you are using a macOS system, the C driver libraries (including both libmongoc
and libbson
) may be installed using the Homebrew package manager with the following command:
$ brew install mongo-c-driver
注意
Homebrew では、 libbson
とlibmongoc
の個別のパッケージは提供されていません。
Tip
The Homebrew package manager is not installed by default on macOS. For information on installing Homebrew, refer to the Homebrew installation documentation page.