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

파이썬으로 스크립트를 작성은 했는데, 해당 프로그램을 할 때마다 켜서 실행은 할 수 없기 때문에,

실행파일인. exe 파일로 변환을 하면, 파이썬이 설치되어 있지 않은 컴퓨터에서도 해당 프로그램을 실행할 수 있습니다.

이때 사용할 도구는 PyInstaller 입니다.

 

---

1. PyInstaller 설치하기

먼저, 실행 파일을 생성하는 데 필요한 PyInstaller를 설치해야 합니다. 아래 명령어를 실행하세요:

pip install pyinstaller

💡 pip는 Python 패키지 매니저로, 명령어 입력 전 Python이 설치되어 있는지 확인하세요.

 

---

2. PyInstaller로 실행 파일 생성하기

PyInstaller를 사용하여 Python 코드를 exe 파일로 변환합니다. 터미널에서 아래 명령어를 실행하세요:

pyinstaller --onefile hello.py

 

옵션 설명

• --onefile: 모든 파일을 단일 exe 파일로 합칩니다.

명령어를 실행하면 dist 폴더 안에 hello.exe라는 파일이 생성됩니다.

---

 

3. 추가 옵션 활용하기

PyInstaller는 다양한 옵션을 제공하므로, 프로젝트에 맞게 커스터마이징 할 수 있습니다.

GUI 프로그램으로 만들기

콘솔 창이 나타나지 않도록 하려면 --noconsole 옵션을 추가합니다:

pyinstaller --onefile --noconsole hello.py

아이콘 추가하기

exe 파일에 아이콘을 추가하려면 --icon 옵션을 사용하세요. 예를 들어, app.ico라는 아이콘 파일을 추가하려면:

pyinstaller --onefile --icon=app.ico hello.py

💡 아이콘 파일은 반드시. ico 형식이어야 합니다.

 ** 추가 주요 옵션 정리

• --onefile: 단일 실행 파일로 생성합니다.
• --noconsole: 콘솔 창을 숨기고 GUI 애플리케이션으로 만듭니다.
• --icon=<icon_path>: 실행 파일에 아이콘을 추가합니다. 아이콘은 반드시 .ico 형식이어야 합니다.
• --name=<name>: 생성될 실행 파일의 이름을 지정합니다.
• --add-data <src;dest>: 외부 파일(데이터 파일 등)을 포함합니다. 경로는 세미콜론(;)으로 구분합니다.
  • 예: --add-data "data.txt;data"
• --hidden-import=<module>: PyInstaller가 자동으로 감지하지 못하는 모듈을 수동으로 추가합니다.
• --clean: 이전에 생성된 빌드 파일을 삭제하고 새로 빌드합니다.
• --debug: 디버깅 정보를 포함하여 빌드합니다.
• --upx-dir=<dir>: UPX(실행 파일 압축 도구)의 경로를 지정합니다.

 

---

4. 실행 파일 확인하기

위 과정이 완료되면 dist 폴더 안에 생성된 exe 파일을 확인할 수 있습니다. 이 파일은 Python이 설치되지 않은 Windows 환경에서도 실행할 수 있습니다.

---

6. 유용한 팁

• 실행 파일 크기 줄이기: UPX와 같은 압축 도구를 사용하여 파일 크기를 줄일 수 있습니다.
• 호환성 테스트: 다른 컴퓨터에서 실행 파일을 테스트하여 외부 라이브러리나 환경과의 호환성을 확인하세요.