Python의 PyInstaller 사용법
안녕하세요! 오늘은 Python 스크립트를 독립 실행 파일로 변환해주는 도구인 PyInstaller에 대해 알아보겠습니다. PyInstaller는 Python 프로그램을 컴파일하여 Windows, macOS, Linux 등 다양한 운영 체제에서 실행할 수 있는 독립적인 실행 파일로 만들어줍니다. 이제 PyInstaller의 기본 사용법과 다양한 옵션들을 설명해드리겠습니다.
PyInstaller 기본 사용법
1. 단일 파일 생성하기
가장 기본적인 사용법으로, --onefile 옵션을 사용하면 Python 스크립트를 단일 실행 파일로 패키징할 수 있습니다.
위 명령어는 your_script.py 파일을 단일 실행 파일로 만들어줍니다.
2. 디렉토리 구조로 생성하기
단일 파일이 아닌 디렉토리 구조로 실행 파일을 생성하고 싶다면 아래와 같이 사용하시면 됩니다.
이 명령어는 your_script.py를 실행 파일과 필요한 파일들이 포함된 디렉토리 구조로 패키징합니다.
추가 옵션 사용하기
3. 아이콘 파일 추가하기
프로그램 아이콘을 설정하고 싶다면 --icon 옵션을 사용하시면 됩니다.
위 명령어는 your_icon.ico를 아이콘으로 설정한 단일 실행 파일을 만들어줍니다.
4. 콘솔 없이 GUI 애플리케이션 생성하기
콘솔 창이 나타나지 않도록 GUI 애플리케이션을 생성하려면 --noconsole 옵션을 사용합니다.
이 명령어는 콘솔 창 없이 실행되는 단일 실행 파일을 생성합니다.
5. 추가 파일 포함하기
실행 파일에 추가 파일을 포함하려면 --add-data 옵션을 사용합니다.
위 명령어는 data_file.txt 파일을 실행 파일에 포함합니다. 여기서 콜론 뒤의 점(.)은 포함된 파일이 실행 파일과 동일한 디렉토리에 있음을 나타냅니다.
(Mac, Linux 에서는 : - 콜론, Windows 에서는 ; - 세미콜론 으로 경로를 구분함.)
6. 숨겨진 임포트 처리하기
일부 모듈이 자동으로 탐지되지 않는 경우 --hidden-import 옵션을 사용할 수 있습니다.
이 명령어는 hidden_module을 숨겨진 임포트로 추가합니다.
7. 추가 모듈 경로 지정하기
추가 모듈 경로를 지정하려면 --paths 옵션을 사용합니다.
이 명령어는 추가 모듈 경로를 지정하여 패키징합니다.
배포 시 디렉토리 구조로 생성하기
8. 디렉토리 구조로 생성하기
디렉토리 구조로 생성하려면 --onedir 옵션을 사용합니다.
이 명령어는 your_script.py를 실행 파일과 필요한 파일들이 포함된 디렉토리 구조로 패키징합니다.
특정 Python 버전 사용하기
9. 특정 Python 인터프리터 지정하기
특정 Python 인터프리터를 사용하여 패키징하려면 --python 옵션을 사용합니다.
이 명령어는 지정된 Python 인터프리터를 사용하여 패키징합니다.
이렇게 다양한 PyInstaller 옵션을 사용하여 Python 스크립트를 손쉽게 실행 파일로 변환할 수 있습니다. 각 옵션을 상황에 맞게 조합하여 사용하면 더욱 효율적으로 프로그램을 배포할 수 있습니다. 추가로 PyInstaller의 공식 문서를 참조하시면 더 많은 옵션과 자세한 설명을 확인할 수 있습니다.
감사합니다!