문제 해결

런타임을 감지하지 못합니다

웹앱이 먼저 정상 빌드되는지 확인한 뒤 dry-run 결과를 봅니다.

npm run build
npx frontron init --dry-run

후보가 여러 개거나 사용자 정의 서버라면 지원 범위에 있는 어댑터를 직접 지정하세요.

Electron 창이 열리지 않습니다

새 스타터는 npm run app, 기존 앱은 npm run frontron:dev를 사용합니다. 웹 개발 서버 명령만 실행하면 Electron 창은 열리지 않습니다.

window.electron이 없습니다

1. Electron 앱 명령으로 실행했는지 확인합니다.
2. 생성된 electron/preload.ts와 src/types/electron.d.ts가 남아 있는지 확인합니다.
3. npx frontron doctor로 manifest와 생성 파일을 검사합니다.
4. 브라우저 미리보기에서는 브리지가 없는 것이 정상입니다.

update가 수정 파일 때문에 중단됩니다

npx frontron update --dry-run

로컬 변경을 보존할지 먼저 결정하세요. 교체가 맞을 때만 --force --yes를 사용합니다.

패키징 결과가 실행되지 않습니다

개발 서버가 켜진 상태가 아니라 실제 패키징 결과만으로 재현합니다. 웹 빌드 산출물, 선택된 어댑터, 외부 리소스 의존성과 운영체제 보안 경고를 차례대로 확인하세요.