[Python] PyInstaller로 파이썬 스크립트 배포하기

PyInstaller를 사용하면 Python 스크립트를 독립 실행 가능한 실행 파일로 손쉽게 변환할 수 있다.

이번 포스트에서는 PyInstaller의 설치 방법과 주요 옵션들을 다뤄보려 한다.

 

1. PyInstaller란?

PyInstaller(https://pyinstaller.org)는 Python 애플리케이션을 독립 실행 파일로 패키징하는 도구이다.

사용자의 컴퓨터에 Python이나 필요한 라이브러리가 설치되어 있지 않아도 프로그램을 실행할 수 있게 해주어 응용 프로그램을 용이하게 배포할 수 있다.

1.1 주요 기능

• Python 스크립트를 단일 실행 파일 또는 폴더로 패키징
• 필요한 모든 의존성 자동 포함
• 크로스 플랫폼 지원 (Windows, macOS, Linux)
• 외부 파일(이미지, 설정 파일 등) 포함 가능
• 다양한 커스터마이징 옵션 제공

1.2 설치 방법

• pip를 통한 설치

pip install pyinstaller

 

 

2. PyInstaller 사용 방법

기본적인 PyInstaller 사용법은 다음과 같다.

pyinstaller [옵션] 스크립트.py

2-1. 기본 옵션

• 단일 파일 생성 옵션

-F, --onefile : 모든 종속성을 포함한 단일 실행 파일 생성
-D, --onedir : 실행 파일과 종속성 파일들을 폴더로 생성

• 실행 방식 옵션

-w, --windowed, --noconsole : GUI 모드로 실행 (콘솔 창 미표시)
-c, --console, --nowindowed : 콘솔 모드로 실행 (기본값)

 

2-2. 리소스 관련 옵션

• 파일 및 폴더 관리

--add-data "소스;대상" : 외부 파일/폴더 포함
--add-binary "소스;대상" : 바이너리 파일 포함
-i FILE.ico, --icon=FILE.ico : 실행 파일 아이콘 설정

• 모듈 관리

--hidden-import 모듈명 : 자동 감지되지 않는 모듈 포함
--exclude-module 모듈명 : 불필요한 모듈 제외