소스에서 C 드라이버 라이브러리 빌드

버전 선택

시작하기 전에 mongo-c-driver 다운로드할 버전을 확인하세요. 사용 가능한 버전 목록은 GitHub 리포지토리 태그 페이지 에서 확인할 수 있습니다. (이 문서를 위해 작성된 1 현재28 버전은..0 입니다.)

이 페이지의 나머지 부분에서 $VERSION 는 이 튜토리얼을 위해 빌드할 mongo-c-driver 의 버전 번호를 나타냅니다.

소스 가져오기

mongo-c-driver 소스 코드 를 얻는 데 권장되는 프라이머리 방법에는 두 가지가 있습니다.

1. git 을(를) 사용하여 리포지토리 를 복제합니다(권장). (아래 참조)

2. 특정 버전의 소스 아카이브를 다운로드합니다. (아래 참조)

$ 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

전제 조건 얻기

프로젝트를 빌드하려면 몇 가지 전제 조건을 사용할 수 있어야 합니다.

libmongoc 및 libbson 프로젝트는 모두 빌드 구성에 CMake를 사용합니다.

$ sh cmake-3.27.0-linux-x86_64.sh --prefix="$HOME/.local" --exclude-subdir --skip-license

이 페이지의 나머지 부분에서는 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 구성 부터 시작하여 위의 단계를 수행한 경우 최종 결과에는 전체 C 데이터베이스 드라이버 라이브러리가 아닌 libbson 만 포함됩니다. libmongoc 빌드는 ENABLE_MONGOC CMake 변수를 사용하여 활성화/비활성화합니다. CMake를 다시 실행하되 ENABLE_MONGOC 를 TRUE 로 설정합니다.

$ cmake -D ENABLE_MONGOC=ON $BUILD

위의 명령이 성공하면 프로젝트가 libmongoc 으로 빌드되도록 재구성된 것입니다. 프로젝트 빌드하기 및 빌드 된 결과 설치하기 의 프로세스에 따라 libmongoc 을 빌드하고 설치합니다.

$ xcode-select --install