文档菜单
文档首页
/ / /
C驱动程序
/

下载和安装

C驱动由两个库组成libbsonlibmongoc。在本指南中,您将学习如何安装 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 (RHEL) 发行版上安装驱动程序,版本为7或更高版本,或者基于RHEL的发行版,例如

  • CentOS

  • Rocky Linux

  • AlmaLinux

在您在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 或版本 8 或更高版本的 enterprise Linux 分发版,您可以使用与前面的示例中显示的相同命令来安装驱动程序,并将 yum 替换为 dnf

以下示例展示了如何在 Fedora 分发版中安装 C 驱动程序

dnf install mongo-c-driver-devel

在基于 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 社区论坛 中寻求帮助或使用评分此页面 选项卡在页面的右侧或右下角提交反馈。

返回

入门指南