PyInstaller로 파이썬 코드를 exe 파일로 빌드하기

파이썬 코드(.py 파일)를 실행하려면 파이썬 인터프리터가 필요합니다. 만약 파이썬이 설치되지 않은 시스템에서 파이썬 프로그램을 실행하려면 어떻게 해야 할까요?

 

이럴 때 PyInstaller를 사용하여 파이썬 코드를 독립 실행 파일(.exe)로 만들어 배포할 수 있습니다. 본 글에서는 PyInstaller를 사용해 파이썬 코드를 윈도우 환경에서 실행 가능한 exe 파일로 만드는 방법에 대해 설명합니다.

 

PyInstaller 설치

파이썬 코드를 윈도우 실행파일로 빌드하기 전에, PyInstaller라는 파이썬 패키지를 설치합니다. 설치는 pip를 이용해 쉽게 설치할 수 있습니다. 명령어는 다음과 같습니다.

pip install --upgrade pip
pip install pyinstaller

 

윈도우 실행파일 생성

PyInstaller를 설치한 후, 간단하게 명령어로 파이썬 파일을 exe로 빌드할 수 있습니다. 예를 들어 main.py 파일이 있을 때, 다음 명령어를 실행합니다.

pyinstaller main.py

 

이 명령어를 실행하면 dist 디렉토리에 main.exe 파일이 생성됩니다. 이 파일은 파이썬이 설치되지 않은 윈도우 시스템에서도 실행할 수 있습니다.

 

PyInstaller 옵션

단일 파일로 만들기

기본적으로 PyInstaller는 exe 파일을 만들 때, 여러 파일과 폴더를 함께 생성됩니다. 만약 단일 exe 파일로 만들고 싶다면 --onefile 옵션을 사용하면 됩니다.

pyinstaller --onefile main.py

 

이 명령어를 사용하면 dist 폴더에 단일 main.exe 파일이 생성됩니다.

 

콘솔 창 숨기기

GUI 애플리케이션의 경우 콘솔 창이 필요없기 때문에, 뜨지 않도록 설정할 수 있습니다. 이때는 --noconsole 옵션을 사용합니다.

pyinstaller --onefile --noconsole main.py

 

이 옵션을 추가하면 프로그램 실행 시 콘솔 창이 나타나지 않습니다.

 

파일 아이콘 변경하기

exe 파일의 아이콘을 변경하고 싶다면 --icon 옵션을 사용합니다. 아이콘 파일은 .ico 형식이어야 합니다.

pyinstaller --onefile --noconsole --icon=myicon.ico main.py

 

 

외부 라이브러리 포함하기

파이썬 코드에서 numpy나 pandas와 같은 외부 라이브러리를 사용했다면, 해당 라이브러리도 exe 파일에 포함되어야 합니다. PyInstaller는 자동으로 대부분의 라이브러리를 포함하지만, 특정 라이브러리는 수동으로 추가해야 할 수도 있습니다. --add-data 옵션을 사용하여 외부 파일을 포함합니다.

 

pyinstaller --onefile --noconsole --add-data "data.txt;." main.py

 

이 명령어는 data.txt 파일을 exe 파일에 포함시킵니다.