Устранение неполадок

Chrome заблокировал доступ к локальной сети

Страница на droid.devpier.dev подключается к шлюзу на вашем собственном Mac. В первый раз Chrome запрашивает разрешение. Если вы отказали, страница не может подключиться и после нескольких неудачных попыток сообщает, что Chrome заблокировал доступ к вашему Mac.

Чтобы снова разрешить доступ:

1. Откройте в Chrome Настройки → Конфиденциальность и безопасность → Настройки сайтов.
2. Найдите droid.devpier.dev и разрешите доступ к локальной сети.
3. Перезагрузите страницу.

Если подключиться всё равно не удаётся, используйте локальную резервную страницу.

Порт уже занят

По умолчанию шлюз слушает порт 7300. Если этот порт уже использует другая программа, шлюз не может запуститься на нём. Найдите эту программу:

lsof -nP -iTCP:7300 -sTCP:LISTEN

Остановите её или запустите шлюз на другом порту:

android-emu-web --port 7301

Шлюз подставляет новый порт в открываемый адрес, поэтому страница подключается к нужному порту.

Эмулятор не найден

Если страница сообщает, что запущенный эмулятор не найден:

• Проверьте, что эмулятор запущен: adb devices должен показать emulator-5554 или что-то похожее.
• Проверьте, что он запущен с включённым gRPC (-grpc <port>). Шлюз не может читать экран эмулятора без gRPC.

Вы также можете запустить устройство из списка на странице. См. Устройства.

Если эмулятор не найден, шлюз продолжает работать и выводит причину в Терминале.

Если шлюз сообщает, что не хватает Android SDK, emulator, platform-tools или системного образа, выполните исправление, которое он выводит. См. Первый запуск.

Нет «sdkmanager»

SDK, установленный Android Studio, может не содержать cmdline-tools, которые предоставляют sdkmanager и avdmanager. Шлюз их не скачивает. Скачайте инструменты командной строки Google с developer.android.com и распакуйте их так, чтобы существовал этот путь:

<your SDK>/cmdline-tools/latest/bin/sdkmanager

Срок действия токена истёк

При каждом запуске шлюз создаёт новый токен. Если вы перезапустите шлюз, страница со старым токеном сообщит, что токен больше не действителен, и перестанет повторять попытки. Откройте новую ссылку, которую вывел шлюз, или снова запустите шлюз.

Страница сообщает, что шлюз или страница устарели

• Шлюз устарел: выполните команду обновления, которую показывает страница. Это та же команда установки.
• Страница устарела: принудительно перезагрузите страницу с помощью Cmd+Shift+R.

Неподходящий браузер

Страница работает только в Chrome и Edge. В других браузерах она просит переключиться и не пытается подключиться. См. Поддержка браузеров.

Используйте локальную резервную страницу

Шлюз отдаёт ту же страницу по адресу http://127.0.0.1:7300/app/ (или на выбранном вами порту). Используйте её, когда публичная страница не загружается или доступ к локальной сети был запрещён.

Экран перестаёт обновляться

Если эмулятор завершается или перезапускается, страница показывает, что соединение потеряно. Шлюз продолжает работать. Когда эмулятор возвращается, страница переподключается, и экран снова появляется.