Skip to content

빌드 결과물 이해하기

빌드가 끝난 다음에는 어떤 폴더가 어떤 역할을 하는지 이해하는 것이 중요합니다.

파일이 많아 보여도 역할별로 나누면 훨씬 읽기 쉽습니다.

1. dist/

이 폴더는 빌드된 렌더러 출력입니다.

즉, 웹 프론트엔드가 배포용으로 정리된 결과라고 보면 됩니다.

2. .frontron/

이 폴더는 Frontron 이 관리하는 staging 공간입니다.

여기에는 예를 들어 아래 같은 것이 들어갑니다.

  • 생성된 bridge 타입
  • staged runtime 파일
  • staged build app 파일
  • runtime manifest

프레임워크가 데스크톱 레이어를 제대로 준비했는지 확인하고 싶다면 이 폴더가 첫 번째 점검 대상입니다.

3. output/

이 폴더는 패키징된 데스크톱 앱이 기록되는 기본 경로입니다.

build.outputDir 를 설정했다면 그 폴더를 보면 됩니다.

Windows 에서는 보통 아래 같은 항목이 생깁니다.

  • win-unpacked/
  • 설치용 .exe

이 폴더는 프로젝트가 실제 데스크톱 앱으로 묶였는지를 가장 직접적으로 보여 줍니다.

4. 파일 이름이 달라질 수 있는 이유

파일 이름은 아래 요소에 따라 바뀔 수 있습니다.

  • 앱 이름
  • 앱 버전
  • 빌드 대상 플랫폼

그래서 처음에는 정확한 파일명보다 파일 역할과 확장자를 먼저 보는 편이 좋습니다.

5. 가장 단순한 성공 체크리스트

처음에는 아래 질문이면 충분합니다.

  • dist/ 가 생겼는가?
  • .frontron/ 가 생겼는가?
  • 패키징 출력 폴더가 생겼는가?
  • 그 폴더 안에 win-unpacked/ 나 설치 파일이 있는가?

이 확인이 되면 빌드 흐름은 대체로 건강한 상태입니다.

MIT 라이선스로 배포됩니다.