从源代码构建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 环境变量中可用，并可以从 shell 中执行 "cmake"。您可以通过从命令行请求 CMake 的 --version 来测试此功能，如下所示

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

配置libbson

让名称 $BUILD 表示路径 $SOURCE/_build。这将是我们由CMake写入构建文件的目录。

在 mongo-c-driver 的源目录为 $SOURCE，构建目录为 $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 数据库驱动库。使用 CMake 变量 ENABLE_MONGOC 来启用/禁用 libmongoc 的构建。重新运行 CMake，但将 ENABLE_MONGOC 设置为 TRUE

$ cmake -D ENABLE_MONGOC=ON $BUILD

如果上述命令成功执行，则项目已被重新配置以使用 libmongoc 进行构建。按照 构建项目 和 安装构建结果 中的过程再次执行，以构建和安装 libmongoc。

$ xcode-select --install