Başlama

Bu sayfada, Cuttlefish kullanarak AOSP derlemesinin nasıl başlatılacağı açıklanmaktadır.

KVM'nin kullanılabilirliğini doğrulama

Cuttlefish, sanal bir cihazdır ve ana makinede sanallaştırmanın kullanılabilir olmasına bağlıdır.

Ana makinenizdeki bir terminalde, Kernel Tabanlı Sanal Makine (KVM) ile sanallaştırmanın kullanılabilir olduğundan emin olun:

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

Bu komut sıfır olmayan bir değer döndürmelidir.

ARM64 makinede çalıştırırken en doğrudan yöntem, /dev/kvm olup olmadığını kontrol etmektir:

find /dev -name kvm

Cuttlefish'i başlatma

1. Bir terminal penceresinde ana makine Debian paketlerini indirip oluşturun ve yükleyin:

   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

   Yeniden başlatma işlemi, ek çekirdek modüllerinin yüklenmesini tetikler ve udev kurallarını uygular.

2. Cuttlefish, Android Açık Kaynak Platformu'nun (AOSP) bir parçasıdır. Sanal cihaz derlemeleri, Android Continuous Integration sitesinde bulunur. Tüm Android derlemelerinin dizini için http://ci.android.com/ adresindeki Android Sürekli Entegrasyon sitesine gidin.

3. Bir şube adı girin. Varsayılan aosp-android-latest-release dalını kullanın veya aosp-android13-gsi gibi bir genel sistem görüntüsü (GSI) dalı kullanın.

4. aosp_cf_x86_64_only_phone derleme hedefine gidin ve en son derleme için userdebug'ı tıklayın.

5. Bu derlemeyi seçmek için userdebug'ın altındaki yeşil kutuyu tıklayın. Bu derlemeye özel daha fazla bilgi içeren bir Ayrıntılar paneli gösterilir. Bu panelde, bu derlemeye eklenen tüm yapıtların listesini görmek için Yapıtlar'ı tıklayın.

6. Yapılar panelinde Cuttlefish'e ait yapıları indirin.

   1. Cihaz resimlerini içeren x86_64 için aosp_cf_x86_64_phone-img-xxxxxx.zip veya ARM64 için aosp_cf_arm64_only_phone-xxxxxx.zip yapısını tıklayın. Dosya adındaki "xxxxxx", bu cihazın derleme kimliğidir.

   2. Panelde aşağı kaydırıp cvd-host_package.tar.gz dosyasını indirin. Her zaman ana makine paketini, resimlerinizle aynı derlemeden indirin.

7. Yerel sisteminizde bir kapsayıcı klasör oluşturun ve paketleri çıkarın:

   1. x86_64 mimarisi:

      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 mimarisi:

      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'i başlatın:

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

Cuttlefish'in adb üzerinden görünür olduğunu doğrulayın.

Fiziksel bir cihaza benzer şekilde Cuttlefish, Android Debug Bridge (adb) üzerinden görülebilir.

Cuttlefish'i başlattığınız klasörde, ana makinenizde adb üzerinden kullanılabilen tüm Android cihazların listesini görmek için aşağıdaki komutu çalıştırın:

./bin/adb devices

Web'de sanal cihazı görüntüleme ve sanal cihazla etkileşim kurma

Cuttlefish, varsayılan olarak --start_webrtc ile başlatılır. Bu, ana makinedeki 8443 numaralı bağlantı noktası üzerinden bir web görünümü sağlar.

Sanal cihazlarınızı görüntülemek ve bunlarla etkileşim kurmak için web tarayıcınızda https://localhost:8443 adresine gidin.

Daha fazla bilgi için Cuttlefish: WebRTC Streaming başlıklı makaleyi inceleyin.

Cuttlefish'i durdurma

Sanal cihazı, cihazı başlatmak için kullandığınız dizinde durdurun:

HOME=$PWD ./bin/stop_cvd