Capacitor: белый экран
Текст ошибки
Capacitor app opens to a white screen. Chrome inspect: Failed to load resource: net::ERR_FILE_NOT_FOUND / Uncaught SyntaxError: Unexpected token '<'
Причина
WebView открывает index.html, но JS и CSS не загружаются из-за неверных путей или первый скрипт падает.
Решение по шагам
- Подключи телефон по USB, открой на компьютере
chrome://inspectи смотри консоль WebView. - Если пути начинаются с
/, задайbase: "./"в настройках сборки, чтобы они стали относительными. - Используй hash-роутер или задай
androidScheme: "https". - После каждой правки делай
buildиcap sync. - Если есть плагин, убедись, что его нативная часть собрана.
Примеры команд
chrome://inspect/#devices
npm run build && npx cap sync android
# vite.config: base: "./"
# capacitor.config: server: { androidScheme: "https" }Как не повторить
Держи мобильные настройки сборки отдельным профилем и проверяй на телефоне каждый раз.
Автор и лицензия: Nibras Code
- APK не устанавливается
- Что такое parse error?
- Потерян keystore
- Подписи не совпадают
- Ошибка имени пакета
- Файл APK повреждён
- Play Protect блокирует приложение
- Пакет кажется недействительным
- Не хватает памяти
- Телефон не подходит
- Старая версия не устанавливается
- XAPK не устанавливается
- Gradle sync не удался
- Не удалось разрешить зависимость (Could not resolve)
- Ошибка Duplicate class
- Manifest merger failed
- Лимит dex: 65536 методов
- R8: Missing class
- Несовместимая версия JDK
- SDK location not found
- Конфликт minSdkVersion
- compileSdk слишком низкий
- EAS build: ошибка Gradle
- Ошибка expo prebuild
- Metro: Unable to resolve module
- Hermes: ошибка JS только в release
- Белый экран в release
- Красный экран: нет связи с Metro
- Несовпадение версий Expo SDK
- Ошибка Capacitor sync
- EAS: ошибка keystore и credentials
- Keystore tampered / неверный пароль
- Неверный alias или пароль ключа
- Play: подписано не тем ключом
- INSTALL_FAILED_UPDATE_INCOMPATIBLE
- INSTALL_FAILED_VERSION_DOWNGRADE
- INSTALL_FAILED_INSUFFICIENT_STORAGE
- INSTALL_FAILED_NO_MATCHING_ABIS
- Ошибка разбора пакета (Parse error)
- Ошибка «App not installed»
- Установка AAB-файла на телефон
- adb: устройство «unauthorized»
- adb: устройство не найдено
- Несовпадение версии сервера adb
- Activity class does not exist
- Play: слишком низкий targetSdk
- Play: отклонение по политике разрешений
- Play: требование 64-bit
- Play: versionCode уже использован
- Краш ClassNotFound / NoSuchMethod
- Краш OutOfMemoryError
- CLEARTEXT communication not permitted
- SecurityException: разрешение отклонено