| 1. 설치
- 일반 설치
pip install pyinstaller
- 업그레이드
pip install --upgrade pyinstaller
- 개발자 버전 (간혹 일반 버전에서 오류가 발생할 때 개발자 버전에서 정상적으로 해결되는 경우가 있었음)
pip install https://github.com/pyinstaller/pyinstaller/archive/develop.tar.gz
| 2. 기본 사용법
- 기본적으로 변경하려는 .py(여기서는 yourprogram.py)가 있는 경로로 이동해 아래 명령어를 입력하면 됩니다.
pyinstaller yourprogram.py
| 3. 옵션
- 변환 방식
| -D, --onedir | -F, --onefile |
| 1개 폴더로 변환(기본값) | 1개의 exe파일로 변환 (체감상 전자보다 실행속도가 느림) |
- 이름 지정
| -n NAME, --name NAME |
| 변환될 이름 지정, 별도로 지정하지 않을 경우 스크립트 이름을 따라감 (예 : -n 테스트.exe) |
- 콘솔 윈도우 여부
| -c, --console, --nowindowed | -w, --windowed, --noconsole |
| 콘솔 윈도우 표시(기본값) | 콘솔 윈도우 표시 안함 |
- 아이콘 설정
| -i <FILE.ico or FILE.exe,ID or FILE.icns or “NONE”>, --icon <FILE.ico or FILE.exe,ID or FILE.icns or “NONE”> |
| 탐색창에서 보여지는 아이콘을 설정하는 것으로 GUI에서 아이콘을 표시하려면 추가적인 작업이 필요함 |
- 파일추가
| --add-data <SRC;DEST or SRC:DEST> |
| 프로그램 실행시 추가적으로 필요한 파일이 있을 경우 사용 소스파일과 경로 구분자는 윈도우 환경에서는 세미콜론(;), 유닉스 환경에서는 콜론(:)으로 구분한다 함 |
| 3. 예시
E:\study\python_workspace>pyinstaller -F -w --icon=./alphabet_font_icon.ico ppt_FontConverterV02.py
1499 INFO: PyInstaller: 5.8.0
1499 INFO: Python: 3.11.1
2059 INFO: Platform: Windows-10-10.0.19042-SP0
2065 INFO: wrote E:\study\python_workspace\ppt_FontConverterV02.spec
2068 INFO: UPX is not available.
2075 INFO: Extending PYTHONPATH with paths
['E:\\study\\python_workspace']
4825 INFO: checking Analysis
4860 INFO: checking PYZ
4880 INFO: checking PKG
4895 INFO: Bootloader C:\Python311\Lib\site-packages\PyInstaller\bootloader\Windows-64bit-intel\runw.exe
4895 INFO: checking EXE
4897 INFO: Rebuilding EXE-00.toc because ppt_FontConverterV02.exe missing
4901 INFO: Building EXE from EXE-00.toc
4905 INFO: Copying bootloader EXE to E:\study\python_workspace\dist\ppt_FontConverterV02.exe.notanexecutable
4953 INFO: Copying icon to EXE
4954 INFO: Copying icons from ['E:\\study\\python_workspace\\alphabet_font_icon.ico']
4958 INFO: Writing RT_GROUP_ICON 0 resource with 20 bytes
4959 INFO: Writing RT_ICON 1 resource with 7082 bytes
4994 INFO: Copying 0 resources to EXE
4994 INFO: Embedding manifest in EXE
4996 INFO: Updating manifest in E:\study\python_workspace\dist\ppt_FontConverterV02.exe.notanexecutable
4998 INFO: Updating resource type 24 name 1 language 0
5034 INFO: Appending PKG archive to EXE
5140 INFO: Fixing EXE headers
5692 INFO: Building EXE from EXE-00.toc completed successfully.