Vcpkg é um esforço da comunidade para construir um ecossistema produtivo e robusto de bibliotecas nativas - suas contribuições são inestimáveis!
A maneira mais fácil de contribuir é relatando problemas com vcpkg.exe
ou um pacote existente no GitHub. Ao relatar um problema com vcpkg.exe
, certifique-se de indicar claramente:
- A configuração da máquina: "Estou usando a Atualização de Aniversário do Windows 10. Minha máquina está usando a localidade fr-fr. Executei com sucesso o 'instal boost'."
- As etapas para reproduzir: "I run 'vcpkg list'"
- O resultado esperado: "Eu esperava ver 'boost:x86-windows'"
- O resultado real: "Não recebo nenhuma saída" ou "Recebo uma caixa de diálogo de travamento"
Ao relatar um problema com um pacote, certifique-se de indicar claramente:
- A configuração da máquina (como acima)
- Qual pacote e versão você está construindo: "opencv 3.1.0"
- Quaisquer logs de erro relevantes do processo de compilação.
Estamos felizes em aceitar solicitações de correções, recursos, novos pacotes e atualizações para pacotes existentes. Para evitar desperdício de tempo, recomendamos abrir um tópico para discutir se o PR que você está pensando em fazer será aceitável. Isso é duplamente verdadeiro para recursos e novos pacotes.
Estamos felizes por você estar interessado em enviar um novo pacote! Aqui estão algumas diretrizes para ajudá-lo a criar um excelente portfile:
- Evite patches funcionais. Os patches devem ser considerados um último recurso para implementar a compatibilidade quando não houver outra maneira.
- Quando os patches não puderem ser evitados, não modifique o comportamento padrão. O ciclo de vida ideal de um patch é ser mesclado no upstream e não ser mais necessário. Tente manter esse objetivo em mente ao decidir como corrigir algo.
- Prefira usar as funções
vcpkg_xyz
em vez de chamadas brutasexecute_command
. Isso facilita a manutenção de longo prazo quando novos recursos (como sinalizadores de compilador personalizados ou geradores) são adicionados.
Você precisará preencher um Contrato de Licença de Colaborador (CLA) antes que sua solicitação pull possa ser aceita. Este contrato atesta que você está nos concedendo permissão para usar o código-fonte que está enviando e que este trabalho está sendo enviado sob a licença apropriada para que possamos usá-lo.
Você pode concluir o CLA seguindo as etapas em https://cla.microsoft.com. Assim que recebermos o CLA assinado, analisaremos a solicitação. Você só precisará fazer isso uma vez.