Premiers pas

Cette page explique comment lancer un build AOSP à l'aide de Seiche :

Vérifier la disponibilité de KVM

La seiche est un appareil virtuel qui dépend de la virtualisation disponible sur la machine hôte.

Dans un terminal de votre machine hôte, assurez-vous que la virtualisation avec un La machine virtuelle basée sur Kernel (KVM) est disponible:

grep -c -w "vmx\|svm" /proc/cpuinfo

Cette commande doit renvoyer une valeur non nulle.

Lors de l'exécution sur une machine ARM64, le moyen le plus direct consiste à vérifier /dev/kvm:

find /dev -name kvm

---

Lancer seiche

1. Dans une fenêtre de terminal, téléchargez, compilez et installez 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 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 noyau supplémentaires et applique udev. des règles de pare-feu.

2. Settlefish fait partie de la plate-forme Android Open Source (AOSP). Versions de l'appareil virtuel se trouvent sur le site d'intégration continue Android. À recherchez un index de tous les builds Android, accédez à Android Continuous Site d'intégration à l'adresse http://ci.android.com/

3. Saisissez un nom de branche. Utilisez la branche aosp-main par défaut ou un branche d'image système générique (GSI) comme aosp-android13-gsi.

4. Accédez à la cible de compilation aosp_cf_x86_64_phone, puis cliquez sur userdebug pour obtenir la dernière version.

5. Cliquez sur la case verte sous userdebug pour sélectionner ce build. A Détails s'affiche avec des informations spécifiques cette compilation. Dans ce panneau, cliquez sur Artefacts pour afficher la liste de tous les aux artefacts associés à cette compilation.

6. Dans le panneau "Artefacts", téléchargez les artefacts pour seiche.

   1. Cliquez sur l'artefact aosp_cf_x86_64_phone-img-xxxxxx.zip pour x86_64 ou l'artefact aosp_cf_arm64_only_phone-xxxxxx.zip pour ARM64, contenant les images de l'appareil. Dans le nom de fichier, "xxxxxx" est la compilation ID de cet appareil.

   2. Faites défiler le panneau vers le bas, puis téléchargez cvd-host_package.tar.gz. Toujours téléchargez le package hôte à partir de la même compilation que vos images.

7. Sur votre système local, créez un dossier de conteneur et extrayez les packages:

   1. Architecture x86_64:

      mkdir cf
      cd cf
      tar -xvf /path/to/cvd-host_package.tar.gz
      unzip /path/to/aosp_cf_x86_64_phone-img-xxxxxx.zip
      

   2. Architecture ARM64:

      mkdir cf
      cd cf
      tar -xvf /path/to/cvd-host_package.tar.gz
      unzip /path/to/aosp_cf_arm64_only_phone-img-xxxxxx.zip
      

8. Lancez Settlefish:

   HOME=$PWD ./bin/launch_cvd --daemon
   

Vérifier que seiche est visible via adb

Comme un appareil physique, seiche est visible à travers le Android Debug Bridge (adb) :

Dans le dossier où vous avez lancé Cuttlefish, exécutez la commande suivante : pour afficher la liste de tous les appareils Android disponibles via adb sur votre machine hôte:

./bin/adb devices

Afficher l'appareil virtuel et interagir avec celui-ci sur le Web

Par défaut, Cuttlefish se lance avec --start_webrtc, ce qui active une WebView. via le port 8443 sur la machine hôte.

Pour afficher vos appareils virtuels et interagir avec, accédez à https://localhost:8443 dans votre navigateur Web.

Pour en savoir plus, consultez Cuttlefish: WebRTC Streaming

Arrêter la seiche

Arrêtez l'appareil virtuel dans le même répertoire que celui utilisé pour lancer le appareil:

HOME=$PWD ./bin/stop_cvd