Contribuir com código não principal

Permitir equipes que contribuam com src não essenciais para os projetos da federação propriedade total do processo de revisão, os seguintes projetos foram criados com direitos +2 abertos para todas as equipes. Isso alivia a equipe central da TradeFederação da carga de todas as revisões de código não relacionadas ao framework principal, além de permitindo que as outras equipes iterem mais rapidamente em seu ciclo de revisão.

Non-core src é um código que não é exigido pela federação comercial. para funcionar (por exemplo, testes personalizados, configurações, testes específicos utilitários).

IMPORTANTE: os src não principais não podem estender as classes principais da federação. Isso afeta a refatoração/limpeza futura. Se você não tiver certeza se o código pertence a core ou contrib, entre em contato com android-tradefed@ para esclarecimentos. A equipe principal da TradeFederation fica feliz em aconselhar e receber solicitações de recursos.

Um exemplo de classe de federação principal seria qualquer classe na O pacote com.google.android.tradefed.build está como: com.google.android.tradefed.build.LaunchControlProvider

Entre em contato novamente se não tiver certeza do que seria considerado um conteúdo principal para android-tradefed@.

[SUMÁRIO]

Projetos contrib caminhos

Para quem são esses projetos de contribuição?

Se você trabalha atualmente em projetos da TradeFederação, criando testes/testes utilitários/configs, esses projetos foram criados para você.

Revisões de código em projetos de contribuição

O objetivo dos projetos de contribuição é permitir que você faça desenvolvimento no Tradefed. sem precisar da análise da equipe principal (android-tradefed@). Portanto, esperamos sua equipe ou qualquer pessoa familiarizada com o contexto para realizar as revisões de código seus CLs.

Sempre entre em contato com android-tradefed@ se tiver dificuldades ou precisar de orientação sobre um caso específico, mas não dependa dele por padrão para fazer a revisão de código em contribuições A equipe do Tradefed não tem SLO quando se trata de revisões de código em contribuição.

Por onde posso começar a trabalhar nesses projetos?

Elas foram adicionadas aos manifestos de ramificação a seguir e já fazem parte de para finalizar a compra da plataforma principal. Se os projetos não estiverem no seu ambiente, você estará em um repositório diferente de contribuir.

  • principal
  • trocou
  • oc-dev
  • "oc-dev-plus-".
  • nyc-mr2-dev-plus-osp
  • main-daydream-dev
  • principal-sem-fornecedor
  • wear-main

Desenvolvimento e teste

Espera-se que o desenvolvimento em Contribu tenha a mesma barra de qualidade que em qualquer outro lugar nos repositórios do Android:

  • Respeitar as diretrizes de formatação do Android
  • O código é testado e enviado com testes
  • O design é inteligente e faz sentido

Como faço para testar localmente na contribuição?

AOSP

Em AOSP, os testes de unidade de contrib estão localizados em platform/tools/tradefederation/contrib/tests/src/ e testes de unidade precisam ser adicionados com.android.tradefed.prodtests.UnitTests (link em inglês) para ser retirado no pré-envio e nos scripts de teste local.

Scripts locais de Aosp após o almoço:

tools/tradefederation/core/tests/run_tradefed_aosp_presubmit.sh

Atualização das regras de build para contribuir com projetos

As regras de build (makefiles) ficam na própria pasta build/ e são bloqueadas por um OWNERS que impedirá que você as modifique sem uma revisão adicional da equipe principal. Essa é a única limitação ao projeto de contribuição.

Precisamos dessa revisão para garantir que nenhuma dependência inesperada seja adicionada à projetos gerais da Tradefed sem o conhecimento ou o acordo da equipe principal. Se você realmente precisar que algumas novas dependências sejam adicionadas, entre em contato com android-tradefed@ para analisar seus casos de uso e aconselhar você.