Первый запуск
1. Запустите шлюз
Заголовок раздела «1. Запустите шлюз»android-emu-webПо умолчанию шлюз слушает 127.0.0.1, порт 7300. Чтобы использовать другой порт, см. Командная строка.
2. Дайте ему проверить ваш Android SDK
Заголовок раздела «2. Дайте ему проверить ваш Android SDK»При запуске шлюз проверяет наличие Android SDK, cmdline-tools, emulator, platform-tools, системного образа system-images;android-34;google_apis;arm64-v8a и хотя бы одного виртуального устройства (AVD). Каждый недостающий элемент он выводит вместе со способом исправления, в таком порядке:
| Чего не хватает | Что делает шлюз |
|---|---|
Android SDK или cmdline-tools |
Выводит страницу загрузки инструментов командной строки Google и каталог, в который их нужно распаковать. Сам он их не скачивает. |
emulator, platform-tools, системный образ |
Выводит команду sdkmanager и примерный размер, затем спрашивает [y/N]. |
| Нет AVD | Предлагает создать устройство по умолчанию с именем emu_web_default (профиль Pixel 5, 4096 MB RAM), затем спрашивает [y/N]. |
Ответ по умолчанию — N. Ничего не скачивается и не создаётся, пока вы не введёте y. Если вы ответите N, шлюз выведет команды, чтобы вы могли выполнить их сами, и продолжит запуск.
Лицензии Android SDK нужно принять до того, как sdkmanager установит пакеты. sdkmanager --licenses показывает их в Терминале, и вы принимаете их сами.
Например, чтобы установить системный образ вручную:
sdkmanager "system-images;android-34;google_apis;arm64-v8a"3. Откройте страницу
Заголовок раздела «3. Откройте страницу»При каждом запуске шлюз создаёт новый случайный токен и открывает браузер по умолчанию по адресу такого вида:
https://droid.devpier.dev/app/#port=7300&token=<token>Порт и токен находятся после #, поэтому браузер не отправляет их на веб-сервер. Страница сохраняет их в браузере и убирает из адресной строки. Если ваш браузер по умолчанию — не Chrome и не Edge, скопируйте адрес из Терминала в Chrome или Edge.
4. Разрешите доступ к локальной сети
Заголовок раздела «4. Разрешите доступ к локальной сети»Когда страница впервые подключается к шлюзу на вашем Mac, Chrome показывает запрос разрешения: может ли droid.devpier.dev получить доступ к вашей локальной сети. Разрешите. Chrome запоминает выбор для этого сайта.
Если вы отказали, см. Устранение неполадок.
5. Работайте с эмулятором
Заголовок раздела «5. Работайте с эмулятором»Если эмулятор с gRPC уже запущен, страница показывает его экран.
Иначе выберите устройство в списке и запустите его. См. Устройства.
Щёлкните по экрану, чтобы передать ему фокус клавиатуры. Затем:
- Щелчок — касание; перетаскивание — свайп.
- Печатайте на клавиатуре Mac. См. Клавиатура и ввод.
- Используйте кнопки «Назад», «Домой» и «Недавние» над экраном.
Остановка
Заголовок раздела «Остановка»Нажмите Ctrl+C в Терминале, где работает шлюз. Запущенные эмуляторы продолжают работать. При следующем запуске шлюз снова подключится к ним.
Локальная резервная страница
Заголовок раздела «Локальная резервная страница»Шлюз также сам отдаёт ту же страницу по адресу http://127.0.0.1:7300/app/ (или на выбранном вами порту). Используйте её, если публичная страница не загружается или не может подключиться.