Narzędzia kontroli źródła

Praca z kodem Androida wymaga użycia zarówno Git (system kontroli wersji o otwartym kodzie źródłowym), jak i Repo (narzędzie do zarządzania repozytorium stworzone przez Google, które działa na Git). Zobacz stronę Przepływ pracy kontroli źródła , aby zapoznać się z podsumowaniem zwykłych czynności, które możesz wykonać, takich jak przesyłanie zmian do sprawdzenia.

Gita

Git obsługuje duże projekty, które są rozmieszczone w wielu repozytoriach. System Android używa usługi Git do operacji lokalnych, takich jak rozgałęzienia lokalne, zatwierdzenia, różnice i edycje. Jednym z wyzwań związanych z konfiguracją projektu Android 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 urządzenia konsumenckie na rynek masowy. 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 udostępnia 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 systemu Android. Domyślnie znajduje się w $SRCDIR/.repo/repo/... i odbiera przekazane polecenia z pobranego Repo Launchera.

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

W większości sytuacji możesz użyć Git zamiast Repo lub połączyć polecenia Repo i Git, aby utworzyć złożone polecenia. Jednak używanie Repo do podstawowych operacji w sieci znacznie ułatwia 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 Instalowanie 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ą przegląd kodu. Ponadto Gerrit ułatwia przeglądanie, wyświetlając zmiany obok siebie w przeglądarce i umożliwiając komentarze w tekście.

Interfejs recenzji systemu Android Gerrit można znaleźć na stronie android-review.googlesource.com oraz interfejs nawigacji po kodzie na stronie android.googlesource.com .

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 odnośnikach. Więcej informacji znajdziesz w witrynie Google Developers, gdzie znajduje się dokumentacja Code Search .

Inne narzędzia

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

Android Debug Bridge (ADB) umożliwia łączenie programistycznej stacji roboczej bezpośrednio z urządzeniem 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 rozwoju platformy Android.

Instalowanie repozytorium

Wykonaj poniższe czynności, aby zainstalować Repo.

  1. Uruchom te polecenia, aby użyć oficjalnego pakietu z Twojej dystrybucji Linuksa:
      sudo apt-get update
      sudo apt-get install repo
    
    Jeśli te polecenia nie dział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 Linuksa, 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
    
  2. Te polecenia konfigurują plik tymczasowy, pobierają do niego repozytorium i sprawdzają, czy dostarczony klucz pasuje do wymaganego klucza. Jeśli to się powiedzie, instalacja będzie kontynuowana.

    Po instalacji sprawdź, czy repo version zgłasza coś podobnego do poniższego, gdy działa w zwykłym katalogu. (Zwykły katalog nie jest częścią klienta repozytorium; na przykład jest to twój katalog domowy).

  3. Uruchom to polecenie:
  4. repo version
  5. Spodziewaj się raportu podobnego do tego:
  6. <repo not installed>
    repo launcher version 2.15
    (from /usr/bin/repo)
    
    • Numer repo launcher version zgłaszany jako 2.15 lub nowszy wskazuje poprawny numer wersji i prawidłową instalację.
    • (from /usr/bin/repo) wskazuje instalację z pakietu.
    • (from /home/<>/bin/repo) wskazuje na instalację ręczną.

Zakończenie instalacji

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