Python 실행 파일 만드는 방법 - PyInstaller

Python 실행 파일 만드는 방법 - PyInstaller

Python 스크립트를 배포 가능한 실행 파일로 만들기 위해 PyInstaller를 사용하는 방법에 대해 알아보겠습니다. PyInstaller는 Python 애플리케이션을 컴파일하여 하나의 실행 파일로 패키징할 수 있게 도와주는 유용한 도구입니다.

1. PyInstaller 설치하기

PyInstaller를 사용하려면 먼저 설치해야 합니다. 다음 명령어를 사용해 PyInstaller를 설치할 수 있습니다:

pip install pyinstaller

2. 기본적인 실행 파일 만들기

다음 명령어로 Python 스크립트를 실행 파일로 만들 수 있습니다. 여기서는 example.py라는 파일을 예로 들겠습니다:

pyinstaller example.py

위 명령어를 실행하면 PyInstaller는 여러 파일과 폴더를 생성합니다. 그 중 dist 폴더 안에 생성된 실행 파일을 찾을 수 있습니다.

3. 하나의 실행 파일로 만들기

기본적으로 PyInstaller는 여러 파일로 구성된 실행 파일을 생성합니다. 하나의 실행 파일로 패키징하려면 --onefile 옵션을 사용합니다:

pyinstaller --onefile example.py

이 명령을 사용하면 dist 폴더 안에 하나의 파일로 구성된 실행 파일이 생성됩니다.

4. 콘솔 창 없이 실행 파일 만들기

GUI 애플리케이션의 경우 콘솔 창이 뜨지 않도록 설정할 수 있습니다. 이를 위해 --noconsole 옵션을 사용합니다:

pyinstaller --onefile --noconsole example.py

이 옵션을 사용하면 실행 파일을 실행할 때 콘솔 창이 나타나지 않습니다.

5. 추가 파일 포함하기

애플리케이션에서 사용하는 추가 파일(예: 이미지, 데이터 파일 등)을 실행 파일에 포함하려면 --add-data 옵션을 사용할 수 있습니다. 예를 들어 data.txt 파일을 포함하려면 다음과 같이 작성합니다:

pyinstaller --onefile --add-data "data.txt;." example.py

여기서 ;는 Windows에서 사용하며, Linux나 macOS에서는 :를 사용해야 합니다.

6. 실행 파일 최적화하기

PyInstaller로 생성된 실행 파일의 크기가 큰 경우가 많습니다. 이를 줄이기 위해 UPX라는 도구를 사용할 수 있습니다. UPX는 PyInstaller와 함께 사용할 수 있으며, 실행 파일의 크기를 줄이는 데 도움이 됩니다. UPX를 설치한 후 --upx-dir 옵션을 사용해 최적화를 적용할 수 있습니다.

7. 명령어 요약

다음은 자주 사용하는 PyInstaller 명령어의 요약입니다:

• 기본 실행 파일 생성: pyinstaller example.py
• 하나의 실행 파일로 생성: pyinstaller --onefile example.py
• 콘솔 창 없이 생성: pyinstaller --onefile --noconsole example.py
• 추가 파일 포함: pyinstaller --onefile --add-data "data.txt;." example.py

8. 생성된 파일 설명

PyInstaller를 실행하면 다음과 같은 폴더와 파일이 생성됩니다:

• dist/: 생성된 실행 파일이 위치한 폴더
• build/: 빌드 과정에서 생성된 임시 파일들이 위치한 폴더
• .spec 파일: PyInstaller의 설정 파일로, 빌드 과정을 커스터마이징할 때 사용됩니다.

9. 참고 사항

• PyInstaller는 Python 3.5 이상을 지원합니다.
• 타겟 시스템에 Python이 설치되어 있지 않아도 실행 파일을 실행할 수 있도록 패키징됩니다.

PyInstaller를 사용하면 Python 스크립트를 손쉽게 실행 파일로 만들 수 있어, 배포 및 사용에 매우 유용합니다. 위의 방법들을 참고하여 원하는 형태의 실행 파일을 만들어 보세요!