Fornisci codice non principale

Per abilitare i team che contribuiscono all'implementazione non principale ai progetti della federazione la proprietà completa del processo di revisione, sono stati creati i seguenti progetti con diritti +2 aperti per tutti i team. Questo alleggerisce il team principale della federazione l'onere di tutte le revisioni del codice non correlate al framework di base e allo stesso tempo consentendo agli altri team di iterare più velocemente nel ciclo di revisione.

Un src non principale è definito come codice non richiesto dalla federazione che sia funzionale (ad es. test personalizzati, configurazioni, test utilità).

IMPORTANTE: una chiave src non di core non deve estendere le classi di federazione di base. Questo ha un impatto sul futuro refactoring e pulizia. In caso di dubbi sul codice appartiene al ruolo principale o al contributo, contatta android-tradefed@ per chiarimenti. Il team principale della federazione è lieto di fornire consigli e ricevere richieste di funzionalità.

Un esempio di classe principale della federazione è qualsiasi classe nella com.google.android.tradefed.build pacchetto come: com.google.android.tradefed.build.LaunchControlProvider

Anche in questo caso, non esitare a contattarci se hai dubbi su quale possa essere considerata una ad android-tradefed@.

[TOC]

Contrib projects percorsi

A chi sono destinati questi progetti di contributo?

Se attualmente lavori nei progetti della federazione per la scrittura di test/test utilità/configurazioni, questi progetti sono stati creati per te.

Revisioni del codice nei progetti di contributo

L'obiettivo dei progetti di contributo è consentirti di sviluppare in Tradefed. senza bisogno della revisione del team principale (android-tradefed@). Quindi ci aspettiamo al tuo team o a chiunque abbia familiarità con il contesto per eseguire le revisioni del codice i tuoi CL.

Non esitare a contattare android-tradefed@ in caso di problemi o se hai bisogno di assistenza sul caso specifico, ma non fare affidamento su questo per impostazione predefinita per eseguire la revisione del codice contribuisci. Il team Tradefed non ha SLO per quanto riguarda le revisioni del codice in contributo.

Dove posso iniziare a lavorare a questi progetti?

Sono stati aggiunti ai seguenti manifest di ramo e fanno già parte di pagamento sulla piattaforma principale. Se non vedi i progetti nel tuo ambiente, ti manca il contributo alla sincronizzazione dei repository.

  • principale
  • traffatto
  • sviluppo oc
  • Oc-dev-plus-aosp
  • nyc-mr2-dev-plus-aosp
  • principale-daydream-dev
  • principale-senza fornitore
  • Wear-main

Sviluppo e test

Lo sviluppo nel contributo dovrebbe avere lo stesso livello di qualità di qualsiasi altra piattaforma nei repository Android:

  • Rispetta le linee guida per la formattazione di Android
  • Il codice viene testato e inviato con test
  • Il design è intelligente e logico

Come faccio a testare i contributi localmente?

AOSP

In alternativa, i test delle unità di misura del contributo si trovano platform/tools/tradefederation/contrib/tests/src/ e i test delle unità vanno aggiunti com.android.tradefed.prodtests.UnitTests nei script di test locali e precedenti all'invio.

Script locali Aosp dopo l'avvio del pranzo:

tools/tradefederation/core/tests/run_tradefed_aosp_presubmit.sh

Aggiornamento delle regole di build per i progetti di contributo

Le regole di build (makefile) si trovano nella propria cartella build/ e sono bloccate da un OWNERS file che ti impedirà di modificarlo senza un'ulteriore revisione del team principale. Questa è l'unica limitazione al progetto di contributo.

Abbiamo bisogno di questa revisione per assicurarci che non vengano aggiunte dipendenze impreviste al progetti in generale scambiati senza la conoscenza o l'accordo del team principale. Se hai davvero bisogno di aggiungere nuove dipendenze, contatta android-tradefed@ per esaminare i tuoi casi d'uso e darti consigli.