Compiler Android

Suivez les instructions de cette page pour compiler Android.

Configurer votre environnement de compilation

À partir de votre répertoire de travail, générez le script envsetup.sh pour configurer votre environnement de compilation:

source build/envsetup.sh

Ce script importe plusieurs commandes qui vous permettent d'utiliser le code source Android, y compris les commandes utilisées sur cette page. Pour afficher la source du script, reportez-vous à platform/build/envsetup.sh. Pour afficher l'aide intégrée, saisissez hmm.

Choisir une cible

Avant de compiler Android, vous devez identifier une cible à compiler. Une cible reflète la plate-forme cible pour laquelle vous effectuez la création. Pour identifier la cible à compiler, utilisez la commande lunch suivie d'une chaîne représentant la cible. Par exemple :

lunch aosp_cf_x86_64_phone-trunk_staging-userdebug

Afficher la cible actuelle

Pour afficher les paramètres actuels du déjeuner, exécutez la commande suivante:

$ echo "$TARGET_PRODUCT-$TARGET_BUILD_VARIANT"

La chaîne représentant la cible est au format suivant:

lunch product_name-release-build_variant

Les composants de cette chaîne sont les suivants:

  • product_name est le nom du produit que vous souhaitez compiler, par exemple aosp_cf_x86_64_phone ou aosp_husky. Votre product_name spécifique peut suivre le format de votre propre appareil, mais celui que Google utilise pour ses appareils contient les composants suivants:

    • aosp fait référence à la plate-forme Open Source Android.
    • (Facultatif) cf est inclus lorsque la cible doit être exécutée dans l'émulateur de seiche.
    • Architecture et matériel (nom de code), comme x86_64_phone ou husky, qui est le nom de code du Pixel 8 Pro. Pour obtenir la liste des noms de code des appareils Google, consultez Noms de code des appareils.

  • release est défini sur trunk_staging.

  • La partie build_variant de la chaîne peut correspondre à l'une des trois valeurs du tableau suivant:

    build_variant Description
    user Cette variante de compilation offre un accès limité à la sécurité et est adaptée à la production.
    userdebug Cette variante de compilation aide les développeurs d'appareils à comprendre les performances et la puissance des versions en cours de développement. Lorsque vous développez avec un build userdebug, suivez les Consignes pour le débogage utilisateur.
    eng Cette variante de compilation offre une durée de compilation plus rapide. Elle est particulièrement adaptée au développement quotidien si vous n'avez pas besoin de vous soucier des performances ni de la puissance.

Si vous exécutez lunch sans aucun argument, une liste de cibles courantes s'affiche. Vous pouvez également créer vos propres chaînes cibles en assemblant les éléments de la chaîne cible à l'aide des informations de cette page et des noms de code qui représentent du matériel Google spécifique sur la page Noms de code des appareils.

Compiler le code

Exécutez la commande suivante pour créer votre cible. Selon les spécifications de votre station de travail, la première compilation peut prendre moins d'une heure, et jusqu'à quelques heures. Les compilations suivantes prennent beaucoup moins de temps.

$ m

Le premier résultat qui s'affiche est un résumé de votre cible et de votre environnement de compilation:

============================================
PLATFORM_VERSION_CODENAME=VanillaIceCream
PLATFORM_VERSION=VanillaIceCream
PRODUCT_INCLUDE_TAGS=com.android.mainline
TARGET_PRODUCT=aosp_arm
TARGET_BUILD_VARIANT=eng
TARGET_ARCH=arm
TARGET_ARCH_VARIANT=armv7-a-neon
TARGET_CPU_VARIANT=generic
HOST_OS=linux
HOST_OS_EXTRA=Linux-6.5.13-1rodete2-amd64-x86_64-Debian-GNU/Linux-rodete
HOST_CROSS_OS=windows
BUILD_ID=AOSP.MAIN
OUT_DIR=out
============================================

Le résultat de votre compilation s'affiche dans $OUT_DIR. Si vous compilez différentes cibles, chaque build cible apparaît dans $OUT_DIR.

La commande m s'appuie sur le haut de l'arborescence pour que vous puissiez exécuter m à partir de sous-répertoires. Si la variable d'environnement TOP est définie, la commande m l'utilise. Si TOP n'est pas défini, la commande m recherche l'arborescence à partir du répertoire actuel et tente de trouver le haut de l'arborescence.

La commande m peut gérer des tâches parallèles avec un argument -jN. Si vous ne fournissez pas d'argument -j, le système de compilation sélectionne automatiquement un nombre de tâches parallèles qu'il juge optimal pour votre système.

Vous pouvez créer des modules spécifiques au lieu de l'image complète de l'appareil en répertoriant les noms des modules dans votre ligne de commande m. En outre, la commande m fournit des pseudo-cibles, appelées objectifs. Par exemple, m nothing ne crée rien, mais analyse et valide la structure de compilation. Pour obtenir la liste des objectifs valides, saisissez m help.

Résoudre les erreurs de compilation (version 8.0 ou antérieure)

Si vous compilez AOSP 8 ou une version antérieure, m peut abandonner en cas de problème avec votre version de Java. Par exemple, le message suivant peut s'afficher:

************************************************************
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
************************************************************

Voici les causes probables du problème et les solutions correspondantes:

  • Vous n'avez pas installé le bon JDK comme indiqué dans les sections JDK de la page Configurer pour le développement AOSP (2.3 à 8.0) .
  • Un autre JDK déjà installé apparaît dans votre chemin d'accès. Ajoutez le JDK approprié au début de votre chemin d'accès ou supprimez le JDK problématique.