Baixar e instalar
Baixe o driver C
O driver C consiste em duas bibliotecas: libbson e libmongoc. Neste guia, você aprenderá como instalar o libmongoc, que vem com o libbson.
Você pode instalar o driver C usando um gerenciador de pacote ou instalando as bibliotecas a partir da origem. Diferentes distribuições do Linux instalam diferentes versões do driver quando instaladas com um gerenciador de pacote . Por esse motivo, você deve verificar a versão que sua distribuição inclui antes de instalar o driver.
Nas distribuições do RedHat Enterprise Linux (RHEL), você pode verificar a versão executando o seguinte comando em seu shell:
sudo dnf info mongo-c-driver-devel
Em distribuições baseadas em Debian, você pode verificar a versão executando o seguinte comando em seu shell:
apt-cache policy libmongoc-dev
Se a versão do driver disponível não for a versão que você deseja, você poderá instalar o driver a partir da origem. Para saber como instalar o driver a partir da origem, consulte o guia Construindo bibliotecas de drivers C a partir da origem.
Para saber como instalar o driver usando um gerenciador de pacote , selecione a guia correspondente ao seu sistema operacional:
Distribuições do RedHat Enterprise Linux
Você pode instalar o driver em distribuições RedHat Enterprise Linux (RHEL), versão 7 ou posterior, ou distribuições baseadas em RHEL, como:
Antes de instalar o driver em uma distribuição RHEL, não incluindo o Fedora, você deve primeiro habilitar o repositório Extra Packages for Enterprise Linux (EPEL). Você pode habilitar o repositório ECEL instalando o pacote epel-release , como mostrado no seguinte exemplo:
yum install epel-release
Em seguida, você pode instalar o driver C usando yum. Para fazer isso, execute o seguinte comando em sua shell:
yum install mongo-c-driver-devel
Observação
Pacotes para desenvolvedores
O exemplo de código anterior instala os pacotes do desenvolvedor, que são necessários para criar aplicativos que usam o driver C. Para instalar apenas as bibliotecas, sem arquivos de desenvolvimento, execute o seguinte comando:
yum install mongo-c-driver
Se você estiver instalando em uma distribuição RHEL que seja versão 8 ou posterior, recomendamos executar os exemplos de código anteriores usando dnf em vez de yum.
Fedora
Se você estiver usando o Fedora ou uma distribuição Linux corporativa da versão 8 ou posterior, poderá instalar o driver usando os mesmos comandos mostrados no exemplo anterior e substituindo yum por dnf.
O exemplo a seguir mostra como instalar o driver C em uma distribuição Fedora:
dnf install mongo-c-driver-devel
Distribuições baseadas em Debian
Em distribuições Linux baseadas em Debian, incluindo Ubuntu e derivados Ubuntu, as bibliotecas de drivers estão disponíveis por meio da Advanced Package Tools (APT). Você pode instalar o driver com o APT executando o seguinte comando em seu shell:
apt install libmongoc-dev
O exemplo de código anterior instala os pacotes do desenvolvedor, que são necessários para criar aplicativos que usam o driver C. Para instalar apenas as bibliotecas, sem arquivos de desenvolvimento, execute o seguinte comando:
apt install libmongoc-1.0-0
Para ambientes Windows, recomendamos criar bibliotecas de drivers C a partir da origem para garantir a máxima compatibilidade com a cadeia de ferramentas local. Você pode automatizar a compilação a partir da origem usando uma ferramenta de gerenciamento de pacote de bibliotecas a partir da origem, como vspkg.
Dica
Para saber como começar a usar o vpkg, consulte o guia de Introdução ao vpkg na documentação da Microsoft.
No modo de manifesto vpkg, adicione a biblioteca de drivers ao arquivo de manifesto do seu vcpkg.json projeto, conforme mostrado no exemplo a seguir:
{ // ... "dependencies": [ // ... "mongo-c-driver" ] }
Quando você cria um projeto CMake com integração vspkg e tem um arquivo de manifesto vcpkg.json, o vpkg instala automaticamente as dependências do projeto antes de prosseguir com a configuração.
Se você estiver usando o modo clássico do vspkg, poderá instalar o driver executando o seguinte comando no shell:
vcpkg install mongo-c-driver
Depois de instalar o driver, o arquivo de configuração CMake padrão estará disponível, bem como os destinos IMPORTED gerados. Você pode criar um arquivo CMakeLists.txt como mostrado no seguinte exemplo:
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>)
Observação
Você pode usar a $<IF:$<TARGET_EXISTS...>:...> expressão do gerador no exemplo anterior para alternar o tipo de link de com base libmongoc no find_package() formulário disponível no comando. libmongoc O permite a compilação com tipos de biblioteca dinâmica e estática, mas o vspkg instala somente um tipo de cada vez.
Para configurar o projeto CMake com integração vspkg, defina o arquivo de cadeia de ferramentas CMake no comando de configuração executando os seguintes comandos em sua shell:
cmake -S . -B _build -D CMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake
Você pode baixar o driver C no MacOS usando o gerenciador de pacote Homebrew. Para fazer isso, execute o seguinte comando em sua shell:
brew install mongo-c-driver
Depois de concluir estas etapas, você terá o driver C instalado em seu computador.
Observação
Caso ocorra algum problema nesta etapa, peça ajuda nos Fóruns da MongoDB Community ou envie feedback pela aba Rate this page no lado direito ou no canto inferior direito desta página.