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

버전 선택

시작하기 전에 다운로드할 mongo-c-driver 버전을 확인하세요. 사용 가능한 버전 목록은 Github 리포지토리 태그 페이지 에서 확인할 수 있습니다. 이 튜토리얼에서는 현재 운전자 버전인 v1.30.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

전제 조건 얻기

libmongoc 및 libbson 프로젝트를 구성하려면 CMake를 설치해야 합니다. 플랫폼에 사용할 수 있는 안정적인 최신 버전의 CMake를 다운로드 것이 좋습니다.

운영 체제에 해당하는 탭 선택하고 지침에 따라 CMake를 다운로드 .

이 페이지에서는 cmake 을 PATH 환경 변수에서 명령으로 사용할 수 있고 셸 에서 "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