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
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
.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/ .
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 queaosp-android13-gsi
.Accédez à la cible de build aosp_cf_x86_64_phone et cliquez sur userdebug pour la dernière build.
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.
Dans le panneau Artefacts, téléchargez les artefacts pour Seiche.
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.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.
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
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