Narzędzia kontroli źródła

Praca z kodem Androida wymaga użycia zarówno Git (system kontroli wersji typu open source), jak i Repo (opracowane przez Google narzędzie do zarządzania repozytoriami, które działa na Git). Zobacz stronę Przepływ pracy kontroli źródła , aby zapoznać się z podsumowaniem regularnych działań, które możesz podjąć, takich jak przesyłanie zmian do sprawdzenia.

Git

Git obsługuje duże projekty, które są rozproszone w wielu repozytoriach. Android używa Git do lokalnych operacji, takich jak lokalne rozgałęzienia, zatwierdzenia, różnice i edycje. Jednym z wyzwań podczas tworzenia projektu Androida było określenie, jak najlepiej wspierać społeczność zewnętrzną — od społeczności hobbystów po dużych producentów OEM budujących masowe urządzenia konsumenckie. Google chciał, aby komponenty były wymienne i chciał, aby interesujące komponenty żyły własnym życiem poza Androidem. Google najpierw wybrał rozproszony system kontroli wersji, a następnie zawęził go do Git.

Aby uzyskać więcej informacji na temat Git, zapoznaj się z tą dokumentacją Git .

Repo

Repo ujednolica repozytoria Git, gdy jest to konieczne, wykonuje przesyłanie do systemu kontroli wersji Gerrit i automatyzuje części przepływu pracy programistycznej Androida.

Repo Launcher zapewnia skrypt Pythona, który inicjuje kasę i pobiera drugą część, pełne narzędzie Repo. Pełne narzędzie Repo jest zawarte w kasie kodu źródłowego Androida. Domyślnie znajduje się w $SRCDIR/.repo/repo/... i odbiera polecenia przekazywane z pobranego programu Repo Launcher.

Repo nie zastępuje Git, a jedynie ułatwia pracę z Git w kontekście Androida. Repo używa plików manifestu do agregowania projektów Git w superprojekt Androida. Możesz umieścić polecenie repo , które jest wykonywalnym skryptem Pythona, w dowolnym miejscu na ścieżce. Pracując z plikami źródłowymi Androida, możesz używać Repo do operacji w sieci, takich jak pojedynczy katalog roboczy Repo.

W większości sytuacji możesz używać Git zamiast Repo lub mieszać polecenia Repo i Git, aby tworzyć złożone polecenia. Jednak używanie Repo do podstawowych operacji w sieci znacznie upraszcza pracę. Aby uzyskać więcej informacji na temat Repo, zobacz Repo Command Reference , Repo README , Preupload Hooks (testy), które można włączyć w Repo, oraz ogólne dokumenty w AOSP .

Aby pobrać i zainstalować Repo Launcher z git-repo-downloads , zobacz Installing Repo .

Gerrit

Gerrit to internetowy system przeglądu kodu dla projektów korzystających z Git. Gerrit zachęca do bardziej scentralizowanego korzystania z Git, umożliwiając wszystkim autoryzowanym użytkownikom przesyłanie zmian, które są automatycznie scalane, jeśli przejdą weryfikację kodu. Ponadto Gerrit ułatwia przeglądanie, wyświetlając zmiany obok siebie w przeglądarce i umożliwiając umieszczanie komentarzy.

Znajdź interfejs recenzji systemu Android Gerrit na stronie android-review.googlesource.com oraz interfejs nawigacji po kodzie na stronie android.googlesource.com .

Wyszukiwanie kodu Androida

Android Code Search umożliwia wyszukiwanie AOSP bez pobierania czegokolwiek. Możesz użyć Code Search, aby wyświetlić kod źródłowy AOSP, przełączać się między gałęziami open source i nawigować po odsyłaczach. Więcej informacji można znaleźć w witrynie Google Developers, gdzie znajduje się dokumentacja wyszukiwania kodu .

Inne narzędzia

Android Studio to oficjalne zintegrowane środowisko programistyczne (IDE) do tworzenia aplikacji na Androida.

Android Debug Bridge (ADB) umożliwia podłączenie stacji roboczej programisty bezpośrednio do urządzenia z systemem Android, dzięki czemu można instalować pakiety i oceniać zmiany.

W przypadku systemu Android 10 i nowszych użyj IntelliJ z AIDEgen IDE do tworzenia platform Android.

Instalowanie repozytorium

Wykonaj następujące kroki, aby zainstalować Repo.

1. Uruchom następujące polecenia, aby użyć oficjalnego pakietu ze swojej dystrybucji Linuksa:

     sudo apt-get update
     sudo apt-get install repo
   

   Jeśli te polecenia nie zadziałały w Twoim systemie — na przykład widzisz, że wersja pakietu jest nieaktualna lub nie ma oficjalnego pakietu dostępnego w Twoim systemie Dystrybucja systemu Linux, ręcznie zainstaluj Repo za pomocą następujących poleceń:

   export REPO=$(mktemp /tmp/repo.XXXXXXXXX)
   curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo
   gpg --recv-key 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
   curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo
   

Te polecenia konfigurują plik tymczasowy, pobierają do niego repozytorium i sprawdzają, czy dostarczony klucz jest zgodny z wymaganym kluczem. Jeśli te zakończą się pomyślnie, instalacja będzie kontynuowana.

Uwaga: Klucze są zarejestrowane na stronie keys.openpgp.org i domyślnie działają w dystrybucjach opartych na Debianie. Jeśli nie możesz pobrać klucza lub weryfikacja się nie powiedzie, zapoznaj się z dokumentacją swojej dystrybucji dotyczącą korzystania z Gnu Privacy Guard (GPG). Dodatkowe zasoby można znaleźć na stronie internetowej GnuPG .

Po instalacji sprawdź, czy repo version zgłasza coś podobnego do następującego, gdy jest uruchomiona w zwykłym katalogu. (Zwykły katalog nie jest częścią klienta repozytorium; na przykład jest to katalog domowy).

2. Uruchom to polecenie:

repo version

3. Spodziewaj się raportu podobnego do tego:

<repo not installed>
repo launcher version 2.15
(from /usr/bin/repo)

• Numer repo launcher version zgłaszany jako 2.15 lub nowszy wskazuje na prawidłowy numer wersji i prawidłową instalację.
• (from /usr/bin/repo) wskazuje instalację z pakietu.
• (from /home/<>/bin/repo) oznacza instalację ręczną.

Zakończenie instalacji

Dalej: Aby ukończyć pełną instalację narzędzia Repo, zobacz Inicjowanie klienta Repo na stronie Pobieranie źródła .