빌드 결과물 이해하기
빌드가 끝난 다음에는 어떤 폴더가 어떤 역할을 하는지 이해하는 것이 중요합니다.
파일이 많아 보여도 역할별로 나누면 훨씬 읽기 쉽습니다.
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/나 설치 파일이 있는가?
이 확인이 되면 빌드 흐름은 대체로 건강한 상태입니다.