최근에 파이썬으로 프로그램을 만들어보고 있는데, pycharm으로 개발하면서 실행파일로 누구나 사용할 수 있도록 하기 위해 배포하려고 해서 관련 포스팅을 남깁니다.
가장 일반적인 실행파일 생성 방법은 PyInstaller 또는 **cx_Freeze**와 같은 패키지를 사용하는 것입니다. 여기서는 가장 많이 사용되는 **PyInstaller**를 활용하여 파이썬 스크립트를 실행 파일로 만드는 방법을 다루겠습니다.
1. PyInstaller 설치
PyInstaller는 파이썬 스크립트를 단일 실행 파일로 변환해주는 도구입니다. 터미널이나 명령 프롬프트에서 다음 명령어로 설치할 수 있습니다.
(windows : cmd 창)
> pip install pyinstaller
* 혹시라도 pip가 설치되어있지 않다고 할 경우에는, python을 제어판에서 삭제했다가 다시 설치하고, 설치할 때 환경변수 등 관련 체크박스가 해제되어있는 부분을 확인하고 체크해주신 후에 설치하면 pip가 자동으로 설치되게 됩니다. 이후에는 pip를 이용한 install 등 가능하게 됩니다.
2. PyInstaller 사용 방법
설치 후, 파이썬 스크립트를 실행 파일로 변환하려면 터미널 또는 명령 프롬프트에서 다음 명령을 입력합니다:
> pyinstaller --onefile 'test.py'
여기서 'test.py'는 실행 파일로 만들고자 하는 본인의 파이썬 파일 이름입니다.
주요 옵션:
- --onefile: 하나의 실행 파일로 만듭니다. 기본적으로 PyInstaller는 여러 파일을 생성하는데, 이 옵션을 사용하면 단일 파일로 묶어줍니다.
- --noconsole: 프로그램을 콘솔 창 없이 GUI 형태로 실행하고 싶을 때 사용합니다. (GUI 프로그램인 경우에만 유용)
3. 실행 파일 생성 과정
PyInstaller가 실행되면, 다음과 같은 작업을 수행합니다:
- dist/ 폴더에 실행 파일이 생성됩니다.
- build/ 폴더에 빌드와 관련된 파일이 생성됩니다.
- .spec 파일이 생성되며, 이는 빌드 구성을 저장하는 파일입니다.
4. 실행 파일 배포
dist/ 폴더에 생성된 .exe 파일을 다른 사용자에게 배포할 수 있습니다. 배포할 때는 해당 파일만 전달하면 됩니다.
5. 참고 사항
- 윈도우에서 만든 실행 파일은 윈도우에서만 실행 가능하고, macOS 또는 리눅스에서 만들면 그 운영체제에서만 실행 가능합니다. 각 운영체제에서 해당 OS에 맞게 빌드해야 합니다.
- 실행 파일 크기가 커질 수 있으므로 불필요한 패키지는 제외하는 것이 좋습니다. 이를 위해 .spec 파일을 편집할 수 있습니다.
6. 실행 파일로 만들 때 발생할 수 있는 문제 해결
- 외부 모듈이 포함되지 않는 문제: 일부 외부 모듈이 자동으로 포함되지 않을 수 있습니다. 이 경우, hidden-import 옵션을 사용하여 추가합니다.
> pyinstaller --onefile --hidden-import <module_name> 'test.py'
7. PyInstaller 외 다른 도구
- cx_Freeze: PyInstaller와 유사하게 파이썬 스크립트를 실행 파일로 만들 수 있는 도구입니다. GUI 애플리케이션을 제작할 때 주로 사용됩니다.
> pip install cx_Freeze
> cxfreeze your_script.py --target-dir dist
'Programming > Python' 카테고리의 다른 글
Sorting(7) Merge Sort(합병 정렬) (0) | 2016.10.27 |
---|---|
Sorting(6) Heap Sort(힙 정렬 - max heap) (0) | 2016.10.27 |
Sorting(5) Heap Sort(힙 정렬 - min Heap) (0) | 2016.10.27 |
Sorting(4) Selection Sort(선택 정렬) (0) | 2016.10.27 |
Sorting(3) Insertion Sort(삽입 정렬) (0) | 2016.10.27 |
WRITTEN BY