Тесты гоняются на debug-APK + Metro (JS грузится из бандлера, не из APK), проверено на Maestro 2.6.1; сценарии с контентом и авторизацией выполняются против stage-бэкенда
Предусловия
- macOS, Android SDK и эмулятор — подойдёт любой профиль; тесты верифицированы на Pixel_6_Pro
- Node.js, пакетный менеджер
bun - Доступ к репозиторию
vibe-mobile - Установленный Maestro:
curl -Ls "https://get.maestro.mobile.dev" | bash
Пошагово
# 1. Зависимости и debug-APK
cd vibe-mobile
bun install
./gradlew assembleDebug # артефакт: android/app/build/outputs/apk/debug/app-debug.apk
# 2. Эмулятор + установка
emulator -avd Pixel_6_Pro &
adb install -r android/app/build/outputs/apk/debug/app-debug.apk
# 3. Metro + проброс порта
npx react-native start &
adb reverse tcp:8081 tcp:8081
# прогреть бандлер: открыть http://localhost:8081/index.bundle — до появления бандла < 10 c
# 4. Тесты
maestro test .maestro/Локальный .env для E2E-прогона (обязателен)
Файл .env в корне vibe-mobile (в .gitignore). Минимум для E2E:
VIBE_APPMETRICA_API_KEY=<любой UUID-плейсхолдер> # иначе red box "AppMetrica isn't initialized"
VIBE_VERSION=0.0.0-e2e
VIBE_E2E=true # отключает LogBox-тост, перекрывающий кнопкиПосле правок .env — перезапуск Metro с --reset-cache.
Фильтрация прогона
maestro test .maestro/ # полная регрессия
maestro test .maestro/auth/auth-login-empty-state.yaml # один файл
maestro test .maestro/ --include-tags=smoke # быстрый smoke-гейт
maestro test .maestro/ --include-tags=feed # только домен «Лента»
maestro test .maestro/ --exclude-tags=backend # без stage-зависимых тестов--exclude-tags=backend — режим «нет доступа к stage», а не «нестабильные тесты»: большинство backend-флоу стабильно проходят на stage. Набор тегов и их семантика — в Структура сьюта.
CI
Автотесты запускаются локально (см. выше). Workflow e2e.yml для Maestro в CI существует, но приостановлен: на github-hosted раннере (2 vCPU / 7 ГБ) эмулятор нестабилен — ANR «System UI isn’t responding» гостевой ОС, к самим тестам отношения не имеющий. Сборка APK в CI при этом стабильна. Запуск — только вручную (workflow_dispatch, нужен секрет VIBE_APPMETRICA_API_KEY). Открытый вопрос: более мощный или self-hosted раннер. Полная история попыток и анализ — docs/ci-proposal.md в репозитории
Практические грабли
- Окно эмулятора должно быть развёрнуто на экране — свёрнутое окно не даёт прогону стартовать и даёт ложные «Element not found» (экран не перерисовывается)
- Кириллица не вводится через
inputTextна Android (ограничение Maestro, mobile-dev-inc/maestro#146) — в тестовых данных использовать ASCII (rock) hideKeyboardна Android = системная кнопка «Назад»: на экране логина уводит назад на профиль, на корне таб-навигатора — выгружает приложение на домашний экран. В тестах не применяется: клавиатура закрывается тапом по другому элементу- Runtime-разрешения:
launchAppгрантует их не всегда успевая — для флоу сclearState: true, ведущих к экрану с запросом permission, ставить явноsetPermissions: { permissions: { notifications: allow } } - Холодный Metro после смены
.envломает прогон на онбординге, пока бандлер не прогрет — первым шагом полного прогона всегда ждём первый bundle (таймаут до 90 с)