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.
- Uruchom następujące polecenia, aby użyć oficjalnego pakietu z Twojej dystrybucji Linuksa:
sudo apt-get update
sudo apt-get install repo
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
- Uruchom to polecenie:
- Spodziewaj się raportu podobnego do tego:
- 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ą.
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.)
repo version
<repo not installed>
repo launcher version 2.15
(from /usr/bin/repo)
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.
- Uruchom następujące polecenia, aby użyć oficjalnego pakietu z Twojej dystrybucji Linuksa:
sudo apt-get update
sudo apt-get install repo
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
- Uruchom to polecenie:
- Spodziewaj się raportu podobnego do tego:
- 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ą.
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.)
repo version
<repo not installed>
repo launcher version 2.15
(from /usr/bin/repo)
Zakończenie instalacji
Dalej: Aby dokończyć pełną instalację narzędzia Repo, zobacz Inicjowanie klienta Repo na stronie Pobieranie źródła .