下载和安装
下载C驱动
C驱动由两个库组成libbson
和 libmongoc
。在本指南中,您将学习如何安装 libmongoc
,它包含在 libbson
中。
您可以使用包管理器安装C驱动,或者从源代码安装库。不同的Linux发行版在用包管理器安装时安装的驱动程序版本不同。因此,在安装驱动程序之前,您应该检查您的发行版包含的版本。
在RedHat Enterprise Linux (RHEL) 发行版中,您可以通过在您的shell中运行以下命令来检查版本
sudo dnf info mongo-c-driver-devel
在基于Debian的发行版中,您可以通过在您的shell中运行以下命令来检查版本
apt-cache policy libmongoc-dev
如果可用的驱动程序版本不是您想要的版本,您可以从源代码安装驱动程序。要了解如何从源代码安装驱动程序,请参阅从源代码构建C驱动库 指南。
要了解如何使用包管理器安装驱动程序,请选择与您的操作系统对应的选项卡
RedHat Enterprise Linux 发行版
您可以在RedHat Enterprise Linux (RHEL) 发行版上安装驱动程序,版本为7或更高版本,或者基于RHEL的发行版,例如
在您在RHEL发行版上安装驱动程序之前(不包括Fedora),您必须首先启用Extra Packages for Enterprise Linux (EPEL) 仓库。您可以通过安装 epel-release
软件包来启用EPEL仓库,如下面的示例所示
yum install epel-release
然后,您可以使用 yum
安装C驱动程序。要这样做,请在您的shell中运行以下命令
yum install mongo-c-driver-devel
注意
开发包
前面的代码示例安装了开发包,这是构建使用C驱动程序的应用程序所必需的。要仅安装库而不安装开发文件,请运行以下命令
yum install mongo-c-driver
如果您在安装版本 8 或更高版本的 RHEL 分发版,我们建议使用 dnf
而不是 yum
来运行前面的代码示例。
Fedora
如果您使用的是 Fedora 或版本 8 或更高版本的 enterprise Linux 分发版,您可以使用与前面的示例中显示的相同命令来安装驱动程序,并将 yum
替换为 dnf
。
以下示例展示了如何在 Fedora 分发版中安装 C 驱动程序
dnf install mongo-c-driver-devel
基于 Debian 的分发版
在基于 Debian 的 Linux 分发版中,包括 Ubuntu 和 Ubuntu 衍生版,驱动程序库可以通过高级打包工具(APT)获得。您可以在 shell 中运行以下命令来使用 APT 安装驱动程序
apt install libmongoc-dev
前面的代码示例安装了开发包,这是构建使用C驱动程序的应用程序所必需的。要仅安装库而不安装开发文件,请运行以下命令
apt install libmongoc-1.0-0
对于Windows环境,我们建议从源代码构建C驱动程序库以确保与本地工具链的最大兼容性。您可以使用如之类的源代码库管理工具来自动化源代码构建。
提示
要了解如何开始使用vcpkg,请参阅Microsoft文档中的vcpkg入门指南。
在vcpkg清单模式中,将驱动程序库添加到项目的vcpkg.json
清单文件中,如下例所示
{ // ... "dependencies": [ // ... "mongo-c-driver" ] }
当您使用vcpkg集成构建CMake项目并有一个vcpkg.json
清单文件时,vcpkg会自动在配置之前安装项目的依赖项。
如果您正在使用 vcpkg 经典模式,您可以在 shell 中运行以下命令来安装驱动程序
vcpkg install mongo-c-driver
安装驱动程序后,将提供标准的 CMake 配置文件以及生成的 IMPORTED
目标。您可以根据以下示例创建一个 CMakeLists.txt
文件
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 一次只安装一种类型。
要使用 vcpkg 集成配置 CMake 项目,请在配置命令中设置 CMake 工具链文件,在 shell 中运行以下命令
cmake -S . -B _build -D CMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake
您可以通过使用 Homebrew 软件包管理器 在 MacOS 上下载 C 驱动程序。为此,请在 shell 中运行以下命令
brew install mongo-c-driver
完成这些步骤后,您已在您的机器上安装了 C 驱动程序。
注意
如果您在此步骤中遇到问题,请在 MongoDB 社区论坛 中寻求帮助或使用评分此页面 选项卡在页面的右侧或右下角提交反馈。