[Pyinstaller] 파이썬 프로그램 실행파일(.exe) 만들기

 

 

 

안녕하세요!

 

오늘은 Pyinstaller를 통해 파이썬 코드를 실행파일로 변환하는 방법에 대해 알려드리려 합니다.

 

 

먼저,  Pyinstaller 란?

 

  파이썬 코드(.py)를 실행파일(.exe)로 변환 시켜주는 파이썬 패키지입니다.

 

작성한 파이썬 프로그램을 일반 사용자들이 사용하기 쉽게 실행파일로 변경할 때 사용하기 유용한 패키지입니다.

설치 방법과 사용법이 아주 간단하니 잘 활용하시면 좋을듯 합니다.

 

지금부터 방법을 소개해 드리겠습니다.

 

 

1. pyinstaller 설치 

 

: cmd 창을 열어 pip으로 패키지를 설치합니다.

 

pip install pyinstaller

 

 

2. 실행파일 변환

 

: cmd창에서 실행파일로 변환할 파일(test.py)이 있는 폴더로 이동해 아래와 같이 명령어를 입력합니다.

 

pyinstaller test.py

 

위 소개한 방법은 가장 간단한 방법입니다.

따로 import하지 않아도 되어 아주 편리합니다.

 

변환이 완료되면 dist라는 폴더 안에 test.exe 파일이 생성된 것을 확인할 수 있습니다.

다른 위치에서 실행할 때, exe 파일 외에도 dist라는 내에 파일이 필요하기 때문에 폴더 전체를 이동해야 합니다. 

 

하지만 이렇게 생성하게 되면 많은 파일과 함께 생성되고 실행 시 콘솔창이 켜지는 등 문제가 많습니다. 

따라서 여러 옵션을 통해 기본 설정을 변경할 필요가 있습니다. 

 

 

3. 옵션 설정

 

: 옵션을 추가하여 원하는 설정으로 셋팅합니다.

 

-D,-onedir	한개의 폴더로 변환
-F,--onefile	한개의 exe 파일로 변환 (느림)
-n 실행파일명,--name 실행파일명	실행파일명 변경 (default : .py 파일명과 동일)
-c,--console,--nowindowed	콘솔 윈도우 표시 (default)
-w,--windowed,--noconsole	콘솔 윈도우 표시 안함
-i=아이콘경로,--icon=아이콘경로	실행파일 아이콘 설정
--exclude 제외할패키지명	환경에 설치된 패키지 중 실행파일에서 제외하고 싶은 패키지 제외

 

옵션 사용 예시)

pyinstaller -w -F --icon=icon.ico -n test.exe script.py

 

이렇게 생성한다면 icon.ico 모양에 한 test.exe 파일이 생성되고 실행 시 콘솔 표시가 안될 것입니다.

이렇게 옵션도 마스터 했다면 참고 사항에 대해 설명 드리겠습니다. 

 

 

4. 참고 사항

 

pyinstaller로 실행파일을 변환하게 되면, 변환한 PC와 동일한 OS에서만 실행 가능합니다.

따라서 사용할 PC OS 체크는 필수입니다.

 

다음 참고사항은 제가 제일 당황했던 부분인데요.

Anaconda와 사용할 시 conda install로 다운받은 패키지들이 실행파일에 포함되어 크기가 커지고 느려질 수 있습니다.

 

따라서

Anaconda의 가상환경에서 '--exclude 패키지명' 옵션으로 특정 패키지 제외시키시면 됩니다.

(pytorch, pandas, numpy 같은 패키지만 제외해도 용량이 상당히 줄어듭니다.)

 

다만 실행파일 크기를 정말 최소한으로 줄여야하는 상황이라면.. 

Python을 다시 깔고 최소한의 패키지만 깔고 실행파일 변환을 해야합니다..........

 

 

 

 

다들 잘 활용하셨스면 좋겠습니다.

이상으로 포스팅을 마치겠습니다~

 

 

혹시 수정할 내용이 있다면 댓글 부탁드립니다.