Проверка среды

Быстрый workspace-check:

bash

cd ~/projects/android
scripts/android-doctor.sh
source scripts/android-env.sh
emulator -list-avds

Выполняйте checklist после установки SDK и перед созданием starter-проекта.

Ресурсы

[ ] Свободно не менее 30 ГБ, предпочтительно 50 ГБ.
[ ] Достаточно RAM либо выбран физический телефон вместо эмулятора.
[ ] Рабочая папка находится на локальном SSD.
[ ] Секреты и .env исключены из диагностического вывода.

Toolchain

bash

git --version
node --version
npm --version
codex --version
adb version
sdkmanager --version

[ ] Node.js 22 или новее.
[ ] Android SDK Platform 36 установлен.
[ ] Platform Tools и Build Tools установлены.
[ ] Android Studio использует совместимый bundled JDK.
[ ] Системный Gradle не подменяет Gradle Wrapper.

Device

bash

adb devices -l
emulator -accel-check

[ ] Есть хотя бы одно доступное физическое устройство или AVD.
[ ] На физическом устройстве обновлён Android System WebView/Chrome.
[ ] Debug APK устанавливается и запускается.

Первый проект

bash

npm ci
npm run build
npx cap sync android
cd android
./gradlew --version
./gradlew lint test assembleDebug

[ ] Все команды завершаются с exit code 0.
[ ] Игра запускается после отключения сети.
[ ] В Git нет keystore, service-account JSON, build-кэшей и APK/AAB.