Diretrizes de Contribuição

Vcpkg é um esforço da comunidade para construir um ecossistema produtivo e robusto de bibliotecas nativas - suas contribuições são inestimáveis!

Problemas (issues)

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.

Pull Requests

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.

Diretrizes de 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 brutas execute_command. Isso facilita a manutenção de longo prazo quando novos recursos (como sinalizadores de compilador personalizados ou geradores) são adicionados.

Jurídico

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.