libmongoc 및 libbson 라이브러리는 일반 Linux 배포판 및 Homebrew를 통한 macOS의 패키지 관리 리포지토리에서 사용할 수 있는 경우가 많습니다.
참고
For Windows, it is recommended to instead build the libraries from source, for maximum compatibility with the local toolchain. Building from source can be automated by using a from-source library package management tool such as Conan or vcpkg (See: Cross Platform Installs Using Library Package Managers).
경고
타사 패키지 프로그램에서 사전 빌드된 바이너리를 설치하고 사용하는 경우 해당 문서 페이지(1.26)에 설명된 라이브러리 버전보다 뒤처질 수 있습니다. 설치 버전을 기록하고 이 페이지를 읽을 때 염두에 두세요.
C 드라이버 라이브러리의 최신 버전을 사용하려면 소스에서 빌드하는 것이 좋습니다.
팁
사용 가능한 패키지에 대한 목록과 일반적인 참조는 패키지 설치 참조를 참조하세요.
라이브러리 패키지 관리자를 사용한 교차 플랫폼 설치
Various library package managers offer libbson and libmongoc as installable packages, including Conan and vcpkg. This section will detail how to install using those tools.
vcpkg를 사용하여 설치
참고
This page will not detail how to get started using vcpkg. For that, refer to Get started with vcpkg
In vcpkg manifest mode, add the desired libraries to your project's vcpkg.json manifest file:
{ // ... "dependencies": [ // ... "mongo-c-driver" ] }
vcpkg 통합을 사용하여 CMake 프로젝트 를 빌드 하고 vcpkg.json 매니페스트 파일 이 있는 경우 vcpkg는 구성 단계를 진행하기 전에 프로젝트의 종속성을 자동으로 설치하므로 추가 수작업이 필요하지 않습니다.
In vcpkg classic mode, libbson and libmongoc can be installed through the names libbson and mongo-c-driver, respectively:
$ vcpkg install mongo-c-driver
( mongo-c-driver 을 설치하면 libbson 도 이행적으로 설치됩니다.)
libmongoc 및 libbson 패키지가 설치되고 vcpkg가 빌드 시스템에 제대로 통합되면 원하는 라이브러리를 가져올 수 있습니다.
CMake를 사용하면 표준 구성 파일 패키지와 생성된 IMPORTED 대상을 사용할 수 있습니다.
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 도구 체인 파일을 설정하기만 하면 됩니다.
$ cmake -S . -B _build -D CMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake
Linux에 설치
libbson 및 libmongoc 의 이름과 설치 프로세스는 배포판에 따라 다르지만 일반적으로 유사한 패턴을 따릅니다.
다음 Linux 배포판은 libbson 및 libmongoc 패키지를 제공합니다.
dnf를 통한 FedoraRedHat Enterprise Linux(RHEL) 7 이상 및 RHEL 7 이상을 기반으로 하는 배포판(CentOS, Rocky Linux 및 AlmaLinux 포함)은
yum/dnf및 EPEL을 통해 제공됩니다.APT를 통한 Ubuntu 및 Ubuntu 파생 상품을 포함한Debian 및 Debian 기반 배포.
팁
사용 가능한 패키지 및 패키지 옵션 목록은 패키지 설치 참조를 참조하세요.
RedHat 기반 시스템
RedHat 기반 Linux 배포판( Fedora, CentOS, Rocky Linux, AlmaLinux 등)에서 C 운전자 라이브러리는 Yum/DNF와 함께 설치할 수 있습니다.
참고
Fedora 및 엔터프라이즈 Linux 버전 8 이상에서는 yum 명령 대신 dnf 명령을 사용하는 것이 좋습니다.
중요
Fedora 제외:
C 드라이버 라이브러리는 각 엔터프라이즈 Linux 배포의 7 이상 버전에서만 사용할 수 있습니다. 그러나 C 드라이버 라이브러리는 기본 리포지토리에서 사용할 수 없지만 EPEL 리포지토리를 활성화하여 얻을 수 있습니다. 이 작업은 epel-release 패키지를 설치하여 수행할 수 있습니다.
# yum install epel-release
epel-release C 드라이버 라이브러리를 설치하기 전에 설치해야 합니다(즉, 단일 yum install 명령으로 두 라이브러리를 모두 설치할 수는 없습니다).
libbson 만 설치하려면 libbson-devel 패키지를 설치합니다.
# yum install libbson-devel
전체 C 데이터베이스 드라이버(libmongoc)를 설치하려면 mongo-c-driver-devel 을(를) 설치합니다.
## (This package will transitively install libbson-devel) # yum install mongo-c-driver-devel
To check which version is available, see https://packages.fedoraproject.org/pkgs/mongo-c-driver/mongo-c-driver-devel.
개발 패키지( -devel 로 끝남)에는 libbson 및 libmongoc 를 사용하여 애플리케이션을 빌드하는 데 필요한 파일이 포함되어 있습니다. 개발 파일 없이 라이브러리만 설치하려면 libbson 또는 mongo-c-driver-libs 패키지를 설치합니다.
Debian 기반 시스템
Ubuntu 및 Ubuntu 파생 상품을 포함한 Debian 기반 Linux 배포에서 libbson 및 libmongoc 은 APT를 통해 배포 리포지토리에서 사용할 수 있으며, 각각 libbson-dev 및 libmongoc-dev 로 설치할 수 있습니다.
## Update repository information, if necessary: # apt update
libbson 만 설치하려면 다음을 수행합니다.
# apt install libbson-dev
libmongoc 을(를) 설치하려면( libbson 도 설치됨):
# apt install libmongoc-dev
사용 가능한 버전을 확인하려면 apt-cache policy libmongoc-dev 를 실행합니다.
개발 패키지( -dev 로 끝남)에는 libbson 및 libmongoc 를 사용하여 애플리케이션을 빌드하는 데 필요한 파일이 포함되어 있습니다. 개발 파일 없이 라이브러리만 설치하려면 libbson-1.0-0 또는 libmongoc-1.0-0 패키지를 설치합니다.
Homebrew로 macOS에 설치하기
If you are using a macOS system, the C driver libraries (including both libmongoc and libbson) may be installed using the Homebrew package manager with the following command:
$ brew install mongo-c-driver
참고
Homebrew는 libbson 및 libmongoc 에 대한 별도의 패키지를 제공하지 않습니다.
팁
The Homebrew package manager is not installed by default on macOS. For information on installing Homebrew, refer to the Homebrew installation documentation page.