Narzędzia kontroli źródła

Praca z kodem Androida wymaga użycia zarówno Git (systemu kontroli wersji typu open source), jak i Repo (narzędzia do zarządzania repozytorium stworzonego przez Google, które działa na platformie 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 przeglądu.

Git

Git obsługuje duże projekty rozproszone w wielu repozytoriach. Android używa Gita do operacji lokalnych, takich jak lokalne rozgałęzianie, zatwierdzanie, porównywanie i edycje. Jednym z wyzwań związanych z konfiguracją projektu Androida było określenie, w jaki sposób najlepiej wspierać społeczność zewnętrzną — od społeczności hobbystów po dużych producentów OEM tworzących urządzenia konsumenckie na rynek masowy. Google chciał, aby komponenty były wymienne i chciał, aby ciekawe komponenty żyły własnym życiem, poza Androidem. Google najpierw wybrał rozproszony system kontroli wersji, a następnie zawęził go do Git.

Więcej szczegółów na temat Gita znajdziesz w tej dokumentacji Gita .

Repo

Repo w razie potrzeby ujednolica repozytoria Git, przesyła dane do systemu kontroli wersji Gerrit i automatyzuje część przepływu pracy związanej z tworzeniem systemu Android.

Program uruchamiający Repo udostępnia skrypt w języku Python, który inicjuje realizację transakcji i pobiera drugą część, pełne narzędzie Repo. Pełne narzędzie Repo jest dostępne w ramach sprawdzania kodu źródłowego Androida. Domyślnie znajduje się w $SRCDIR/.repo/repo/... i odbiera przekazywane polecenia z pobranego Repo Launchera.

Repo nie zastępuje Gita, jedynie ułatwia pracę z Gitem 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 swojej ścieżce. Pracując z plikami źródłowymi Androida, możesz używać Repo do operacji w sieci, na przykład w pojedynczym katalogu roboczym 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 Dokumentacja poleceń Repo , README Repo , Haki do wstępnego przesyłania (testy), które można włączyć w Repo, oraz ogólną dokumentację w AOSP .

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

Gerrita

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

Znajdź interfejs recenzji Androida Gerrit na android-review.googlesource.com i interfejs nawigacji po kodzie na android.googlesource.com .

Wyszukiwanie kodu Androida

Wyszukiwanie kodu Androida umożliwia przeszukiwanie AOSP bez konieczności pobierania czegokolwiek. Możesz użyć Wyszukiwania kodu, aby wyświetlić kod źródłowy AOSP, przełączać się między gałęziami open source i nawigować po odniesieniach. Więcej informacji znajdziesz w witrynie Google Developers, gdzie znajdziesz dokumentację 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 programistycznej stacji roboczej bezpośrednio do urządzenia z systemem Android, dzięki czemu można instalować pakiety i oceniać wprowadzone zmiany.

Do programowania AOSP użyj Android Studio for Platform (ASfP) .

Instalowanie repozytorium

Wykonaj poniższe kroki, aby zainstalować Repo.

1. Uruchom następujące polecenia, aby użyć oficjalnego pakietu z Twojej 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 jest dostępny oficjalny pakiet w Twojej W dystrybucji 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-keys 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 pasuje do wymaganego klucza. Jeśli te działania się powiodą, 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 repo; jest to na przykład Twój 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 poprawny numer wersji i prawidłową instalację.
• (from /usr/bin/repo) oznacza instalację z pakietu.
• (from /home/<>/bin/repo) oznacza instalację ręczną.

Zakończenie instalacji

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

Praca z kodem Androida wymaga użycia zarówno Git (systemu kontroli wersji typu open source), jak i Repo (narzędzia do zarządzania repozytorium stworzonego przez Google, które działa na platformie 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 przeglądu.

Git

Git obsługuje duże projekty rozproszone w wielu repozytoriach. Android używa Gita do operacji lokalnych, takich jak lokalne rozgałęzianie, zatwierdzanie, porównywanie i edycje. Jednym z wyzwań związanych z konfiguracją projektu Androida było określenie, w jaki sposób najlepiej wspierać społeczność zewnętrzną — od społeczności hobbystów po dużych producentów OEM tworzących urządzenia konsumenckie na rynek masowy. Google chciał, aby komponenty były wymienne i chciał, aby ciekawe komponenty żyły własnym życiem, poza Androidem. Google najpierw wybrał rozproszony system kontroli wersji, a następnie zawęził go do Git.

Więcej szczegółów na temat Gita znajdziesz w tej dokumentacji Gita .

Repo

Repo w razie potrzeby ujednolica repozytoria Git, przesyła dane do systemu kontroli wersji Gerrit i automatyzuje część przepływu pracy związanej z tworzeniem systemu Android.

Program uruchamiający Repo udostępnia skrypt w języku Python, który inicjuje realizację transakcji i pobiera drugą część, pełne narzędzie Repo. Pełne narzędzie Repo jest dostępne w ramach sprawdzania kodu źródłowego Androida. Domyślnie znajduje się w $SRCDIR/.repo/repo/... i odbiera przekazywane polecenia z pobranego Repo Launchera.

Repo nie zastępuje Gita, jedynie ułatwia pracę z Gitem 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 swojej ścieżce. Pracując z plikami źródłowymi Androida, możesz używać Repo do operacji w sieci, na przykład w pojedynczym katalogu roboczym 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 Dokumentacja poleceń Repo , README Repo , Haki do wstępnego przesyłania (testy), które można włączyć w Repo, oraz ogólną dokumentację w AOSP .

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

Gerrita

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

Znajdź interfejs recenzji Androida Gerrit na android-review.googlesource.com i interfejs nawigacji po kodzie na android.googlesource.com .

Wyszukiwanie kodu Androida

Wyszukiwanie kodu Androida umożliwia przeszukiwanie AOSP bez konieczności pobierania czegokolwiek. Możesz użyć Wyszukiwania kodu, aby wyświetlić kod źródłowy AOSP, przełączać się między gałęziami open source i nawigować po odniesieniach. Więcej informacji znajdziesz w witrynie Google Developers, gdzie znajdziesz dokumentację 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 programistycznej stacji roboczej bezpośrednio do urządzenia z systemem Android, dzięki czemu można instalować pakiety i oceniać wprowadzone zmiany.

Do programowania AOSP użyj Android Studio for Platform (ASfP) .

Instalowanie repozytorium

Wykonaj poniższe kroki, aby zainstalować Repo.

1. Uruchom następujące polecenia, aby użyć oficjalnego pakietu z Twojej 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 jest dostępny oficjalny pakiet w Twojej W dystrybucji 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-keys 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 pasuje do wymaganego klucza. Jeśli te działania się powiodą, 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 repo; jest to na przykład Twój 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 poprawny numer wersji i prawidłową instalację.
• (from /usr/bin/repo) oznacza instalację z pakietu.
• (from /home/<>/bin/repo) oznacza instalację ręczną.

Zakończenie instalacji

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