mirror of
https://github.com/microsoft/vcpkg.git
synced 2024-12-12 11:09:07 +08:00
37 lines
2.7 KiB
Markdown
37 lines
2.7 KiB
Markdown
|
# 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](https://github.com/Microsoft/vcpkg). 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.
|