Cette page a été traduite par l'API Cloud Translation.

Essayer le développement Android

Ce tutoriel vous permet de tester le 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 main de la source Android, assurez-vous que votre matériel répond aux exigences requises et que le logiciel requis est correctement installé. 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 les embranchements, les commits, les différences et les modifications. Pour obtenir de l'aide sur l'apprentissage de Git, consultez la documentation Git.
Dépôt: 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 ne facilite que les opérations Git complexes. Le dépôt utilise des fichiers manifestes pour agréger 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 dans la source Android dans un arbre de sources AOSP.

Disposer de la configuration matérielle requise

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

Un système x86 64 bits.

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

Remarque : Si vous effectuez un "checkout" d'un miroir, vous avez besoin de plus d'espace, car les miroirs complets du projet 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, la compilation complète d'Android prend environ 40 minutes et la compilation incrémentielle d'Android ne prend que quelques minutes. En revanche, une compilation complète avec une machine à 6 cœurs et 64 Go de RAM prend environ six heures.

Respecter les exigences du système d'exploitation

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

Installer les packages requis

Pour installer les paquets 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 le logiciel requis

Avant de pouvoir travailler avec AOSP, vous devez installer OpenJDK, Make, Python 3 et Repo. La branche principale d'Android, AOSP, est fournie avec des versions précompilées d'OpenJDK, de Make et de Python 3. Par conséquent, aucune étape d'installation supplémentaire n'est 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 de dépôts:
```
sudo apt-get install repo
```
Le lanceur de dépôts fournit un script Python qui initialise un processus de récupération et télécharge l'outil complet du dépôt.

Si vous y parvenez, passez à l'étape 4.
(Facultatif) Installez manuellement Repo à l'aide des séries de commandes suivantes:
```
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 de dépôts:
```
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 une collection de dépôts Git hébergés par Google. Chaque dépôt Git inclut l'intégralité de l'historique de la source Android, y compris les modifications apportées à la source et à la date à laquelle elles ont été apportées. Pour télécharger le code source Android :

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

Initialisez la branche principale du code source du dépôt AOSP (par défaut):

repo init --partial-clone -b main -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 :

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

Spécifiez un type d'appareil cible à compiler à l'aide de 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_phone-trunk_staging-userdebug

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

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

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

La première compilation peut prendre plusieurs heures. Les compilations suivantes 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 paquets 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
for dir in base frontend; do
pushd $dir
# Install build dependencies
sudo mk-build-deps -i
dpkg-buildpackage -uc -us
popd
done
sudo dpkg -i ./cuttlefish-base_*_*64.deb || sudo apt-get install -f
sudo dpkg -i ./cuttlefish-user_*_*64.deb || sudo apt-get install -f
sudo usermod -aG kvm,cvdnetwork,render $USER
sudo reboot

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

Lancez Cuttlefish :
```
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 un projet temporaire à l'aide de cette commande:
```
repo start <some-name> .
```
Utilisez votre éditeur pour modifier SurfaceFlinger.cpp à l'emplacement suivant :
```
aosp/frameworks/native/services/surfaceflinger/SurfaceFlinger.cpp
```

Recherchez 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 le build sur l'appareil:

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

Vérifiez que la couleur de l'appareil sélectionné change, comme illustré à la figure 1.

Figure 1 : Apparence de l'écran après un changement de couleur réussi

Corriger un test

Cette partie de l'atelier de programmation utilise un exemple de test qui se trouve dans l'arborescence source et échoue.

Pour exécuter, déboguer et corriger le test, procédez comme suit :

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 en local.

Examinez la trace de la pile du test défaillant :

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 appelé 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, y compris. Ainsi, android.test.example.devcodelab.DevCodelabTest devient 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 sur de nombreux dépôts (ou projets) Git à la fois.

Pour examiner le code de vos projets dans Git, utilisez le système d'examen du code basé sur le Web Gerrit.

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

Importez votre modification:

repo upload

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

Upload project frameworks/native/ to remote branch main:
 branch codelab ( 1 commit, Wed Aug 7 09:32:33 2019 -0700):
        ff46b36d android codelab 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 codelab change [NEW]
remote:
To https://android-review.googlesource.com/platform/frameworks/native
* [new branch]          codelab -> refs/for/main

Afficher votre modification dans Gerrit

Pour afficher votre modification dans Gerrit, accédez à la sortie du lien dans le terminal. Le lien ressemble à ceci:

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

Annuler votre modification

Normalement, après les tests, et après examen et 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 votre travail:

Sous Gerrit, cliquez sur Abandon (Abandonner).
Abandonnez la branche temporaire associée dans le répertoire de projet frameworks/native (ou ses sous-répertoires) :
```
repo abandon codelab .
```
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 pour le changement de test, vous pouvez réinitialiser le fichier lui-même. Si vous vous trouvez dans aosp/platform_testing directory, utilisez la commande suivante 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 (Outil de suivi des problèmes) en bas de n'importe quelle page. Envoyez vos questions au groupe android-building.

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