As bibliotecas libmongoc e libbson estão frequentemente disponíveis nos repositórios de gerenciamento de pacotes de distribuições comuns do Linux e macOS via Homebrew.
Observação
Para Windows, recomenda-se em vez disso construir as bibliotecas a partir da origem, para compatibilidade máxima com a cadeia de ferramentas local. A compilação a partir da origem pode ser automatizada usando uma ferramenta de gerenciamento de pacote de bibliotecas de origem, como Conan ou vcpkg (consulte: Instalações de plataforma cruzada usando gerenciadores de pacotes de bibliotecas).
Aviso
Se você instalar e usar binários pré-compilados de um empacotador de terceiros, é possível que ele fique atrasado em relação à versão das bibliotecas descritas nestas páginas de documentação (1.28). Observe a versão que você instala e lembre-se dela ao ler estas páginas.
Para as versões mais atualizadas das bibliotecas de drivers C, prefira construir a partir da origem.
Dica
Para obter uma listagem e referência comum sobre pacotes disponíveis, consulte Referência de instalação de pacotes.
Instalações de plataforma cruzada usando gerenciadores de pacotes de bibliotecas
Vários gerenciadores de pacote de bibliotecas oferecem libbson e libmongoc como pacotes instaláveis, incluindo Conan e vcpkg. Esta seção detalhará como instalar usando essas FERRAMENTAS.
Instalando usando vpkg
Observação
Esta página não detalha como começar a usar o vspkg. Para isso, consulte Introdução ao vspkg
No modo de manifesto vcpkg, adicione as bibliotecas desejadas ao arquivo de manifesto vcpkg.json do seu projeto:
{ // ... "dependencies": [ // ... "mongo-c-driver" ] }
Quando você cria um projeto CMake com integração vpkg e tem um arquivo de manifesto vcpkg.json , o vpkg instalará automaticamente as dependências do projeto antes de prosseguir com a fase de configuração, portanto nenhum trabalho manual adicional é necessário.
No modo clássico do vpkg, o libbson e o libmongoc podem ser instalados através dos nomes libbson e mongo-c-driver, respectivamente:
$ vcpkg install mongo-c-driver
(A instalação do mongo-c-driver também instalará transitivamente o libbson .)
Quando os pacotes libmongoc e libbson estiverem instalados e o vpkg tiver sido integrado corretamente ao seu sistema de compilação, as bibliotecas desejadas estarão disponíveis para importação.
Com o CMake, o pacote padrão de arquivo de configuração estará disponível, bem como os destinos IMPORTED gerados:
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
A expressão grande do gerador $<IF:$<TARGET_EXISTS...>:...> pode ser usada para alternar o tipo de link do libmongoc com base em qualquer formulário disponível no comando find_package() . libmongoc suporta a compilação com tipos de bibliotecas dinâmicas e estáticas , mas o vspkg instalará somente um dos dois tipos de biblioteca por vez.
Para configurar um projeto CMake com integração vspkg é uma questão de configurar o arquivo de ferramenta CMake no comando initial configure:
$ cmake -S . -B _build -D CMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake
Instalando no Linux
Os nomes e processo de instalação do libbson e libmongoc variam entre distribuições, mas geralmente seguem um padrão semelhante.
As seguintes distribuições Linux fornecem pacotes libbson e libmongoc :
Fedora via
dnfRedHat Enterprise Linux (RHEL) 7 e mais recente e distribuições baseadas em RHEL 7 ou mais recente, incluindo CentOS, Rocky Linux e AlmaLinux, via
yum/dnfe ECEL.Distribuições Debian e baseadas em Debian, incluindo Ubuntu e derivados de Ubuntu, via APT.
Dica
Para obter uma lista de pacotes disponíveis e opções de pacote, consulte: Referência de instalação do pacote.
Sistemas baseados em RedHat
Em distribuições Linux baseadas em RedHat, incluindo Fedora, CentOS, Rocky Linux e AlmaLinux, as bibliotecas de drivers C podem ser instaladas com Yum/DNF.
Observação
Para Fedora e Linux empresarial da versão 8 ou superior, recomenda-se utilizar o comando dnf no lugar de qualquer comando yum .
Importante
Exceto para Fedora:
As bibliotecas de drivers C estão disponíveis apenas na versão 7 e mais recente das respectivas distribuições Linux corporativas. No entanto, as bibliotecas de drivers C não estão disponíveis nos repositórios padrão, mas podem ser obtidas ativando os repositórios ECEL. Isso pode ser feito instalando o pacote epel-release :
# yum install epel-release
epel-release deve ser instalado antes de tentar instalar as bibliotecas de driver C (ou seja, não é possível instalar ambas em um único comando yum install ).
Para instalar somente o libbson , instale o pacote libbson-devel :
# yum install libbson-devel
Para instalar o driver de banco de dados C completo (libmongoc), instale o mongo-c-driver-devel:
## (This package will transitively install libbson-devel) # yum install mongo-c-driver-devel
Para verificar qual versão está disponível, consulte https://packages.fedoraproject.org/pkgs/mongo-c-driver/mongo-c-driver-devel.
Os pacotes de desenvolvimento (terminando em -devel) incluem arquivos necessários para construir aplicativos utilizando libbson e libmongoc. Para instalar somente as bibliotecas sem arquivos de desenvolvimento, instale os pacotes libbson ou mongo-c-driver-libs .
Sistemas baseados em Debian
Em distribuições Linux baseadas em Debian, incluindo Ubuntu e derivados Ubuntu, libbson e libmongoc estão disponíveis nos repositórios de distribuição via APT e podem ser instalados como libbson-dev e libmongoc-dev, respectivamente:
## Update repository information, if necessary: # apt update
Para instalar somente o libbson:
# apt install libbson-dev
Para instalar o libmongoc (que também instalará o libbson):
# apt install libmongoc-dev
Para verificar qual versão está disponível, execute apt-cache policy libmongoc-dev.
Os pacotes de desenvolvimento (terminando em -dev) incluem arquivos necessários para construir aplicativos utilizando libbson e libmongoc. Para instalar somente as bibliotecas sem arquivos de desenvolvimento, instale os pacotes libbson-1.0-0 ou libmongoc-1.0-0 .
Instalando no macOS com Homebrew
Se você estiver usando um sistema macOS, as bibliotecas de drivers C (incluindo libmongoc e libbson) podem ser instaladas usando o gerenciador de pacote Homebrew com o seguinte comando:
$ brew install mongo-c-driver
Observação
A Homebrew não fornece pacotes separados para libbson e libmongoc.
Dica
O gerenciador de pacote Homebrew não está instalado por padrão no macOS. Para obter informações sobre como instalar o Homebrew, consulte a página de documentação de instalação do Homebrew.