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 не загружаются из-за неверных путей или первый скрипт падает.

Решение по шагам

1. Подключи телефон по USB, открой на компьютере chrome://inspect и смотри консоль WebView.
2. Если пути начинаются с /, задай base: "./" в настройках сборки, чтобы они стали относительными.
3. Используй hash-роутер или задай androidScheme: "https".
4. После каждой правки делай build и cap sync.
5. Если есть плагин, убедись, что его нативная часть собрана.

Примеры команд

chrome://inspect/#devices
npm run build && npx cap sync android
# vite.config: base: "./"
# capacitor.config: server: { androidScheme: "https" }

Как не повторить

Держи мобильные настройки сборки отдельным профилем и проверяй на телефоне каждый раз.

Автор и лицензия: Nibras Code