Pobierz źródło Androida

Źródło Androida znajduje się w kolekcji repozytoriów Git hostowanych przez Google. Repozytorium Git zawiera całą historię źródła Androida, w tym zmiany w źródle i datę wprowadzenia zmian. Na tej stronie opisano, jak pobrać źródło.

Zainicjuj klienta Repo

Skonfiguruj swojego klienta tak, aby miał dostęp do repozytorium źródłowego Androida:

  1. Utwórz i przejdź do katalogu roboczego:

    $ mkdir WORKING_DIRECTORY
    $ cd WORKING_DIRECTORY
    
  2. Zainicjuj katalog roboczy w celu kontroli źródła:

    $ repo init -b main -u https://android.googlesource.com/platform/manifest
    

    Opcja -b służy do identyfikacji inicjowanej gałęzi. Jeśli opcja -b nie została podana, repo init domyślnie wybiera gałąź główną. Aby zapoznać się z listą gałęzi i nazw znaczników, zobacz Tagi i kompilacje kodu źródłowego .

    Opcja -u jest wymagana i służy do określenia pliku manifestu , który jest plikiem XML określającym, gdzie w katalogu roboczym znajdują się różne projekty Git ze źródła Androida. W tym przykładzie nie określono nazwy pliku manifestu, więc polecenie używa domyślnego pliku manifestu ( default.xml ).

    Dane wyjściowe powinny zawierać komunikat:

    $ repo has been initialized in path_to_working_directory
    

Aby uzyskać informacje na temat formatu pliku manifestu, zobacz Format manifestu repo .

Aby zapoznać się z listą wszystkich poleceń Repo, zobacz Informacje o poleceniach Repo .

Pobierz źródło Androida

Uruchom następujące polecenie, aby pobrać drzewo źródłowe Androida do katalogu roboczego:

$ repo sync -c -j8

Argument -c instruuje repozytorę, aby pobrał bieżący manifest od serwera. Polecenie -j8 dzieli synchronizację w wątkach, aby uzyskać szybsze zakończenie.

Ta operacja powinna potrwać nieco ponad godzinę.

Jeśli napotkasz jakiekolwiek problemy podczas pobierania, patrz problemy z rozwiązywaniem problemów .

Rozwiązywanie problemów z siecią

W tej sekcji zawiera kilka sugestii dotyczących rozwiązania problemów sieciowych, które mogą powodować nieudane synksy.

Użyj uwierzytelniania, aby uniknąć barier przydziałowych

Aby chronić serwery przed nadmiernym użyciem, każdy adres IP, który służy do dostępu do źródła, jest powiązany z kwotą.

Podczas udostępniania adresu IP innym użytkownikom, na przykład podczas uzyskiwania dostępu do repozytoriów źródłowych spoza zapory NAT, kwoty mogą wywoływać normalne wzorce. Na przykład kwota może uruchomić, gdy kilku użytkowników synchronizuje nowych klientów z tego samego adresu IP, w krótkim okresie.

Aby uniknąć wyzwalania kwot, możesz użyć Authentited Access, który używa osobnego kwoty dla każdego użytkownika, niezależnie od adresu IP.

Aby włączyć uwierzytelniony dostęp:

  1. Utwórz hasło za pomocą generatora haseł .

  2. Uruchom następujące polecenie, aby przekonwertować klienta, aby użyć automatycznego uwierzytelniania (bez zmiany gałęzi):

    $ repo init -u https://android.googlesource.com/a/platform/manifest
    

    Należy pamiętać, że prefiks katalogu /a/ Directory powoduje automatyczne uwierzytelnianie.

Skonfiguruj do użycia proxy

Jeśli pobierasz źródło zza proxy, jak to jest powszechne w niektórych środowiskach korporacyjnych, upewnij się, że jawnie określisz proxy do użycia Repo, uruchamiając te polecenia:

$ export HTTP_PROXY=http://proxy_user_id:proxy_password@proxy_server:proxy_port
$ export HTTPS_PROXY=http://proxy_user_id:proxy_password@proxy_server:proxy_port

Dostosuj ustawienia TCP/IP, aby uniknąć problemów z łącznością

Chociaż jest to rzadkie, klienci Linux mogą doświadczać problemów związanych z łącznością, takich jak utknięcie w środku pobierania podczas odbierania obiektów. Aby poprawić ten problem, dostosuj ustawienia stosu TCP/IP lub użyj połączeń nierównoległych. Musisz mieć dostęp do modyfikacji ustawienia TCP. Aby zmodyfikować ustawienie, wydaj następujące polecenia:

$ sudo sysctl -w net.ipv4.tcp_window_scaling=0
$ repo sync -j1

Użyj lokalnego serwera lustrzanego, aby uniknąć opóźnień sieci

Korzystając z kilku klientów, możesz utworzyć lokalne lustro całej zawartości serwera i zsynchronizować klientów z tego lustra bez dostępu do sieci. Postępuj zgodnie z tymi instrukcjami, aby utworzyć lokalne lustro w ~/aosp-mirror/ i synchronizuj klientów z tym lustrem:

  1. Utwórz i zsynchronizuj lustro:

    $ mkdir -p /usr/local/aosp/mirror
    $ cd /usr/local/aosp/mirror
    $ repo init -u https://android.googlesource.com/mirror/manifest --mirror
    

    Polecenia te tworzą lokalne lustro /user/local/aosp/mirror i zainicjuj lustro za pomocą flagi --mirror za pomocą polecenia repo init .

  2. Aby zsynchronizować klientów z kopii lustrzanej:

    $ mkdir -p /usr/local/aosp/main
    $ cd /usr/local/aosp/main
    $ repo init -u /usr/local/aosp/mirror/platform/manifest.git
    $ repo sync
    
  3. Na koniec postępuj zgodnie z tymi poleceniami, aby zsynchronizować lustro przy serwerze i zsynchronizować klienta przeciwko lustrze:

    $ cd /usr/local/aosp/mirror</code>
    $ repo sync
    $ cd /usr/local/aosp/main
    $ repo sync
    

Możliwe jest przechowywanie kopii lustrzanej na serwerze LAN i uzyskiwanie do niej dostępu poprzez NFS, SSH lub Git. Możliwe jest również przechowywanie go na dysku wymiennym i przekazywanie go użytkownikom lub maszynom.

Użyj częściowego klonu

Jeśli używasz GIT w wersji 2.19 lub nowszej, podaj --partial-clone podczas wykonywania repo init , aby przezwyciężyć problemy sieciowe o niskiej opóźnieniu:

  $ repo init -u https://android.googlesource.com/platform/manifest -b main --partial-clone --clone-filter=blob:limit=10M

Zamiast inicjować repozytorę do pobrania wszystkiego, to polecenie pobiera obiekty git, ponieważ są one potrzebne.

Pobierz zastrzeżone pliki binarne

AOSP może działać bezpośrednio na emulatorach mątwy, ale AOSP nie może być używany na sprzęcie bez dodatkowych bibliotek własnych specyficznych dla urządzenia. Oto jak uzyskać pliki binarne tych urządzeń:

  • Jeśli pobierasz main gałąź i budowę urządzenia Nexusa lub Pixel, pobierz najnowsze binarie z witryny podglądu binarii .
  • Jeśli pobierasz i budujesz main gałąź i budowę dla własnego urządzenia, musisz podać binarie specyficzne dla urządzenia.
  • Jeśli pobierasz i budujesz oznaczone, nie-mainowe, gałęzi i budynek dla urządzenia Nexus lub piksel, pobierz binarne urządzenia z urządzeń binarnych dla urządzeń Nexus i Pixel .

Wyodrębnij zastrzeżone pliki binarne

Każdy zestaw plików binarnych ma postać samorozpakowującego się skryptu w skompresowanym archiwum. Wyodrębnia i umieszczenie tych binarów we właściwym miejscu drzewa źródłowego:

  1. Wyodrębnij archiwum.
  2. Uruchom dołączony skrypt powłoki z korzenia drzewa źródłowego AOSP.
  3. Zgadzam się na warunki zamkniętej umowy licencyjnej. Pliki binarne i odpowiadające im pliki makefile są instalowane w vendor/ hierarchii drzewa źródłowego.

(opcjonalnie) Sprawdź poprawność kodu

Jeśli masz wątpliwości co do legalności kodu źródłowego, np. tego, czy pochodzi on od Google, możesz zweryfikować tagi git dla oddziału. Aby zweryfikować tagi Git:

  1. Skopiuj i wklej następujący blok kluczy do pliku tekstowego, na przykład keyfile.asc .

    -----BEGIN PGP PUBLIC KEY BLOCK-----
    Version: GnuPG v1.4.2.2 (GNU/Linux)
    
    mQGiBEnnWD4RBACt9/h4v9xnnGDou13y3dvOx6/t43LPPIxeJ8eX9WB+8LLuROSV
    lFhpHawsVAcFlmi7f7jdSRF+OvtZL9ShPKdLfwBJMNkU66/TZmPewS4m782ndtw7
    8tR1cXb197Ob8kOfQB3A9yk2XZ4ei4ZC3i6wVdqHLRxABdncwu5hOF9KXwCgkxMD
    u4PVgChaAJzTYJ1EG+UYBIUEAJmfearb0qRAN7dEoff0FeXsEaUA6U90sEoVks0Z
    wNj96SA8BL+a1OoEUUfpMhiHyLuQSftxisJxTh+2QclzDviDyaTrkANjdYY7p2cq
    /HMdOY7LJlHaqtXmZxXjjtw5Uc2QG8UY8aziU3IE9nTjSwCXeJnuyvoizl9/I1S5
    jU5SA/9WwIps4SC84ielIXiGWEqq6i6/sk4I9q1YemZF2XVVKnmI1F4iCMtNKsR4
    MGSa1gA8s4iQbsKNWPgp7M3a51JCVCu6l/8zTpA+uUGapw4tWCp4o0dpIvDPBEa9
    b/aF/ygcR8mh5hgUfpF9IpXdknOsbKCvM9lSSfRciETykZc4wrRCVGhlIEFuZHJv
    aWQgT3BlbiBTb3VyY2UgUHJvamVjdCA8aW5pdGlhbC1jb250cmlidXRpb25AYW5k
    cm9pZC5jb20+iGAEExECACAFAknnWD4CGwMGCwkIBwMCBBUCCAMEFgIDAQIeAQIX
    gAAKCRDorT+BmrEOeNr+AJ42Xy6tEW7r3KzrJxnRX8mij9z8tgCdFfQYiHpYngkI
    2t09Ed+9Bm4gmEO5Ag0ESedYRBAIAKVW1JcMBWvV/0Bo9WiByJ9WJ5swMN36/vAl
    QN4mWRhfzDOk/Rosdb0csAO/l8Kz0gKQPOfObtyYjvI8JMC3rmi+LIvSUT9806Up
    hisyEmmHv6U8gUb/xHLIanXGxwhYzjgeuAXVCsv+EvoPIHbY4L/KvP5x+oCJIDbk
    C2b1TvVk9PryzmE4BPIQL/NtgR1oLWm/uWR9zRUFtBnE411aMAN3qnAHBBMZzKMX
    LWBGWE0znfRrnczI5p49i2YZJAjyX1P2WzmScK49CV82dzLo71MnrF6fj+Udtb5+
    OgTg7Cow+8PRaTkJEW5Y2JIZpnRUq0CYxAmHYX79EMKHDSThf/8AAwUIAJPWsB/M
    pK+KMs/s3r6nJrnYLTfdZhtmQXimpoDMJg1zxmL8UfNUKiQZ6esoAWtDgpqt7Y7s
    KZ8laHRARonte394hidZzM5nb6hQvpPjt2OlPRsyqVxw4c/KsjADtAuKW9/d8phb
    N8bTyOJo856qg4oOEzKG9eeF7oaZTYBy33BTL0408sEBxiMior6b8LrZrAhkqDjA
    vUXRwm/fFKgpsOysxC6xi553CxBUCH2omNV6Ka1LNMwzSp9ILz8jEGqmUtkBszwo
    G1S8fXgE0Lq3cdDM/GJ4QXP/p6LiwNF99faDMTV3+2SAOGvytOX6KjKVzKOSsfJQ
    hN0DlsIw8hqJc0WISQQYEQIACQUCSedYRAIbDAAKCRDorT+BmrEOeCUOAJ9qmR0l
    EXzeoxcdoafxqf6gZlJZlACgkWF7wi2YLW3Oa+jv2QSTlrx4KLM=
    =Wi5D
    -----END PGP PUBLIC KEY BLOCK-----
    
  2. Uruchom następujące polecenie, aby wprowadzić klucz publiczny do bazy danych kluczy GnuPG. Klucz służy do podpisywania tagów z adnotacjami, które reprezentują wydania.

    $ gpg --import keyfile.asc
    
  3. Po zaimportowaniu kluczy możesz zweryfikować dowolny tag, uruchamiając tę ​​komendę:

    $ git tag -v TAG_NAME