vcpkg em ambientes de Integração Contínua

2025-05-09

Este artigo descreve como usar efetivamente o vcpkg em um ambiente de integração contínua (CI). Seja porque você está usando vcpkg para gerenciar as dependências do seu projeto ou porque você tem um registro vcpkg personalizado e deseja adicionar testes de CI para suas portas.

Obtenha vcpkg

As etapas para adquirir vcpkg em um ambiente de CI são as mesmas que para adquirir vcpkg em seu ambiente de desenvolvimento. Você precisa adquirir um clone do repositório vcpkg em https://github.com/microsoft/vcpkg e você precisa executar o script bootstrap para obter um executável vcpkg.

Independentemente do método de aquisição que você segue, é altamente recomendável que sua instância vcpkg tenha um histórico completo do Git. O recurso de versionamento do vcpkg depende de ter um histórico de confirmação completo para recuperar versões de porta específicas.

Use vcpkg como um submódulo

Uma maneira fácil de adquirir vcpkg em seu ambiente de CI é declarar o repositório vcpkg como um submódulo do seu repositório.

git submodule init
./vcpkg/vcpkg-bootstrap.sh

Usar a CLI do Git

Um método secundário é executar um comando Git como parte de seus scripts CI para clonar uma instância do repositório vcpkg.

git clone http://github.com/Microsoft/vcpkg
./vcpkg/vcpkg-bootstrap.sh

Utilizar uma ação ou script de terceiros

Dependendo do fornecedor que você usa para executar seu ambiente de CI, pode haver scripts de terceiros prontamente disponíveis que podem adquirir vcpkg em uma única etapa. A equipe vcpkg não mantém nenhum desses scripts de terceiros e você deve ter o devido cuidado se você pretende usar qualquer um deles.

Outros métodos de aquisição

Os métodos a seguir não são recomendados para ambientes de CI.

O script de instalação de uma linha: iex (iwr -useb https://aka.ms/vcpkg-init.ps1) ou . <(curl https://aka.ms/vcpkg-init.sh -L). Este é um método de distribuição vcpkg que permite o recurso experimental "artefatos" e não é recomendado para a maioria dos usuários.

Configurar cache binário

É altamente recomendável que você habilite um cache binário para evitar a reconstrução das dependências do projeto em cada execução de CI.

Para saber mais sobre cache binário, leia estes artigos:

Configurar um cache de ativos

A configuração de um cache de ativos tornará seu ambiente de CI mais resiliente a erros causados por serviços externos.

Para saber mais sobre o cache de ativos, leia estes artigos:

Exemplos

Estes artigos mostram-lhe exemplos de como tudo funciona em conjunto: