Los gehts

Auf dieser Seite wird beschrieben, wie Sie mit Cuttlefish einen AOSP-Build starten.

KVM-Verfügbarkeit prüfen

Cuttlefish ist ein virtuelles Gerät und hängt davon ab, dass auf dem Hostcomputer Virtualisierung verfügbar ist.

Prüfen Sie in einem Terminal auf Ihrem Hostcomputer, ob die Virtualisierung mit einer kernelbasierten virtuellen Maschine (KVM) verfügbar ist:

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

Dieser Befehl sollte einen Wert zurückgeben, der nicht null ist.

Wenn Sie auf einem ARM64-Rechner arbeiten, ist die direkteste Methode, nach /dev/kvm zu suchen:

find /dev -name kvm

Cuttlefish starten

1. Laden Sie die Debian-Pakete für den Host in einem Terminalfenster herunter, erstellen Sie sie und installieren Sie sie:

   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

   Durch den Neustart werden zusätzliche Kernelmodule installiert und udev-Regeln angewendet.

2. Cuttlefish ist Teil der Android Open Source Platform (AOSP). Builds des virtuellen Geräts finden Sie auf der Website für die Android-Continuous-Integration. Einen Index aller Android-Builds finden Sie auf der Website für die kontinuierliche Integration von Android unter http://ci.android.com/.

3. Geben Sie einen Zweignamen ein. Verwenden Sie den Standard-Branch aosp-android-latest-release oder einen Branch für generische Systemimages (GSI) wie aosp-android13-gsi.

4. Rufen Sie das Buildziel aosp_cf_x86_64_only_phone auf und klicken Sie auf userdebug für den neuesten Build.

5. Klicken Sie auf das grüne Kästchen unter userdebug, um diese Build-Version auszuwählen. Der Bereich Details mit weiteren Informationen zu diesem Build wird angezeigt. Klicken Sie in diesem Bereich auf Artefakte, um eine Liste aller mit diesem Build verknüpften Artefakte aufzurufen.

6. Laden Sie im Bereich „Artefakte“ die Artefakte für Cuttlefish herunter.

   1. Klicken Sie auf das aosp_cf_x86_64_phone-img-xxxxxx.zip-Artefakt für x86_64 oder das aosp_cf_arm64_only_phone-xxxxxx.zip-Artefakt für ARM64, das die Gerätebilder enthält. Im Dateinamen ist „xxxxxx“ die Build-ID für dieses Gerät.

   2. Scrollen Sie im Steuerfeld nach unten und laden Sie cvd-host_package.tar.gz herunter. Laden Sie das Hostpaket immer aus demselben Build wie Ihre Images herunter.

7. Erstellen Sie auf Ihrem lokalen System einen Containerordner und extrahieren Sie die Pakete:

   1. x86_64-Architektur:

      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. ARM64-Architektur:

      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. Cuttlefish starten:

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

Prüfen, ob Cuttlefish über adb sichtbar ist

Ähnlich wie bei einem physischen Gerät ist Cuttlefish über die Android Debug Bridge (adb) sichtbar.

Führen Sie im selben Ordner, in dem Sie Cuttlefish gestartet haben, den folgenden Befehl aus, um eine Liste aller Android-Geräte aufzurufen, die über adb auf Ihrem Hostcomputer verfügbar sind:

./bin/adb devices

Virtuelles Gerät im Web ansehen und damit interagieren

Standardmäßig wird Cuttlefish mit --start_webrtc gestartet, wodurch eine Webansicht über Port 8443 auf dem Hostcomputer aktiviert wird.

Wenn Sie Ihre virtuellen Geräte aufrufen und mit ihnen interagieren möchten, rufen Sie in Ihrem Webbrowser https://localhost:8443 auf.

Weitere Informationen finden Sie unter Cuttlefish: WebRTC-Streaming.

Cuttlefish beenden

Beenden Sie das virtuelle Gerät im selben Verzeichnis, in dem Sie es gestartet haben:

HOME=$PWD ./bin/stop_cvd