Premiers pas

Cette page décrit comment lancer une build AOSP à l'aide de Cuttlefish .

Vérifier la disponibilité du KVM

Cuttlefish est un périphérique virtuel et 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 une machine virtuelle basée sur le noyau (KVM) est disponible :

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

Cette commande doit renvoyer une valeur différente de zéro.

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

find /dev -name kvm

Lancer la seiche

  1. Dans une fenêtre de terminal, téléchargez, créez 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
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 noyau supplémentaires et applique les règles udev .

  2. Cuttlefish fait partie de la plate-forme Android Open-Source (AOSP). Les versions du périphérique virtuel se trouvent sur le site d'intégration continue Android. Pour trouver un index de toutes les versions d'Android, accédez au site d'intégration continue Android à l'adresse http://ci.android.com/ .

  3. Entrez un nom de succursale. Utilisez la branche aosp-main par défaut ou utilisez une branche d'image système générique (GSI) telle que aosp-android13-gsi .

  4. Accédez à la cible de build aosp_cf_x86_64_phone et cliquez sur userdebug pour la dernière build.

  5. Cliquez sur la case verte sous userdebug pour sélectionner cette version. Un panneau Détails apparaît avec plus d’informations spécifiques à cette version. Dans ce panneau, cliquez sur Artefacts pour afficher une liste de tous les artefacts attachés à cette version.

  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 , qui contient les images de périphérique. Dans le nom de fichier, « xxxxxx » est l'ID de build de ce périphérique.

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

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

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

  8. Lancement de la seiche :

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

Vérifiez que la seiche est visible via adb

Semblable à un appareil physique, Cuttlefish est visible via le pont de débogage Android (adb) .

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

./bin/adb devices

Afficher et interagir avec le périphérique virtuel sur le Web

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

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

Pour plus d’informations, consultez Seiche : Streaming WebRTC .

Arrêtez la seiche

Arrêtez le périphérique virtuel dans le même répertoire que celui que vous avez utilisé pour lancer le périphérique :

HOME=$PWD ./bin/stop_cvd