PyQt GUI (13) Pyinstaller를 이용하여 PyQt5파이썬 코드를 exe윈도우 실행 파일로 만들기

지난 포스팅까지 2개의 어플리케이션을 만들었습니다. 

계산기 : https://studyingrabbit.tistory.com/23?category=957111 

PyQt GUI (5) 어플리케이션 만들기 (1) : 100줄만에 계산기 만들기

기억력 게임 : https://studyingrabbit.tistory.com/31

PyQt GUI (12) 어플리케이션 만들기 (2) : 기억력 카드 게임 만들기

이 프로그램을 실행 시키기 위해서는 이 프로그램의 소스 코드를 이용하여 파이썬 인터프리터를 실행시켜주었어야 했습니다. 개발 단계에서는 이렇게 하는것에 아무런 불편함이 없지만, 실제 사용자가 사용하기에는 불편한 점이 매우 많습니다. 따라서 어플리케이션을 다 만들었으면 윈도우에서 바로 실행 시킬 수 있는 완전한 형태의 실행가능한 프로그램 형태를 만들어 주어야 합니다. 

 

PyInstaller를 이용하면 파이썬 소스 코드를 윈도우에서 실행 가능한 exe파일로 만들어 줄 수 있습니다. PyQt로 만든 GU프로그램 뿐 아니라 일반적인 파이썬 프로그램에 적용될 수 있습니다. 

 

(1) PyInstaller 설치 하기

명령 프롬프트 (윈도우에서 cmd로 검색하면 나오는 프로그램)에서 pip install pyinstaller 를 입력 합니다. pip가 정상적으로 실행된다면 pyinstaller가 자동으로 설치 될 것 입니다. 

 

(2) PyQt5 최신 버전으로 업그레이드 하기

 

불필요한 과정일 수 있으나, 이전 버전일 경우에는 pyinstaller 실행시 에러가 날 수 도 있습니다. 

 

(3) Pyinstaller 실행

 

파이썬 소스 코드가 있는 폴더로 이동합니다. 

 

명령 프롬프트에서 pyinstaller --onefile main.py 를 입력 합니다.  --onefile 옵션은 최종 생성물을 하나의 파일로 저장하는 옵션입니다. 보다 자세한 옵션 설명은 https://blog.winterjung.dev/2017/02/23/pyinstaller 페이지를 참고하시기 바랍니다. 

 

(4) 실행 파일 확인하기

 

저장폴더/dist/main.exe 파일로 실행 파일이 생성됩니다. 

 

실제로, 계산기 프로그램을 exe파일로 만든 예시 입니다. 파이썬 프로그램의 이름이 calculator.py 라서 calculator.exe의 이름으로 실행 파일이 생성됩니다. 용량은 35메가 정도 됩니다. 

위 파일을 더블 클릭하여 실행하면, 파이썬 소스 코드를 파이썬 인터프리터를 이용하여 실행했을 때와 동일한 프로그램이 실행됩니다. 

 

(5) 주의 사항

 

파이썬 소스 코드에서 외부 파일이나 이미지를 사용 할 때, 파일의 절대 경로를 입력해야 합니다. 상대 경로를 입력하면 파일을 찾을 수 없다는 에러가 나옵니다.