Начать

На этой странице описано, как запустить сборку AOSP с помощью Cuttlefish .

Проверьте доступность KVM.

Cuttlefish — это виртуальное устройство, и его работа зависит от наличия виртуализации на хост-машине.

В терминале на вашем компьютере убедитесь, что виртуализация с использованием виртуальной машины на основе ядра (KVM) доступна:

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

Эта команда должна вернуть ненулевое значение.

При работе на ARM64-процессорной системе наиболее прямой способ — проверить наличие /dev/kvm :

find /dev -name kvm

Запуск каракатицы

1. В окне терминала загрузите, соберите и установите пакеты Debian для хост-системы:

   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

   Перезагрузка запускает установку дополнительных модулей ядра и применяет правила udev .

2. Cuttlefish является частью платформы Android с открытым исходным кодом (AOSP). Сборки виртуального устройства можно найти на сайте непрерывной интеграции Android. Чтобы найти индекс всех сборок Android, перейдите на сайт непрерывной интеграции Android по адресу http://ci.android.com/ .

3. Введите имя ветки. Используйте ветку по умолчанию aosp-android-latest-release или ветку универсального образа системы (GSI), например aosp-android13-gsi .

4. Перейдите к целевому объекту сборки aosp_cf_x86_64_only_phone и нажмите userdebug , чтобы получить последнюю сборку.

5. Щелкните зеленую рамку под userdebug , чтобы выбрать эту сборку. Откроется панель «Подробности» с дополнительной информацией, относящейся к этой сборке. На этой панели щелкните «Артефакты» , чтобы увидеть список всех артефактов, прикрепленных к этой сборке.

6. В панели «Артефакты» загрузите артефакты для Каракатицы.

   1. Для архитектуры x86_64 щелкните файл aosp_cf_x86_64_phone-img-xxxxxx.zip , а для ARM64 — файл aosp_cf_arm64_only_phone-xxxxxx.zip , содержащие образы устройств. В имени файла "xxxxxx" — это идентификатор сборки для данного устройства.

   2. Прокрутите вниз в панели и загрузите cvd-host_package.tar.gz . Всегда загружайте пакет host из той же сборки, что и ваши образы.

7. На локальном компьютере создайте папку-контейнер и извлеките пакеты:

   1. Архитектура x86_64:

      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:

      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:

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

Убедитесь, что приложение Cuttlefish отображается через adb.

Подобно физическому устройству, Cuttlefish виден через Android Debug Bridge (adb) .

В той же папке, где вы запустили Cuttlefish, выполните следующую команду, чтобы увидеть список всех устройств Android, доступных через adb на вашем компьютере:

./bin/adb devices

Просматривайте виртуальное устройство и взаимодействуйте с ним в веб-браузере.

По умолчанию Cuttlefish запускается с --start_webrtc , который включает веб-просмотр через порт 8443 на хост-машине.

Для просмотра и взаимодействия с виртуальными устройствами перейдите по адресу https://localhost:8443 в вашем веб-браузере.

Для получения дополнительной информации см. Cuttlefish: WebRTC Streaming .

Остановить каракатиц

Остановите виртуальное устройство в том же каталоге, который вы использовали для его запуска:

HOME=$PWD ./bin/stop_cvd