从源代码构建 C 驱动程序库

选择版本

开始之前，请了解要下载哪个版本的mongo-c-driver 。您可以在 GitHub存储库标签页面 找到可用版本的列表。本教程记录了当前的驾驶员版本 v1 。29 。0 。

在本页的其余部分中， $VERSION将指您将为本教程构建的mongo-c-driver的版本号。

获取源代码

通过以下方式之一获取 mongo-c-driver源代码：

• 使用git 克隆存储库（推荐）。有关更多信息，请参阅使用 Git 下载。

• 下载特定版本的源存档。有关更多信息，请参阅下载版本存档。

$ git clone https://github.com/mongodb/mongo-c-driver.git --branch="$VERSION" "$SOURCE"

## Download using wget:
$ wget "https://github.com/mongodb/mongo-c-driver/archive/refs/tags/$VERSION.tar.gz" \
     --output-document="mongo-c-driver-$VERSION.tar.gz"
## Extract using tar:
$ tar xf "mongo-c-driver-$VERSION.tar.gz"

## Using curl:
$ curl "https://github.com/mongodb/mongo-c-driver/archive/refs/tags/$VERSION.tar.gz" \
     --output="mongo-c-driver-$VERSION.tar.gz"
## Extract using tar:
$ tar xf "mongo-c-driver-$VERSION.tar.gz"

## Use Invoke-WebRequest:
PS> $url = "https://github.com/mongodb/mongo-c-driver/archive/refs/tags/$VERSION.zip"
PS> $file = "mongo-c-driver-$VERSION.zip"
PS> Invoke-WebRequest -UseBasicParsing -Uri $url -OutFile $file
## Extract using Expand-Archive:
PS> Expand-Archive mongo-c-driver-$VERSION.zip

获取先决条件

您必须安装 CMake 才能配置libmongoc 和libbson 项目。我们强烈建议您下载适用于您的平台的最新 CMake 稳定版本。

选择与操作系统对应的标签页，然后按照说明下载CMake：

本页假定 cmake 可用作 PATH 环境变量上的命令，并且可作为“cmake”从Shell中执行。您可以通过命令行向 CMake 请求 --version 来进行测试，如以下代码所示：

 cmake --version
 cmake version 3.21.4
CMake suite maintained and supported by Kitware (kitware.com/cmake).

为 libbson 配置

令名称$BUILD为路径$SOURCE/_build 。 这将是 CMake 写入构建文件的目录。

利用位于$SOURCE的mongo-c-driver的源目录和构建目录$BUILD ，可以从命令行执行以下命令，以同时使用libbson和libmongoc配置项目：

$ cmake -S $SOURCE -B $BUILD \
   -D ENABLE_EXTRA_ALIGNMENT=OFF \
   -D ENABLE_AUTOMATIC_INIT_AND_CLEANUP=OFF \
   -D CMAKE_BUILD_TYPE=RelWithDebInfo \
   -D BUILD_VERSION="$VERSION" \
   -D ENABLE_MONGOC=OFF

如果满足所有依赖项，则上述命令应成功执行并以以下内容结束：

$ cmake …
## … (Lines of output) …
-- Generating done
-- Build files have been written to: $BUILD

如果配置因错误而失败，请参阅 CMake 输出以获取错误消息和信息。 在继续之前确保配置成功。

构建项目

成功配置项目后，可以使用 CMake 执行构建：

$ cmake --build $BUILD --config RelWithDebInfo --parallel

如果配置正确并且满足所有依赖关系，则上述命令应继续编译和链接已配置的组件。 如果上述命令失败，则您的环境可能有错误，或者您使用的是不受支持/未经测试的平台。 有关更多信息，请参阅构建工具输出。

安装构建结果

令$PREFIX为路径$SOURCE/_install 。 我们可以使用 CMake 来安装构建结果：

$ cmake --install "$BUILD" --prefix "$PREFIX" --config RelWithDebInfo

此命令会将mongo-c-driver构建结果安装到$PREFIX目录中。

使用 libmongoc 进行配置

如果您从配置 libbson开始执行上述步骤，则最终结果仅包含libbson ，而不包含完整的 C 数据库驱动程序库。 使用ENABLE_MONGOC CMake 变量启用/禁用libmongoc的构建。 再次重新运行 CMake，但将ENABLE_MONGOC设置为TRUE ：

$ cmake -D ENABLE_MONGOC=ON $BUILD

如果上述命令成功，则项目已重新配置为使用libmongoc进行构建。 再次按照“构建项目并安装构建结果”中的流程来构建和安装libmongoc 。

$ xcode-select --install