델파이 단일 실행 파일 생성 (1개 파일로 만들기)

델파이의 가장 큰 장점 중 하나가 바로 "단일 실행 파일(Standalone Executable)" 생성이 매우 쉽다는 점입니다. 별도의 런타임 라이브러리(DLL) 설치 없이 .exe 파일 하나만 복사하면 어디서든 실행되게 만들 수 있습니다.

델파이 12에서 이를 확실하게 설정하는 방법을 정리해 드립니다.

1. 런타임 패키지 설정 해제 (가장 중요)

델파이는 기본적으로 외부 DLL(패키지)을 참조하지 않도록 설정되어 있지만, 간혹 프로젝트 설정이 바뀌어 있을 수 있습니다.

1. Project > Options (Ctrl + Shift + F11)로 들어갑니다.

2. Packages > Runtime Packages 항목을 선택합니다.

3. Link with runtime packages 옵션을 확인합니다.

   • 이 옵션이 False로 되어 있어야 합니다. (True일 경우 vclxxx.bpl 같은 파일이 같이 있어야 실행됩니다.)

2. 정적 링크 설정 (Database 및 외부 라이브러리)

데이터베이스 연결(FireDAC 등)을 사용하는 경우, 특정 드라이버나 리소스를 exe 안에 포함시켜야 합니다.

1. Project > Options > Delphi Compiler > Linking으로 이동합니다.

2. Link with the Delphi Runtime Library (RTL) 옵션이 기본적으로 포함되도록 설정되어 있는지 확인합니다.

3. 만약 외부 리소스(이미지, 사운드 등)를 사용한다면, 파일 형식을 **Resource 파일(.res)**로 만들어 프로젝트에 포함시키면 하나의 exe에 통합됩니다.

   • 메뉴: Project > Resources and Images... 에서 파일을 추가하세요.

3. 배포(Release) 모드로 빌드하기

개발 중인 Debug 모드는 디버깅 정보가 포함되어 파일 용량이 크고 속도가 느릴 수 있습니다. 최종 배포용 파일을 만들 때는 Release 모드를 사용하세요.

1. IDE 오른쪽 상단의 Project Manager 창을 봅니다.

2. Build Configurations 노드를 확장합니다.

3. Release 항목을 마우스 오른쪽 버튼으로 클릭하고 Activate를 선택합니다.

4. 상단 메뉴에서 Project > Build [프로젝트명] 을 실행합니다.

4. 파일 용량 줄이기 (선택 사항)

단일 실행 파일로 만들면 델파이 라이브러리가 모두 포함되어 파일 크기가 다소 커질 수 있습니다(보통 2~10MB 이상).

• 컴파일러 옵션: Project Options > Delphi Compiler > Linking에서 Debug information을 False로 설정하세요.

• UPX 압축: 실행 파일의 크기를 획기적으로 줄이고 싶다면 UPX 같은 실행 파일 압축 도구를 사용하여 exe를 압축할 수 있습니다. (백신에서 오탐할 가능성이 있으니 주의가 필요합니다.)

5. 요약 체크리스트

이렇게 빌드된 결과물은 프로젝트 폴더 내의 .\Win32\Release 또는 .\Win64\Release 폴더 안에서 찾을 수 있습니다.