Noms de code, balises et numéros de build

Les versions de développement Android sont organisées en familles, avec des noms de code alphabétiques inspirés de délicieuses friandises. Cette page fournit des informations sur les noms de code, les versions, les niveaux d'API et les versions du NDK de la plateforme , avec une explication des définitions d'ID de build qui leur sont associées.

Notez que vous pourriez avoir besoin de détails supplémentaires sur la version du nom de code, en fonction de votre cas d'utilisation. Par exemple, vous pourriez avoir besoin d'un nom de code de périphérique Android et de combinaisons de touches pour démarrer en mode flashboot, ou de sources et binaires du noyau pour créer un noyau manuellement. Celles-ci sont résumées dans la section Références de nom de code et ressources pour les cas d'utilisation , avec des liens vous permettant de localiser les informations dont vous avez besoin pour ces sujets :

• Le démarrage en mode flashboot nécessite des combinaisons de touches pour les appareils avec leurs noms de code d'appareil Android correspondants.
• Les noyaux qui doivent être construits manuellement nécessitent des noms de code et des emplacements correspondants pour obtenir les sources et les binaires du noyau.
• Les builds qui sourcent plusieurs référentiels Git nécessitent des paires de noms de code de périphérique pour obtenir une configuration correcte du répertoire source afin de télécharger les sources et de créer des outils.

Noms de code de plate-forme, versions, niveaux d'API et versions NDK

Ce tableau répertorie les noms de code, leurs numéros de version correspondants et les niveaux d'API associés.

Définitions d'ID de build

Dans Android 8.0.0 (Oreo) et versions ultérieures, les builds individuels sont identifiés avec le format d'ID de build PVBB.YYMMDD.bbb[.Cn] , où :

• P représente la première lettre du nom de code de la version de la plateforme, par exemple, O est Oreo.
• V représente une verticale prise en charge. Par convention, P représente la branche principale de la plateforme.
• BB est un code alphanumérique qui permet à Google d'identifier la branche de code exacte à partir de laquelle la construction a été réalisée.
• AAMMJJ identifie la date à laquelle la version est dérivée ou synchronisée avec la branche de développement. Il ne s'agit pas toujours de la date exacte à laquelle une build a été réalisée, car il est courant que des variations mineures ajoutées à une build existante réutilisent le même code de date que la build existante.
• bbb identifie les versions individuelles liées au même code de date, en commençant séquentiellement par 001 .
• Cn est un caractère alphanumérique facultatif qui identifie un correctif au-dessus d'une build PVBB.YYMMDD.bbb existante, à partir de A1 .

Les anciennes versions d'Android utilisent un code d'identification de build différent et plus court (par exemple, FRF85B ) où :

• La première lettre est le nom de code de la famille de versions, par exemple, F est Froyo.
• La deuxième lettre est un code de branche qui permet à Google d'identifier la branche de code exacte à partir de laquelle la construction a été réalisée. Par convention, R est la branche principale de la version.
• La troisième lettre et les deux chiffres suivants sont un code de date. La lettre compte les trimestres ( A correspond au premier trimestre 2009, F correspond au deuxième trimestre 2010, et ainsi de suite). Les deux nombres comptent les jours du trimestre ( F85 correspond au 24 juin 2010). Le code de date n'est pas toujours la date exacte à laquelle une build a été créée, car il est courant que des variations mineures ajoutées à une build existante réutilisent le même code de date que la build existante.
• La dernière lettre identifie les versions individuelles liées au même code de date, commençant séquentiellement par A (qui est implicite et généralement omis par souci de concision).

Balises et builds de code source

À partir de Donut, la liste exacte des balises et des builds se trouve dans le tableau suivant. L' ID de build fournit des informations telles que la version de la plateforme, la branche de code et la date à laquelle la version a été dérivée ou synchronisée avec la branche de développement.

Les branches Froyo, Gingerbread, ICS-MR0, ICS-MR1, JB-DEV, JB-MR1-DEV, JB-MR1.1-DEV, JB-MR2-DEV et Kitkat-Dev représentent les branches de développement qui ne le font pas exactement Faites correspondre les configurations testées par Google. En tant que tels, ces branches peuvent contenir une variété de changements en plus des versions officielles marquées et peuvent ne pas être aussi soigneusement testées.

Pour différencier les versions, vous pouvez obtenir une liste de modifications associées à chaque projet en émettant la commande suivante et en la passant les deux étiquettes de branche:

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

Par exemple:

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

Pour envoyer la sortie dans un fichier texte:

  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

Modules GPL en nid d'abeille

Pour Honeycomb, l'intégralité du code source de la plate-forme n'est pas disponible. Cependant, les parties de Honeycomb sous licence de GPL et LGPL sont disponibles sous les balises suivantes.

Aucun manifeste ne contient exactement ces modules, mais certains manifestes permettent de construire ces composants. Les commandes suivantes fonctionnent pour 3.0_r1.1:

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

Pour utiliser une autre version, modifiez le paramètre git checkout et (si nécessaire) le paramètre -m dans repo init . La commande git checkout publie une erreur pour tous les projets non GPL où il ne peut pas trouver la balise.

RÉFÉRENCES DE CODEDE et RESSOURCES POUR LES CAS D'APPRENDRE

Des ressources pour le type d'informations sur les noms de code qui sont nécessaires pour prendre en charge les cas d'utilisation de configuration spécifiques sont répertoriés ci-dessous:

• Si vous démarrez en mode Fastboot (à partir d'un appareil qui subit un démarrage froid), vous avez besoin des combinaisons de clés qui correspondent à l'appareil Android que vous utilisez. Pour une liste des appareils avec leurs noms de code Android de périphériques Android correspondants (par exemple, Nexus 5X est le nom de codé Bullhead et utilise une combinaison de clés spécifique), voir le démarrage en mode de démarrage rapide pour obtenir les combinaisons de clés dont vous avez besoin.
• Si votre version nécessite des sources à partir de plusieurs référentiels GIT, utilisez l'approche repo pour télécharger des sources et des outils de construction; Cela garantit une configuration de répertoire source correct. Pour obtenir des noms BRANCH pour les noyaux dont vous avez besoin, voir le téléchargement des sources et des outils de construction pour une liste des appariements de noms de code de périphérique (tels que Pixel 5 - RedFin), référencés croisés à leurs chemins binaires dans l'arbre AOSP et les branches repo correspondantes.

Les versions de développement Android sont organisées en familles, avec des noms de code alphabétiques inspirés par de délicieuses friandises. Cette page fournit des informations sur les noms de code, les versions, les niveaux d'API de plate-forme et les versions NDK , avec une explication des définitions d'ID de construction qui leur sont associées.

Notez que vous pourriez avoir besoin de détails supplémentaires sur la version du nom de code, en fonction de votre cas d'utilisation. Par exemple, vous pourriez avoir besoin de combinaisons de nom de code et de clés de périphérique Android pour démarrer en mode flashboot, ou sources et binaires du noyau pour construire un noyau manuellement. Ceux-ci sont résumés dans la section références et ressources pour les cas d'utilisation des noms de code , avec des liens pour localiser les informations dont vous avez besoin pour ces sujets:

• Le démarrage en mode Flashboot nécessite des combinaisons de clés pour les périphériques avec leurs noms de code Android de périphérique Android correspondants.
• Les noyaux qui doivent être construits nécessitent manuellement les noms de code et les emplacements correspondants pour obtenir des sources et des binaires du noyau.
• Les constructions de cette source plusieurs référentiels GIT nécessitent des appariements de nom de code de périphérique pour obtenir une configuration de répertoire source correct pour télécharger des sources et des outils de construction.

Noms de code, versions, niveaux d'API de plate-forme et versions NDK

Ce tableau répertorie les noms de code, leurs numéros de version correspondants et les niveaux d'API associés.

Construire les définitions d'identification

Dans Android 8.0.0 (Oreo) et supérieur, les constructions individuelles sont identifiées avec le format d'identification de build pvbb.yymmdd.bbb [.cn] , où:

• P représente la première lettre du nom de code de la version de la plate-forme, par exemple, o est Oreo.
• V représente une verticale prise en charge. Par convention, P représente la branche de plate-forme principale.
• BB est un code alphanumérique qui permet à Google d'identifier la branche de code exacte de la construction.
• YyMMDD identifie la date où la libération est ramifiée ou synchronisée avec la branche de développement. Ce n'est pas toujours la date exacte à laquelle une construction a été effectuée car il est courant pour les variations mineures ajoutées à une version existante pour réutiliser le même code de date que la version existante.
• BBB identifie les versions individuelles liées au même code de date, en commençant séquentiellement par 001 .
• CN est un alphanumérique facultatif qui identifie un hotfix au-dessus d'une construction pvbb.yymmdd.bbb existante, à partir de A1 .

Les versions Android plus anciennes utilisent un code d'identification de build différent et plus court (par exemple, FRF85B ) où:

• La première lettre est le nom de code de la famille des versions, par exemple, F est froyo.
• La deuxième lettre est un code de succursale qui permet à Google d'identifier la branche de code exacte de la construction. Par convention, R est la branche de libération primaire.
• La troisième lettre et les deux numéros suivants sont un code de date. La lettre compte les quartiers ( A est le premier trimestre 2009, F est un premier trimestre 2010, etc.). Les deux chiffres comptent les jours dans le trimestre ( F85 est le 24 juin 2010). Le code de date n'est pas toujours la date exacte à laquelle une construction a été effectuée car il est courant pour les variations mineures ajoutées à une version existante pour réutiliser le même code de date que la version existante.
• La dernière lettre identifie les versions individuelles liées au même code de date, en commençant séquentiellement par A (ce qui est implicite et généralement omis pour la concision).

Balises et versions de code source

En commençant par le beignet, la liste exacte des balises et des constructions se trouve dans le tableau suivant. L' ID de construction fournit des informations telles que la version de la plate-forme, la branche de code et la date à laquelle la version a été branchée ou synchronisée avec la branche de développement.