Compartilhar via


Tutorial: Adicionar uma porta ao registro de código aberto vcpkg

Este tutorial orienta você sobre como empacotar uma biblioteca para vcpkg usando uma sobreposição personalizada. Recomendamos que você leia o tutorial Empacotando uma biblioteca antes de continuar.

Pré-requisitos

  • Um terminal
  • Git

1 - Garfe o repositório vcpkg

  1. Navegue até o repositório do GitHub vcpkg.
  2. Clique no botão "Garfo" no canto superior direito da página.
  3. Escolha sua conta do GitHub como o destino para o fork.

2 - Adicione seu garfo como um controle remoto

Navegue até o diretório onde você clonou o repositório vcpkg original e adicione seu fork como um controle remoto. Substitua <Your-GitHub-Username> pelo seu nome de usuário do GitHub:

git remote add myfork https://github.com/<Your-GitHub-Username>/vcpkg.git

Você pode verificar se o controle remoto foi adicionado corretamente executando:

git remote -v

Você deve ver myfork listado entre os remotos.

3 - Criar uma ramificação de tópico

Antes de fazer alterações, geralmente é bom criar uma nova ramificação:

git checkout -b <topic-branch-name>

4 - Copie a porta de sobreposição para o ports diretório

Adicione a vcpkg-sample-library porta que foi criada no tutorial de empacotamento de uma biblioteca ao vcpkg\ports diretório:

cp -R <path/to/vcpkg-sample-library> <ports/vcpkg-sample-library>
xcopy <path/to/vcpkg-sample-library> <ports/vcpkg-sample-library> /E
Copy-Item -Path <path/to/vcpkg-sample-library> -Destination <ports/vcpkg-sample-library> -Recurse

5 - Confirmar e enviar alterações

  1. Confirme as alterações:

     git add ports/<library-name>
     git commit -m "Add vcpkg-sample-library to vcpkg"
    
  2. Executar vcpkg x-add-version:

    vcpkg x-add-version vcpkg-sample-library
    
  3. Confirmar alterações de versão

     git commit -m "version database"
    
  4. Empurre as alterações para o garfo:

    git push myfork <topic-branch-name>
    

6 - Criar uma solicitação pull

  1. Navegue até o repositório bifurcado no GitHub.
  2. Clique no botão "Comparar & pull request".
    1. Verificar as alterações
    2. Adicionar um título descritivo e comentários
    3. Preencha a lista de verificação de revisão de pr
  3. Clique em "Criar solicitação pull".

É isso! Você adicionou com êxito um port ao registro curado do vcpkg.

Próximas etapas

Para obter mais informações, consulte: