파이썬 exe파일 만들어서 배포하기 pyinstaller

파이썬 exe파일을 배포하는 시점은 자신이 만든 파이썬 프로그램을 공유하고 싶을 때일 것입니다.

내가 만든 프로그램을 누군가에게 공유하고 싶은데, 내 코드는 보여주기 싫을 때!

상대방이 나와 동일한 파이썬 환경을 구축해야 된다는 점이 마음에 걸릴 때!

여기 해당 문제들에 대한 고민없이
파이썬 파일을 exe파일로 만들어서 손쉽게 배포하는 방법이 있습니다.

---

exe파일 배포하기의 장점

파이썬 파일을 실행 파일로 만들어 배포하는 것은 여러 가지 이점이 있습니다.

주로 이를 위해 사용되는 도구 중 하나는 PyInstaller나 cx_Freeze와 같은 것들이 있습니다.

이러한 도구를 사용하여 파이썬 스크립트를 실행 파일로 변환할 수 있습니다. 이 과정에는 몇 가지 장점이 있습니다.

1. 독립성 확보: 실행 파일로 변환하면 사용자는 별도의 파이썬 인터프리터 설치 없이 프로그램을 실행할 수 있습니다. 이는 사용자에게 편리함을 제공하며 시스템에 파이썬이 설치되어 있지 않더라도 프로그램을 사용할 수 있게 해 줍니다.
2. 컴파일 및 최적화: 실행 파일로 만들면 소스 코드가 컴파일되고 최적화되므로 실행 속도가 향상될 수 있습니다. 또한, 코드를 소스로 노출하지 않으므로 소스 코드의 보안을 강화할 수 있습니다.
3. 배포의 용이성: 실행 파일은 단일 파일이기 때문에 배포가 간편합니다. 사용자는 실행 파일만 다운로드하고 실행하면 되며, 추가적인 설정이나 의존성 관리에 대한 걱정이 줄어듭니다.
4. 사용자 경험 향상: 실행 파일을 제공함으로써 사용자는 명령줄 인터페이스나 터미널 등을 다룰 필요 없이 GUI 애플리케이션 등을 쉽게 실행할 수 있습니다. 사용자가 프로그램을 쉽게 이해하고 사용할 수 있도록 도움이 됩니다.
5. 파일 크기 관리: 실행 파일은 종속성을 포함하므로 사용자가 프로그램을 실행하는 데 필요한 모든 파일이 하나로 묶여 있습니다. 이는 파일 관리를 간편하게 해 주고 사용자에게 불필요한 복잡성을 줄여줍니다.

그중에서도 오늘은 pyinstaller 라이브러리를 이용해서

내가 만든 파이썬 스크립트를 무설치 원클릭으로 실행시켜 주는 exe파일로 만드는 방법에 대해서 알아보겠습니다.

 

Step1. Python Anaconda 환경 구축

파이썬 아나콘다 환경에서 진행할 예정이오니

아직 아나콘다 설치를 안 하신 분들은 아래 포스팅을 참고해서 진행하시면 되겠습니다.

아직 파이썬 아나콘다 환경 구축을 안 했다면?? 👉👉 파이썬 아나콘다 환경 구축하기

VSCode 환경 세팅이 궁금하다면?? 👉👉 VSCode 아나콘다 연동하기

 

Step2. pyinstaller 설치

아나콘다 프롬프트 또는 cmd를 열고

pip install pyinstaller 명령어를 입력해서 pyinstaller를 설치해 줍니다.

 

Step3. pyinstaller로 exe파일 만들기

기본 옵션

pyinstaller 파일명.py

exe파일로 만들고 싶은 py 파일이 있는 위치에서 pyinstaller 파일명.py 를 입력해 주면 exe파일을 만들 수 있습니다.

하지만 여기서 알아야 될 pyinstaller 옵션이 몇 가지 있으니 확인 후 해당 사항에 맞춰 진행하시면 되겠습니다.

하나의 파일로 배포하기

위에 기본 옵션으로 진행할 경우 하나의 폴더로 배포하는 값이 디폴트로 설정되어 있기 때문에

폴더 전체가 한 묶음으로 작동하는 exe파일이 생성됩니다.

pyinstaller --onefile 파일명.py

pyinstaller -F 파일명.py

--onfile 혹은 -F를 붙여서 코드를 입력해 주면 한 개의 독립적인 exe파일로 배포할 수 있습니다.

콘솔창 사용하지 않기

pyinstaller는 디폴트 값으로 콘솔창 사용하기가 자동으로 적용되는데

만약 파일 실행 간 콘솔창이 필요 없다면(코드에 별도의 GUI가 있다면) 다음 옵션을 추가해 주면 되겠습니다.

pyinstaller --noconsole 파일명.py

pyinstaller -w 파일명.py

 

Step4. exe 파일 확인

다음과 같이 pyinstaller 명령어가 종료되면 해당 경로에 dist, buid, spec 파일이 생성되었을 겁니다.

dist 폴더에 들어가면 파이썬 파일을 토대로 생성된 exe파일이 있을 겁니다.

--onefile 옵션을 추가했다면 exe파일을 독립적으로 사용하실 수 있습니다.

 

이상 없이 완료했다면 다음과 같이 exe 파일이 정상적으로 작동하는 것을 확인할 수 있을 겁니다.