Kryptonimy, tagi i numery kompilacji

Wersje rozwojowe Androida są podzielone na rodziny, z alfabetycznymi nazwami kodowymi, które są inspirowane smakołykami. Ta strona zawiera informacje o nazwach kodowych platformy, wersjach, poziomach API i wydaniach NDK wraz z wyjaśnieniem powiązanych z nimi definicji identyfikatorów kompilacji .

Pamiętaj, że możesz potrzebować dodatkowych informacji o nazwie kodowej-wersji, w zależności od przypadku użycia. Na przykład możesz potrzebować nazwy kodowej urządzenia z Androidem i kombinacji klawiszy do uruchomienia w trybie flashboot lub źródeł jądra i plików binarnych do ręcznego zbudowania jądra. Są one podsumowane w sekcji Odwołania do nazw kodowych i zasoby dotyczące przypadków użycia , wraz z łączami umożliwiającymi zlokalizowanie informacji potrzebnych do tych tematów:

• Uruchamianie w trybie Flashboot wymaga kombinacji klawiszy dla urządzeń z odpowiadającymi im nazwami kodowymi urządzeń z systemem Android.
• Jądra, które muszą być budowane ręcznie, wymagają nazw kodowych i odpowiednich lokalizacji w celu uzyskania źródeł jądra i plików binarnych.
• Kompilacje, które pozyskują wiele repozytoriów Git, wymagają parowania nazw kodowych urządzeń w celu uzyskania prawidłowej konfiguracji katalogu źródłowego w celu pobrania źródeł i narzędzi do tworzenia.

Nazwy kodowe platform, wersje, poziomy API i wydania NDK

Ta tabela zawiera nazwy kodowe, odpowiadające im numery wersji i powiązane poziomy API.

Definicje identyfikatorów kompilacji

W systemie Android 8.0.0 (Oreo) i nowszych poszczególne kompilacje są identyfikowane za pomocą formatu identyfikatora kompilacji PVBB.YYMMDD.bbb[.Cn] , gdzie:

• P oznacza pierwszą literę kryptonimu wydania platformy, na przykład O to Oreo.
• V reprezentuje obsługiwaną branżę. Zgodnie z konwencją P reprezentuje podstawową gałąź platformy.
• BB to kod alfanumeryczny, który pozwala Google zidentyfikować dokładną gałąź kodu, z której utworzono kompilację.
• RRMMDD identyfikuje datę rozgałęzienia lub synchronizacji wydania z gałęzią programistyczną. Nie zawsze jest to dokładna data utworzenia kompilacji, ponieważ drobne zmiany dodawane do istniejącej kompilacji często wykorzystują ten sam kod daty, co istniejąca kompilacja.
• bbb identyfikuje poszczególne wersje związane z tym samym kodem daty, zaczynając kolejno od 001 .
• Cn to opcjonalny znak alfanumeryczny, który identyfikuje poprawkę na górze istniejącej kompilacji PVBB.YYMMDD.bbb, zaczynając od A1 .

Starsze wersje Androida używają innego, krótszego kodu identyfikacyjnego kompilacji (na przykład FRF85B ), gdzie:

• Pierwsza litera to kryptonim rodziny wydań, na przykład F to Froyo.
• Druga litera to kod gałęzi, który pozwala Google zidentyfikować dokładną gałąź kodu, z której została utworzona kompilacja. Zgodnie z konwencją R jest podstawową gałęzią wydania.
• Trzecia litera i kolejne dwie cyfry to kod daty. Litera liczy kwartały ( A to I kwartał 2009 r., F to II kwartał 2010 r. itd.). Te dwie liczby liczą dni w kwartale ( F85 to 24 czerwca 2010). Kod daty nie zawsze jest dokładną datą utworzenia kompilacji, ponieważ drobne zmiany dodawane do istniejącej kompilacji często wykorzystują ten sam kod daty, co istniejąca kompilacja.
• Ostatnia litera identyfikuje poszczególne wersje związane z tym samym kodem daty, kolejno zaczynając od A (co jest dorozumiane i zwykle pomijane dla zwięzłości).

Tagi i kompilacje kodu źródłowego

Począwszy od Donut, dokładna lista tagów i kompilacji znajduje się w poniższej tabeli. Identyfikator kompilacji zawiera informacje, takie jak wydanie platformy, gałąź kodu i data, z której wydanie zostało rozgałęzione lub zsynchronizowane z gałęzią programistyczną.

The branches froyo, gingerbread, ics-mr0, ics-mr1, jb-dev, jb-mr1-dev, jb-mr1.1-dev, jb-mr2-dev, and kitkat-dev represent development branches that don't exactly match configurations tested by Google. As such, these branches might contain a variety of changes in addition to the official tagged releases and might not be as thoroughly tested.

To differentiate between releases, you can get a list of changes associated with each project by issuing the following command and passing it the two branch tags:

repo forall -pc 'git log --no-merges --oneline branch-1..branch-2'

For example:

repo forall -pc 'git log --no-merges --oneline android-4.4.2_r2..android-4.4.2_r1'

To send the output to a text file:

  repo forall -pc 'git log --no-merges --oneline android-4.4.2_r2..android-4.4.2_r1' > /tmp/android-4.4.2_r2-android-4.4.2_r1-diff.txt

Honeycomb GPL modules

For Honeycomb, the entire platform source code isn't available. However, the parts of Honeycomb licensed under the GPL and LGPL are available under the following tags.

No manifest contains exactly these modules, but some manifests allow building those components. The following commands work for 3.0_r1.1:

repo init -b master -m base-for-3.0-gpl.xml
repo sync
repo forall -c git checkout android-3.0_r1.1

To use another version, change the git checkout parameter and (if necessary) the -m parameter in repo init . The git checkout command outputs an error for any non-GPL projects where it can't find the tag.

Codename references and resources for use cases

Resources for the type of codenames information that's needed to support specific setup use cases are listed below:

• If you're booting into Fastboot mode (from a device that's undergoing a cold boot), you need the key combinations that correspond to the Android device you're using. For a listing of devices with their corresponding Android Device codenames (for example, Nexus 5x is codenamed Bullhead and uses a specific key combination), see Booting into fast boot mode to obtain the key combinations you need.
• If your build requires sources from multiple Git repositories, use the repo approach to download sources and build tools; this ensures a correct source directory setup. To get BRANCH names for the kernels you require, see Downloading sources and build tools for a list of device-code name pairings (such as Pixel 5 - redfin), cross-referenced to their binary paths in the AOSP tree and corresponding repo branches.