python 실행파일(.exe) 만드는 방법 : PyInstaller

개발을 하다보면 코드 단에서 실행하지 않고 실행 파일(.exe)을 만들어서 간편하게 마우스 클릭만으로 프로그램을 실행해야하는 경우가 있다. 보통 개발자가 아닌 일반 사용자가 프로그램을 사용하는 경우인데, python에는 이를 지원하는 PyInstaller라는 오픈소스 패키징 도구가 있다. PyInstaller를 사용하면 Python 인터프리터와 프로그램의 모든 종속성을 단일 실행 파일로 묶을 수 있다. 이는 사용자가 Python을 사전에 설치하지 않아도 프로그램을 실행할 수 있게 해준다.

 

 

PyInstaller 설치

PyInstaller를 통해서 실행 파일을 만들기위해서는 먼저 PyInstaller를 설치해야 한다. 다음은 PyInstaller 설치 명령어이다.

 

pip install pyinstaller

 

실행파일 만드는법

PyInstaller를 사용해서 실행 파일을 만드는 법은 간단하다. 변환하고자하는 python 스크립트 파일을 작성하고 아래와 같이 명령어를 입력하면 된다. 

 

pyinstaller script.py

 

script.py는 변환하려는 python 스크립트 파일명이다. PyInstaller는 스크립트 파일을 분석하고 해당 파일과 관련된 종속성을 결정하여 실행 파일을 생성한다. 정상적으로 구동되면 다음 사진과 같은 메시지가 뜬다.

실행 파일은 기본적으로 dist 디렉토리에 생성된다. dist 디렉토리를 보면 실제 프로그램에 필요한 다양한 라이브러리와 실행파일(.exe)이 있을 것이다. 실행 파일은 해당 플랫폼에 따라 다른 형식일 수 있다. 

 

PyInstaller는 실행 파일을 생성할 때 여러 가지 옵션을 제공한다. 따라서 원하는 옵션을 주고 실행 파일을 만들면 된다. 몇 가지 유용한 옵션은 다음과 같다.

--onefile: 단일 실행 파일로 생성한다. 실행 파일에 종속성을 내장함. (이 옵션이 없을 시 dist 디렉토리에 많은 파일이 생성된다.)
--noconsole: 실행 파일을 실행할 때 콘솔 창을 표시하지 않는다.
--icon=icon.ico: 실행 파일에 사용할 아이콘 파일을 지정한다.
--name=your_app_name: 생성된 실행 파일의 이름을 지정한다.

 

 

옵션 사용에 대한 예를 들면 다음과 같이 명령어 입력시 옵션을 추가하면 된다.

pyinstaller script.py --onefile --noconsole --icon=icon.ico

 

PyInstaller는 복잡한 프로젝트나 추가적인 요구 사항을 처리하기 위한 고급 기능과 설정도 제공한다. 이를 통해 실행 파일의 외관, 파일 분리, 데이터 파일 포함 등을 세밀하게 제어할 수 있다. PyInstaller와 관련된 더 많은 정보는 https://pyinstaller.org/ 에서 확인할 수 있다.