Budowanie Androida

Postępuj zgodnie z tymi instrukcjami, aby rozpocząć tworzenie Androida.

Konfigurowanie środowiska

Zainicjuj środowisko za pomocą skryptu envsetup.sh :

source build/envsetup.sh

Lub

. build/envsetup.sh

Zapoznaj się ze skryptem w witrynie platform/build/envsetup.sh, aby zapoznać się z opisami powiązanych poleceń, w tym lunch do wybierania docelowych urządzeń i tapas do tworzenia niepowiązanych aplikacji, takich jak referencyjna aplikacja telewizyjna .

Musisz ponownie wydać to polecenie po każdej repo sync , aby wykryć wszelkie zmiany w tym skrypcie. Zauważ, że zastąpienie source przez . (pojedyncza kropka) oszczędza kilka znaków, a krótka forma jest częściej używana w dokumentacji.

Skrypt envsetup.sh importuje kilka poleceń, które umożliwiają pracę z kodem źródłowym systemu Android, w tym polecenia użyte w tym ćwiczeniu.

Aby zobaczyć pełną listę dostępnych poleceń, uruchom:

hmm

Wybór celu

obiad

Wybierz cel do zbudowania podczas lunch . lunch product_name - build_variant wybiera product_name jako produkt do zbudowania i build_variant jako wariant do zbudowania i przechowuje te wybory w środowisku do odczytu przez kolejne wywołania m i inne podobne polecenia.

Dokładną konfigurację można przekazać jako argument. Na przykład następujące polecenie odnosi się do kompletnej kompilacji emulatora z włączonym całym debugowaniem:

lunch aosp_arm-eng

W przypadku uruchomienia bez argumentów lunch poprosi o wybranie celu z menu, ale pamiętaj, że menu nie zawiera wszystkich możliwości. Zobacz Wybieranie kompilacji urządzenia , aby zapoznać się z konfiguracjami kompilacji wszystkich urządzeń obsługiwanych w AOSP lub porozmawiaj z członkami swojego zespołu o odpowiednim lunchu dla urządzenia, nad którym pracujesz.

Wszystkie cele kompilacji mają postać BUILD-BUILDTYPE , gdzie BUILD to nazwa kodowa odnosząca się do konkretnej kombinacji funkcji. BUILDTYPE jest jednym z poniższych.

Kompilacja userdebug powinna zachowywać się tak samo jak kompilacja user , z możliwością włączenia dodatkowego debugowania, które normalnie narusza model bezpieczeństwa platformy. Dzięki temu kompilacja userdebug nadaje się do testowania przez użytkowników z większymi możliwościami diagnostycznymi. Tworząc przy użyciu kompilacji userdebug , postępuj zgodnie z wytycznymi userdebug .

Kompilacja eng nadaje priorytet produktywności inżynierskiej dla inżynierów pracujących na platformie. Kompilacja eng wyłącza różne optymalizacje stosowane w celu zapewnienia dobrego doświadczenia użytkownika. W przeciwnym razie kompilacja eng zachowuje się podobnie do kompilacji user i userdebug , dzięki czemu programiści urządzeń mogą zobaczyć, jak kod zachowuje się w tych środowiskach.

Aby zobaczyć bieżące ustawienia lunchu, uruchom polecenie:

echo "$TARGET_PRODUCT-$TARGET_BUILD_VARIANT"

Aby uzyskać więcej informacji na temat budowania i uruchamiania na rzeczywistym sprzęcie, zobacz Flashing Devices .

tapas

Polecenie tapas konfiguruje kompilację uwolnionych aplikacji. Wybiera poszczególne aplikacje do zbudowania przez system kompilacji Androida. W przeciwieństwie do lunch , tapas nie wymaga budowania obrazów dla urządzenia.

Uruchom tapas help , aby uzyskać więcej informacji na temat polecenia.

Budowanie kodu

Ta sekcja zawiera krótkie podsumowanie, aby upewnić się, że konfiguracja została zakończona.

Zbuduj wszystko z m . m może obsługiwać zadania równoległe z argumentem -jN . Jeśli nie podasz argumentu -j , system kompilacji automatycznie wybierze liczbę zadań równoległych, które uważa za optymalne dla twojego systemu.

m

Jak wyjaśniono powyżej, możesz zbudować określone moduły zamiast pełnego obrazu urządzenia, podając ich nazwy w wierszu poleceń m . Ponadto m udostępnia kilka pseudocelów do celów specjalnych. Niektóre przykłady to:

• droid - m droid to normalna wersja. Ten cel jest tutaj, ponieważ domyślny cel wymaga nazwy.
• all - m all buduje wszystko, co robi m droid , plus wszystko, co nie ma tagu droid . Serwer kompilacji uruchamia to, aby upewnić się, że wszystko, co znajduje się w drzewie i ma plik Android.mk zostanie zbudowane.
• m - Uruchamia kompilacje ze szczytu drzewa. Jest to przydatne, ponieważ możesz uruchomić make z podkatalogów. Jeśli masz ustawioną zmienną środowiskową TOP , używa tego. Jeśli tego nie zrobisz, wyszukuje drzewo z bieżącego katalogu, próbując znaleźć wierzchołek drzewa. Możesz albo zbudować całe drzewo kodu źródłowego, uruchamiając m bez argumentów, albo zbudować określone cele, określając ich nazwy.
• mma - Buduje wszystkie moduły w bieżącym katalogu i ich zależności.
• mmma - Buduje wszystkie moduły w dostarczonych katalogach i ich zależności.
• croot - cd na szczyt drzewa.
• clean - m clean usuwa wszystkie pliki wyjściowe i pośrednie dla tej konfiguracji. To jest to samo co rm -rf out/ .

Uruchom m help , aby zobaczyć, jakie inne pseudocele udostępnia m .

Uruchamianie kompilacji

Możesz uruchomić swoją kompilację na emulatorze lub flashować ją na urządzeniu. Ponieważ cel kompilacji został już wybrany za pomocą lunch , jest mało prawdopodobne, aby działał na innym celu niż ten, dla którego został zbudowany.

Flashowanie z fastbootem

Aby sflashować urządzenie, użyj fastboot , który powinien zostać uwzględniony w Twojej ścieżce po udanej kompilacji. Zobacz Flashowanie urządzenia , aby uzyskać instrukcje.

Emulowanie urządzenia z systemem Android

Emulator jest automatycznie dodawany do ścieżki w procesie kompilacji. Aby uruchomić emulator, wpisz:

emulator

Zrozumienie odcisków palców kompilacji

Aby śledzić i zgłaszać problemy związane z konkretną kompilacją Androida, ważne jest zrozumienie odcisku palca kompilacji. Odcisk cyfrowy kompilacji to unikalny, czytelny dla człowieka ciąg znaków zawierający informacje o producencie wydawane dla każdej kompilacji. Dokładną składnię można znaleźć w opisie FINGERPRINT w sekcji Parametry kompilacji dokumentu definicji zgodności z systemem Android (CDD).

Odcisk cyfrowy kompilacji reprezentuje konkretną implementację i wersję systemu Android. Ten unikalny klucz umożliwia twórcom aplikacji i innym osobom zgłaszanie problemów z określonymi wersjami oprogramowania układowego. Zobacz Zgłaszanie błędów , aby zapoznać się z procesem zgłaszania problemów z Androidem.

Odcisk cyfrowy kompilacji obejmuje wszystkie szczegóły implementacji Androida:

• Interfejsy API: Android i natywne, a także miękkie zachowania API
• Podstawowy interfejs API i niektóre zachowania interfejsu użytkownika systemu
• Wymagania dotyczące kompatybilności i bezpieczeństwa określone w CDD
• Specyfikacje produktów i ustawienia funkcji zastosowań stosowane przez aplikacje w celu kierowania na urządzenia spełniające oczekiwane wymagania
• Implementacje komponentów sprzętowych i programowych

Zobacz CDD , aby uzyskać szczegółowe informacje i Dodawanie nowego urządzenia , aby uzyskać instrukcje dotyczące tworzenia całkowicie nowego urządzenia z systemem Android.

Rozwiązywanie typowych błędów kompilacji

Niewłaściwa wersja Javy

Jeśli próbujesz zbudować wersję Androida, która jest niespójna z twoją wersją Javy, make , wyświetlając następujący komunikat:

************************************************************
You are attempting to build with the incorrect version
of java.

Your version is: WRONG_VERSION.
The correct version is: RIGHT_VERSION.

Please follow the machine setup instructions at
    https://source.android.com/source/initializing.html
************************************************************

Oto prawdopodobne przyczyny i rozwiązania:

• Niepowodzenie w instalacji poprawnego JDK zgodnie z wymaganiami JDK . Upewnij się, że wykonałeś kroki opisane w Konfigurowanie środowiska i Wybieranie celu .
• Na Twojej ścieżce pojawił się inny zainstalowany pakiet JDK. Dołącz poprawny pakiet JDK na początku ścieżki lub usuń problematyczny pakiet JDK.

Brak uprawnień USB

Domyślnie w większości systemów Linux nieuprzywilejowani użytkownicy nie mają dostępu do portów USB. Jeśli zobaczysz błąd odmowy uprawnień, postępuj zgodnie z instrukcjami w Konfigurowanie dostępu USB .

Jeśli ADB był już uruchomiony i nie może połączyć się z urządzeniem po skonfigurowaniu tych reguł, możesz go zabić za pomocą adb kill-server . To polecenie powoduje ponowne uruchomienie ADB z nową konfiguracją.