파이썬(Python) 작성한 코드를 실행파일(exe) 파일로 내보내는 방법 - Windows 환경에서 기본 콘솔 사용하기

 

Py 파일을 exe로 만들기

 

파이썬(python)은 직관적이고 개발하는 속도가 빠른 언어로 알려져 있습니다.

개발자가 사용할 때는 어떻게 되도 좋지만 배포하기 위해서는 실행파일로 만들 필요가 있습니다.

오늘을 Windows 환경에서 콘솔을 사용해서 실행파일(exe)로 내보내는 방법을 알아보겠습니다.

 

 

 

1. 파이썬(python)이 설치된 환경이여야 합니다.

 

너무 당연한 말부터 시작하나요? 파이썬 코드는 사실 여기저기서 만들고 실행할 수 경우가 많습니다.

그래서 설치하지 않고 개발하는 것도 가능하기 때문에 우선 이걸 받아야 한다는 이야기를 드립니다.

아래 홈페이지에 다운 받을 수 있습니다.

 

https://www.python.org/

Welcome to Python.org

 

 

 

 

2. Windows의 콘솔창을 열고 설치가 잘 되었는지 확인

 

Windows 환경에서 명령어를 실행하기 위해 콘솔창에서 작업을 하겠습니다.

콘솔창 열기 가장 쉬운 방법은 단축키 [windows key] + [R]을 누르고 "CMD"를 입력하는 것입니다.

파이썬(python)이 설치가 되었다면, 아래 명령어를 사용해서 설치여부를 확인합니다.

 

• python --version : 버전을 확인하는 명령어
• pip --version : pip의 설치경로와 버전을 확인하는 명령어

 

잘 설치가 되지 않았다면 명령어에 응답하지 않거나 오류메시지를 출력합니다.

응답하면 이걸 신호로 해서 아래 작업을 계속 진행해도 되겠습니다.

 

잘 설치가 된 파일

 

 

 

 

3. pip을 최신화합니다.

 

pip은 Python의 패키지 관리자로, PyPI에서 패키지를 다운로드하고 관리하는 역할을 합니다

위에서 pip이 설치가 있다는 것을 지장없이 확인했습니다.

하지만 한번 더 다운로드 받아서 최신화하는 것도 좋습니다.

 

콘솔창에 "pip install pyinstaller pip" 명령어를 입력하면 확인합니다.

추가 버전이 확인되면 "python.exe -m pip install --upgrade pip" 명령어로 업그래이드합니다.

(원하지 않으면 안해도 됩니다. 24.3.1 버전으로도 오늘 작업은 할 수 있습니다.)

 

설치 과정입니다.

 

 

 

4. 실행파일로 만듭니다.

 

오늘의 목적인 실행파일을 만들어 보겠습니다.

콘솔창에서 파이썬 코드 파일이 있는 폴더로 이동합니다.(cd 경로명)

.py 파일로 저장해 두었습니다.

명령어 "pyinstaller --onefile --windowed 파일명.py"를 입력하면 실행합니다.

windows 인터페이스에서 동일 폴더에 dist라는 폴더가 만들어지고 그 안에 실행파일이 있을 껍니다.

 

만들기

 

 

320x100

 

 

 

5. 실행파일이 안될 때 

 

문제는 이 실행파일이 아마 실행이 안되는 경우가 너무 많다는 것입니다.

대표적인 경우만 해도 아래 것들이 있는데요

 

• PyInstaller가 자동으로 라이브러리를 포함하지 못하는 경우 : hidden-import 옵션으로 활용하기
• 외부파일을 참고하고 있을 때 경로명이 정확하지 않는 경우
• 외부 실행파일을 동작시킬 때 참고오류(경로명이나 호출오류 등등)
• 코드가 잘못 짜져있어서 디버그 오류가 날때
• 그렇다고 외부, 자동 라이브러리를 모두 포함해서 메모리가 감당 못할때

 

이게 정말 머리아픈게 각각이 코딩한 소스에 따라서 외부파일이 다르고 참고방식이 다릅니다.

그에 따라 해결방법이 다 다르기 때문에 결국 이 부분은 그때그때 내용을 파서 해결해야 합니다.

어떤 경우에는 수학 알고리즘 만들고, 코딩하고 정리했는데 배포파일 만드는게 더 시간이 오래걸리기도 합니다.

혹시 가능한 사례가 생기면 다음 기회에 소개드리도록 하겠습니다.