À partir de 2026, pour nous aligner sur notre modèle de développement stable et garantir la stabilité de la plate-forme pour l'écosystème, nous publierons le code source sur AOSP au deuxième et au quatrième trimestre. Pour créer et contribuer dans AOSP, utilisez android-latest-release. La branche de fichier manifeste android-latest-release fera toujours référence à la version la plus récente envoyée à AOSP. Pour en savoir plus, consultez Modifications apportées à AOSP.

Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Essayer le développement Android

Ce tutoriel vous permet de vous essayer au développement du système d'exploitation Android pour la première fois.

Configurer pour le développement Android

Avant de télécharger et de compiler la branche du fichier manifeste android-latest-release de la source Android, assurez-vous que votre matériel répond aux exigences nécessaires et que les logiciels requis sont correctement installés. Vous devez également connaître les termes suivants :

Git: Git est un système de contrôle des versions distribué, sans frais et Open Source. Android utilise Git pour les opérations locales telles que la création de branches, les commits, les diffs et les modifications. Pour en savoir plus sur Git, consultez la documentation Git.
Repo: Repo est un wrapper Python autour de Git qui simplifie l'exécution d'opérations complexes sur plusieurs dépôts Git. Repo ne remplace pas Git pour toutes les opérations de contrôle des versions. Il facilite simplement l'exécution des opérations Git complexes. Repo utilise des fichiers manifestes pour regrouper les projets Git dans le superprojet Android.
fichier manifeste: Un fichier manifeste est un fichier XML qui spécifie l'emplacement des différents projets Git de la source Android dans une arborescence source AOSP.

Configuration requise pour les appareils Google Meet

Votre poste de travail de développement doit respecter ou dépasser les exigences matérielles suivantes :

Un système x86 64 bits.

Remarque : Vous pouvez compiler les versions d'AOSP antérieures à la version 2.3.x sur des systèmes 32 bits.
Au moins 400 Go d'espace disque libre pour extraire et compiler le code (250 Go pour l'extraction et 150 Go pour la compilation).

Remarque : Si vous extrayez un miroir, vous aurez besoin de plus d'espace, car les miroirs complets d'Android Open Source Project (AOSP) contiennent tous les dépôts Git qui ont déjà été utilisés.
Au moins 64 Go de RAM. Google utilise des machines à 72 cœurs avec 64 Go de RAM pour compiler Android. Avec cette configuration matérielle, il faut environ 40 minutes pour une compilation complète d'Android et seulement quelques minutes pour une compilation incrémentielle d'Android. En revanche, il faut environ six heures pour une compilation complète avec une machine à six cœurs et 64 Go de RAM.

Respecter la configuration système requise

Votre poste de travail de développement doit exécuter une distribution Linux 64 bits avec GNU C Library (glibc) 2.17 ou version ultérieure.

Installer les packages requis

Pour installer les packages requis pour Ubuntu 18.04 ou version ultérieure, exécutez la commande suivante :

sudo apt-get install git-core gnupg flex bison build-essential zip curl zlib1g-dev libc6-dev-i386 x11proto-core-dev libx11-dev lib32z1-dev libgl1-mesa-dev libxml2-utils xsltproc unzip fontconfig

Installer les logiciels requis

Avant de pouvoir utiliser l'AOSP, vous devez installer OpenJDK, Make, Python 3 et Repo. La dernière branche de version d'Android est fournie avec des versions prédéfinies d'OpenJDK, de Make et de Python 3. Aucune étape d'installation supplémentaire n'est donc requise. La section suivante explique comment installer Repo.

Installer Repo

Pour installer Repo, procédez comme suit :

Téléchargez les informations sur le package actuel :
```
sudo apt-get update
```
Exécutez la commande suivante pour installer le lanceur Repo :
```
sudo apt-get install repo
```
Le lanceur Repo fournit un script Python qui initialise un checkout et télécharge l'outil Repo complet.

Si l'opération réussit, passez à l'étape 4.
Facultatif : Installez manuellement Repo à l'aide de la série de commandes suivante :
```
export REPO=$(mktemp /tmp/repo.XXXXXXXXX)
curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo
gpg --recv-keys 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo
```
Les trois premières commandes configurent un fichier temporaire, téléchargent Repo dans le fichier et vérifient que la clé fournie correspond à la clé requise. Si ces commandes aboutissent, la commande finale installe le lanceur Repo.
Vérifiez la version du lanceur Repo :
```
repo version
```
Le résultat doit indiquer une version 2.4 ou ultérieure, par exemple :
```
repo launcher version 2.45
```

Télécharger la source Android

Le code source Android se trouve dans un ensemble de dépôts Git hébergés par Google. Chaque dépôt Git inclut l'historique complet de la source Android, y compris les modifications apportées à la source et la date de ces modifications. Pour télécharger la source Android :

Accédez à votre répertoire d'accueil :
```
cd ~
```
Créez-y un sous-répertoire de travail local :
```
mkdir aosp
```
Accédez au répertoire :
```
cd aosp
```

Initialisez la dernière branche de release du code source du dépôt AOSP (android-latest-release) :

repo init --partial-clone -b android-latest-release -u https://android.googlesource.com/platform/manifest

Saisissez ou acceptez vos identifiants Git (nom, adresse e-mail).
Synchronisez le code source :
```
repo sync -c -j8
```
Si vous rencontrez des problèmes lors du téléchargement, consultez Résoudre les problèmes de synchronisation.

Compiler le code

Pour compiler le code :

Dans votre répertoire de travail, sourcez le script envsetup.sh pour configurer votre environnement de compilation :
```
source build/envsetup.sh
```

Spécifiez un type d'appareil cible à compiler avec la commande lunch. Une cible est une permutation d'appareil, comme un modèle ou un facteur de forme spécifique. Spécifiez cette cible :

lunch aosp_cf_x86_64_only_phone-aosp_current-userdebug

Un résumé de votre cible et de votre environnement de compilation devrait s'afficher :

============================================
PLATFORM_VERSION_CODENAME=Baklava
PLATFORM_VERSION=Baklava
TARGET_PRODUCT=aosp_cf_x86_64_only_phone
TARGET_BUILD_VARIANT=userdebug
TARGET_ARCH=x86_64
TARGET_ARCH_VARIANT=silvermont
HOST_OS=linux
HOST_OS_EXTRA=Linux-6.10.11-1rodete2-amd64-x86_64-Debian-GNU/Linux-rodete
HOST_CROSS_OS=windows
BUILD_ID=BP1A.250305.020
OUT_DIR=out
============================================

Créez la cible :
```
m
```

La première compilation peut prendre plusieurs heures. Les builds suivants prennent beaucoup moins de temps. Le résultat de votre compilation s'affiche dans $OUT_DIR.

Lancer Cuttlefish

Cuttlefish est l'émulateur Android utilisé pour tester vos builds.

Exécutez les commandes suivantes pour télécharger, compiler et installer les packages Debian hôtes :

sudo apt install -y git devscripts equivs config-package-dev debhelper-compat golang curl
git clone https://github.com/google/android-cuttlefish
cd android-cuttlefish
tools/buildutils/build_packages.sh
sudo apt install -y ./cuttlefish-base_*.deb ./cuttlefish-user_*.deb
sudo usermod -aG kvm,cvdnetwork,render $USER
sudo reboot

Le redémarrage déclenche l'installation de modules de noyau supplémentaires et applique les règles udev.

Une fois votre station de travail redémarrée, accédez à votre répertoire aosp, configurez votre environnement de compilation et lancez Cuttlefish :
```
cd ~/aosp
source build/envsetup.sh
lunch aosp_cf_x86_64_only_phone-aosp_current-userdebug
launch_cvd --daemon
```
Connectez-vous à l'appareil Cuttlefish en accédant à https://localhost:8443 dans votre navigateur Web. Votre appareil virtuel Android s'affiche.

Effectuer une modification

Mettez à jour le code source en suivant cet exemple de liste de modifications.

À partir de la racine de votre extraction (répertoire aosp/), accédez au projet Git frameworks/native :
```
cd frameworks/native
```
Démarrez une branche temporaire à l'aide de la commande suivante :
```
repo start BRANCH_NAME .
```
Utilisez votre éditeur pour modifier SurfaceFlinger.cpp à l'emplacement suivant :
```
aosp/frameworks/native/services/surfaceflinger/SurfaceFlinger.cpp
```

Localisez la ligne suivante :

void SurfaceFlinger::updateColorMatrixLocked() {

Ajoutez cette ligne au début de updateColorMatrixLocked() :

mClientColorMatrix = mat4(vec4{1.0f, 0.0f, 0.0f, 0.0f}, vec4{0.0f, -1.0f, 0.0f, 0.0f},
                          vec4{0.0f, 0.0f, -1.0f, 0.0f}, vec4{0.0f, 1.0f, 1.0f, 1.0f});

Créez le code :
```
m
```

Mettez à jour la compilation sur l'appareil :

adb root
adb remount -R
adb root
adb sync
adb reboot

Vérifiez que la couleur change sur l'appareil sélectionné.

Corriger un test

Cette partie de l'atelier de programmation utilise un exemple de test qui se trouve dans l'arborescence source et qui échoue. Pour exécuter, déboguer et corriger le test, suivez ces instructions :

Exécutez la commande suivante :
```
atest DevCodelabTest
```
Le test échoue.

Remarque : atest est un outil de ligne de commande qui vous permet de créer, d'installer et d'exécuter des tests Android localement.

Examinez la trace de la pile du test qui échoue :

STACKTRACE:
java.lang.AssertionError
    at org.junit.Assert.fail(Assert.java:87)
    at org.junit.Assert.assertTrue(Assert.java:42)
    at org.junit.Assert.assertTrue(Assert.java:53)
    at android.test.example.devcodelab.DevCodelabTest.testHelloWorld(DevCodelabTest.java:29)

La dernière ligne de la trace de la pile indique le test qui échoue (testHelloWorld). Ce test se trouve dans un fichier nommé DevCodelabTest.java.

Pour déterminer l'emplacement du test à corriger, ajoutez WORKING_DIRECTORY/platform_testing/tests/example/devcodelab/src/ à la dernière ligne de la trace de la pile, jusqu'au nom du fichier de test inclus. android.test.example.devcodelab.DevCodelabTest devient donc WORKING_DIRECTORY/platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java.
Modifiez platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java et remplacez Assert.assertTrue(false) par Assert.assertTrue(true).
Exécutez à nouveau le test pour vérifier que vous avez résolu le problème :
```
atest DevCodelabTest
```

Importer votre code pour examen

Repo simplifie l'utilisation de Git en regroupant des commandes telles que git clone pour travailler simultanément sur plusieurs dépôts (ou projets) Git. Pour la revue de code de vos projets dans Git, utilisez le système de revue de code Web Gerrit.

En supposant que vous avez apporté vos modifications dans le projet frameworks/native, exécutez ces commandes pour importer vos modifications :
```
cd frameworks/native
repo start BRANCH_NAME .
git add .
git commit
```
Pour votre message de commit, saisissez ce qui suit :
```
Android BRANCH_NAME change
Test: manual atest
```

Importez votre modification :

repo upload

Si l'opération aboutit, un message semblable à celui-ci s'affiche :

Upload project frameworks/native/ to remote branch android17-release:
  branch BRANCH_NAME ( 1 commit, Wed Aug 7 09:32:33 2019 -0700):
         ff46b36d Android BRANCH_NAME change
to https://android-review.googlesource.com/ (y/N)? y
remote: Processing changes: refs: 1, new: 1, done
remote:
remote: SUCCESS
remote:
remote:   https://android-review.googlesource.com/c/platform/frameworks/native/+/1098432 Android BRANCH_NAME change [NEW]
remote:
To https://android-review.googlesource.com/platform/frameworks/native
* [new branch]          BRANCH_NAME -> refs/for/android17-release

Afficher votre modification dans Gerrit

Pour afficher votre modification dans Gerrit, accédez au lien affiché dans le terminal. Le lien ressemble à ceci :

https://android-review.googlesource.com/c/platform/frameworks/native/+/1098432

Annulez votre modification

Normalement, après les tests, l'examen et l'approbation, vous envoyez votre modification dans Gerrit et la fusionnez dans le dépôt. Pour les besoins de cet atelier de programmation, annulez plutôt vos modifications :

Dans Gerrit, cliquez sur Abandon.
Abandonnez la branche temporaire associée dans le répertoire du projet frameworks/native (ou ses sous-répertoires) :
```
repo abandon BRANCH_NAME .
```
Annulez les modifications que vous avez apportées au fichier de test. Comme vous n'avez pas exécuté repo start, git commit et repo upload sur la modification de test, vous pouvez réinitialiser le fichier lui-même. En supposant que vous vous trouvez dans le répertoire aosp/platform_testing, utilisez les commandes suivantes pour réinitialiser le fichier :
```
git reset HEAD tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java
git checkout .
```

L'atelier de programmation sur le développement de la plate-forme Android est maintenant terminé.

Obtenir de l'aide

Si vous rencontrez des erreurs au cours de cet atelier de programmation, signalez-les à l'aide du lien Issue Tracker en bas de n'importe quelle page. Envoyez vos questions au groupe android-building.

Saisissez ps -A | grep crosvm pour vérifier si crosvm est déjà en cours d'exécution. Si crosvm est en cours d'exécution, saisissez le processus stop_cvd || true ou kill crosvm avec le PID du processus.