Google is committed to advancing racial equity for Black communities. See how.
Ta strona została przetłumaczona przez Cloud Translation API.
Switch to English

Narzędzia kontroli źródła

Praca z kodem Androida wymaga użycia Git (systemu kontroli wersji typu open source) i Repo (stworzonego przez Google narzędzia do zarządzania repozytoriami, które działa na Git). Zobacz Przepływ pracy kontroli źródła, aby zapoznać się z podsumowaniem zwykłych działań, takich jak przesyłanie zmian do przeglądu.

Git

Git jest przeznaczony do obsługi dużych projektów, które są rozproszone w wielu repozytoriach. Android używa Git do operacji lokalnych, takich jak lokalne rozgałęzienia, zatwierdzenia, różnice i edycje. Jednym z wyzwań podczas konfigurowania projektu Android było ustalenie, jak najlepiej wspierać zewnętrzną społeczność - od społeczności hobbystów po dużych producentów OEM budujących urządzenia konsumenckie na rynek masowy. Chcieliśmy, aby komponenty były wymienne i chcieliśmy, aby interesujące komponenty żyły własnym życiem poza Androidem. Najpierw wybraliśmy rozproszony system kontroli wersji, a następnie zawęziliśmy go do Gita.

Więcej informacji na temat Git można znaleźć w dokumentacji Git .

Repozytorium

Repo ujednolica repozytoria Git, gdy jest to konieczne, przesyła dane do systemu kontroli wersji Gerrit i automatyzuje części przepływu pracy związanej z programowaniem na Androida.

Repozytorium składa się z dwóch części: programu uruchamiającego repozytorium, który można pobrać i zainstalować z git-repo-downloads . Jest to skrypt w Pythonie, który wie, jak zainicjować kasę i może pobrać drugą część, pełne narzędzie Repo , zawarte w kodzie źródłowym Androida. Pełne narzędzie Repo znajduje się domyślnie w $SRCDIR/.repo/repo/... i odbiera przekazywane polecenia z pobranego programu Repo Launcher.

Repo nie ma na celu zastąpienia Gita, a jedynie ułatwienie pracy z Gitem w kontekście Androida. Używa plików manifestu do agregowania projektów Git w superprojekt Androida. Polecenie repo to wykonywalny skrypt w języku Python, który można umieścić w dowolnym miejscu na ścieżce. Pracując z plikami źródłowymi systemu Android, używasz Repo do operacji w sieci, na przykład z pojedynczym katalogiem 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 repozytorium, zobacz dokumentację dotyczącą poleceń dotyczących repozytorium , plik README dotyczący repozytorium, haki do przesyłania wstępnego (testy), które można włączyć w repozytorium , oraz ogólne dokumenty w AOSP .

Inne narzędzia

Gerrit to internetowy system przeglądania 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 łączone, jeśli przejdą przegląd kodu. Ponadto Gerrit ułatwia przeglądanie, wyświetlając zmiany obok siebie w przeglądarce i włączając komentarze w tekście.

Wyszukiwanie kodu systemu Android 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 w celu uzyskania dokumentacji Code Search .

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

Instalowanie repozytorium

Repo to narzędzie ułatwiające pracę z Gitem w kontekście Androida. Zobacz omówienie repozytorium powyżej, aby poznać jego cel i łącza do powiązanych dokumentów.

Repozytorium składa się z dwóch części: jedna to instalowany skrypt uruchamiający i komunikuje się z drugą częścią, pełnym narzędziem Repo zawartym w kasie kodu źródłowego. Aby zainstalować Repo:

  1. Upewnij się, że masz katalog bin/ w swoim katalogu domowym i że jest on uwzględniony w ścieżce:

    mkdir ~/bin
    PATH=~/bin:$PATH
    
  2. Pobierz program Repo Launcher i upewnij się, że jest wykonywalny:

    curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
    chmod a+x ~/bin/repo
    
  3. Opcjonalnie sprawdź, czy program uruchamiający pasuje do naszych podpisów:

    gpg --recv-key 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
    curl https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ~/bin/repo
    

Starsze repozytorium dla starszych systemów Python 2

Jeśli używasz starszego systemu bez Python 3.6+, spróbuj pobrać starszą wersję Repo Launchera, która nadal obsługuje Python 2.7. Nie będzie to działać w nieskończoność, ale może pomóc, dopóki system nie zostanie zaktualizowany.

curl https://storage.googleapis.com/git-repo-downloads/repo-1 > ~/bin/repo
chmod a+x ~/bin/repo