파이썬은 뛰어난 가독성과 유연성 덕분에 많은 개발자들이 선호하는 프로그래밍 언어입니다. 종종 배포를 편리하게 하기 위해, 실행파일(.exe)을 필요로 하는 경우가 있습니다.
이 글에서는 PyInstaller 패키지를 이용해서 파이썬 코드를 실행파일로 만드는 방법과 주의사항에 대해 알아보겠습니다.
실행파일 필요성
파이썬은 인터프리터 언어로, 코드를 직접 실행하려면 파이썬 인터프리터가 필요합니다. 하지만 파이썬 코드를 실행파일(exe)로 변환함으로써 파이썬 설치가 돼 있지 않은 환경에서도 프로그램을 실행할 수 있습니다. 특히 비개발자나 파이썬 환경을 설정하기 어려운 사용자에게 파이썬 프로그램을 쉽게 배포할 수 있습니다.
실행파일로 만들어진 프로그램은 코드가 컴파일돼 있기 때문에 코드를 보호하는 데에도 도움이 됩니다. 이를 통해 사용자가 코드 내용을 직접 수정하거나 확인하는 것을 방지할 수 있습니다. 그래서 배포 프로그램 안정성과 신뢰성을 유지하기 위한 방법으로도 사용됩니다.
정리하면 파이썬을 모르는 사람에게 코드를 배포하기 위해서는 파이썬 설치나 코드를 실행하는 과정이 없는 실행파일로 만드는 일이 중요합니다.
PyInstaller 설치 및 기본 사용법
PyInstaller는 파이썬 코드를 실행파일로 변환하는 강력한 도구입니다. 이를 사용하면 파이썬 인터프리터가 없는 환경에서도 파이썬 프로그램을 실행할 수 있습니다. PyInstaller를 사용하려면 먼저 패키지를 설치해야 합니다. PyPI에 등록돼 있기 때문에 pip명령어를 사용해 설치할 수 있습니다.
pip install pyinstaller
설치가 완료됐다면 간단한 파이썬 스크립트를 실행파일로 변환해보세요. 변환하려는 스크립트 이름이 example.py라고 가정하겠습니다. 보통 하나의 실행파일을로 만드는 방법을 많이 사용합니다. 아래와 같이 pyinstaller 명령을 윈도우는 명령 프롬프트, 맥북은 터미널에서 실행합니다.
pyinstaller --onefile example.py
위 명령어를 실행하면 dist 폴더 안에 example.exe 파일이 생성됩니다. 여기서 –onefile 옵션은 모든 파일을 한 개의 실행 파일로 압축하라는 의미입니다. 이렇게 생성된 실행파일은 다른 라이브러리나 파일 없이도 독립적으로 실행됩니다.
기본 사용법 외에도 PyInstaller는 다양한 옵션을 제공해 더 복잡한 애플리케이션도 처리할 수 있습니다. 어떤 옵션이 있는지 아래에서 자세히 알아보겠습니다.
PyInstaller 고급 옵션
PyInstaller는 여러 고급 옵션을 제공해 사용자가 원하는 형태로 더 정교하게 실행파일을 만들 수 있습니다. 많이 사용되는 옵션은 무엇이 있는지 알아봤습니다.
- -F: 단일 파일로 모든 스크립트를 패키징합니다. 이렇게 생성된 단일 파일은 다른 파일들로 구성된 디렉토리가 아닌 하나의 독립적인 실행파일로 만들어집니다. 따라서, 배포가 간편해집니다.
- –icon=
옵션: 특정 아이콘 파일(.ico)을 실행파일에 통합합니다. 이를 통해 사용자들에게 더 친숙하고 브랜드화된 프로그램으로 제공합니다. - –add-data 옵션: 외부 데이터 파일이나 추가 리소스를 포함시킬 때 유용. 예를 들어, 이미지나 설정 파일 등이 프로그램 실행에 필요할 경우, 해당 파일들을 실행파일에 포함시켜 배포할 수 있습니다.
- –hidden-import 옵션: PyInstaller가 자동으로 검색하지 못하는 모듈을 명시적으로 포함시킬 수 있습니다. 주로 동적으로 로드되거나 설치된 일부 모듈이 인식되지 않는 경우에 사용됩니다.
- –noconsole 옵션: GUI 앱 개발 시 콘솔 창을 숨기는데 사용. 이는 주로 배포용 GUI 애플리케이션에서 필요 없는 명령 프롬프트 창이 나타나지 않도록 하는 데 유용합니다.
이와 같은 다양한 고급 옵션들을 적절히 활용하면 더욱 효율적이고 사용자 친화적인 실행파일을 생성할 수 있습니다. 더 다양한 옵션은 Pyinstaller 사이트에서 확인할 수 있습니다.
실행파일 제작 시 주의할 점
파이썬으로 작성된 프로그램을 실행파일로 만들 때에는 몇 가지 주의할 점이 있습니다. 먼저, 사용하는 파이썬 버전과 PyInstaller 버전이 호환되는지 확인해야 합니다. 불일치가 발생할 경우 실행파일 생성 중 오류가 발생할 수 있으며, 심지어는 작성된 실행파일이 정상적으로 작동하지 않는 상황이 발생할 수도 있습니다.
실행 파일 크기를 관리해야 합니다. 파이썬 프로그램이 복잡할수록 실행 파일의 크기가 증가할 수 있습니다. PyInstaller의 –onefile 옵션을 사용하면 모든 패키지를 단일 파일로 결합할 수 있어 사용자에게 배포할 때 보다 간편합니다. 그러나, 필요 없는 모듈을 포함되지 않도록 설정함으로써 파일 크기를 줄이는 게 좋습니다.
파이썬 실행파일을 만드는 일은 복잡해 보일 수 있지만, PyInstaller를 이용하면 비교적 쉽게 해결할 수 있습니다. 파이썬 프로그램을 실행파일로 변환하고, 배포하는 기본 방법과 주의사항을 알아봤습니다. 여러 사용자에게 프로그램을 배포하고 싶을 때, 이 방법을 활용해 보세요.
함께 읽으면 좋은 글
- 초보자도 쉽게 하는 파이썬 GUI 개발 AI로 하는 방법
- 프로젝트 아스트라, 제미나이 2.0 기반 AI 비서 알아보기
- 구글에서 만든 웹 자동화 에이전트, 프로젝트 마리너 알아보기
- 파이썬 데이터 분석 도서 추천, 월 20달러로 고용하는 데이터 분석가 with 챗GPT