Współtworzenie kodu niebędącego kodem podstawowym

Aby umożliwić zespołom, które udostępniają w projektach tradefederation niestandardowe źródła kodu, pełną kontrolę nad procesem weryfikacji, utworzyliśmy te projekty z otwartymi uprawnieniami +2 dla wszystkich zespołów. Odciąża to główny zespół federacji zawodowej co nie jest związane ze wszystkimi przeglądami kodu, które nie są związane z podstawową platformą, co pozwoli innym zespołom szybciej poddać je weryfikacji.

Tekst spoza zestawu podstawowego jest zdefiniowany jako kod, który nie jest wymagany przez federację handlu. platformy funkcjonalne (np. testy niestandardowe, konfiguracje, konkretne testy) i usług komunalnych).

WAŻNE: niestandardowe źródła nie powinny rozszerzać podstawowych klas tradefederation. Wpłynie to na przyszłe refaktoryzację lub czyszczenie danych. Jeśli nie masz pewności, czy Twój kod należy do kategorii core czy contrib, skontaktuj się z adresem android-tradefed@, aby uzyskać wyjaśnienie. Główny zespół federacji handlowych chętnie doradza i będzie otrzymywać prośby o dodanie funkcji.

Przykładem klasy podstawowej tradefederation jest dowolna klasa w pakiecie com.google.android.tradefed.build, np.: com.google.android.tradefed.build.LaunchControlProvider

Jeśli nie wiesz, co uznajemy za podstawowy, skontaktuj się z nami. na android-tradefed@.

[SPIS TREŚCI]

Ścieżki projektów Contrib

Dla kogo są przeznaczone te projekty?

Jeśli obecnie pracujesz w projektach federacji zawodowej i przygotowujesz testy/testy narzędzia/konfiguracje, te projekty zostały dla Ciebie utworzone.

Weryfikacje kodu w projektach w ramach programu

Celem projektów contrib jest umożliwienie Ci tworzenia w Tradefed bez konieczności sprawdzania przez zespół główny (android-tradefed@). Przewidujemy, zespołu lub kogoś znającego kontekst, który może przeprowadzić weryfikację kodu listy zmian.

Jeśli utkniesz lub będziesz potrzebować wskazówek dotyczących konkretnego przypadku, skontaktuj się z android-tradefed@. Nie polegaj jednak na tym, że kod zostanie sprawdzony podczas przeglądania kodu w contrib. Zespół, którego dotyczy problem, nie ma docelowego poziomu usług, jeśli chodzi o sprawdzanie kodu w wymianie.

Gdzie mogę rozpocząć pracę nad tymi projektami?

Zostały one dodane do tych manifestów gałęzi i są już częścią głównego procesu weryfikacji platformy. Jeśli więc nie widzisz tych projektów w swoim środowisku, wystarczy zsynchronizować repozytorium, aby móc je dodać.

  • główny
  • handel elektroniczny
  • oc-dev,
  • Oc-dev-plus-Aosp
  • Nyc-Mr2-dev-plus-Aosp
  • main-daydream-dev,
  • główny-bez-dostawcy
  • Wear-main

Programowanie i testowanie

Oczekuje się, że rozwój w repozytorium contrib będzie spełniał te same wymagania dotyczące jakości co w innych repozytoriach Androida:

  • Przestrzegaj wytycznych dotyczących formatowania Androida
  • Kod został przetestowany i przesłany w ramach testów
  • Projekt jest przemyślany i ma sens.

Jak mogę przetestować lokalnie w programie?

AOSP

W AOSP testy jednostkowe udziału w konwersji znajdują się tutaj: platform/tools/tradefederation/contrib/tests/src/ i testy jednostkowe należy dodać do com.android.tradefed.prodtests.UnitTests można znaleźć w skryptach testowania przed przesłaniem i w skryptach testów lokalnych.

Lokalne skrypty uruchamiane po uruchomieniu lunchu:

tools/tradefederation/core/tests/run_tradefed_aosp_presubmit.sh

Aktualizacja reguł kompilacji w celu przesyłania projektów

Reguły kompilacji (makefiles) znajdują się w osobnym folderze build/ i są zablokowane przez OWNERS, który uniemożliwi ich modyfikację bez dodatkowej weryfikacji od podstawowego zespołu. To jedyne ograniczenie dotyczące projektu contrib.

Jest to konieczne, aby upewnić się, że do parametru w ramach innych projektów bez wiedzy i zgody podstawowego zespołu. Jeśli naprawdę potrzebujesz dodania nowych zależności, skontaktuj się z android-tradefed@, aby przeanalizował Twoje przypadki użycia i doradził Ci w tej sprawie.