Premiers pas

Cette page décrit comment lancer une construction AOSP en utilisant 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 sur 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 est de vérifier /dev/kvm :

find /dev -name kvm

Seiche de lancement

  1. Dans une fenêtre de terminal, téléchargez, compilez et installez les packages Debian hôtes :

    sudo apt install -y git devscripts config-package-dev debhelper-compat golang curl
    git clone https://github.com/google/android-cuttlefish
    cd android-cuttlefish
    for dir in base frontend; do
      cd $dir
      debuild -i -us -uc -b -d
      cd ..
    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 Open Source Android (AOSP). Les versions de l'appareil virtuel se trouvent sur le site d'intégration continue d'Android. Pour trouver un index de toutes les versions d'Android, accédez au site d'intégration continue d'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 génération aosp_cf_x86_64_phone et cliquez sur userdebug pour la dernière version.

  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 build.

  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 l'appareil. Dans le nom de fichier, "xxxxxx" est l'ID de construction de ce périphérique.

    2. Faites défiler vers le bas dans le panneau 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 de 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. Lancer 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 l'appareil virtuel sur le Web

Par défaut, Cuttlefish se lance avec --start_webrtc , qui active 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 Cuttlefish : WebRTC Streaming .

Arrêtez la seiche

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

HOME=$PWD ./bin/stop_cvd