파인썬으로 작성된 .py 파일을 파이썬이 설치되어 있지 않거나 다른 누군가에게 파일을 공유하려고 할 때, 혹은 GUI 프로그램을 독립적으로 실행하려면 파이썬 파일을 변환 시켜주어야 한다.
예를 들면 파이썬 파일로 작성된 GUI 계산기 프로그램이 있다고 하자.

이 파일을 Visual Sutudio Code 에서 실행하면 다음과 같이 GUI 파일이 실행될 것이다.

하지만 우리는 계산기를 VS 프로그램이 없이 독립적으로 전자계산기를 실행시켜야 한다. 이를 위해서는 calculator_GUI.py 파일을 앱 형식의 실행 파일로 변환시켜주어야 한다.
파이썬 스크립트를 실행 파일로 만들기 위한 도구는 'PyInstaller'이다. 이 도구는 Python 스크립트를 독립 실행 파일로 패키징 할 수 있어 파이썬이 설치되지 않은 시스템에서도 실행할 수 있다.
파일 변환 :
1. PyInstaller 설치
먼저 'PyInstaller'를 설치해야 한다.
터미널에서 다음과 같이 명령어를 입력하여 Pyinstaller를 설치하여 준다.

2. 스크립트를 실행 파일로 변환
터미널이나 명령 프롬프트에서 다음 명령어를 실행하여 Python 스크립트를 실행 파일로 변환할 수 있다.
파일 변환하기 전에 바탕화면에 간편 계산기라는 폴더를 하나 만들고 여기에 calculator_GUI.py 파일을 저장한다.
![]() |
![]() |
간편 계산기 폴더 만들기 | 폴더 안 파이썬 파일 |
현재 상태에서 보면 간편 계산기라는 폴더안에는 calculator_GUI.py 라는 파일 하나만 있는 것을 볼 수 있다.
다음 VS 코드상에서 파일을 실행시킨 터미널에서 다음 명령어를 입력한다.

그러면 간편 계산기 폴더안에 build, dist라는 파일이 생겨난것을 볼 수 있다.


위 명령어는 다음 작업을 수행한다.
1) '--onefile' : 모든 파일을 하나의 실행 파일로 만든다.
2) '--window' : 콘솔 창 없이 GUI만 표시되도록 한다.
3) 'calculator_GUI.py' : python 스크립트 파일 이름이다. 해당 이름을 자신이 작성한 스크립트 이름으로 대체하면 된다.
3. 결과물 확인
dist 폴더안에 실행 가능한 파일이 생성된 것을 볼 수 있다. 이 파일을 클릭하면 계산기 프로그램이 실행된다.
![]() |
![]() |
dist 폴더안 실행파일 |
이제 Python 계산기를 독립 실행 파일로 변환하여 다른 사람들과 공유하거나 파이썬이 설치되지 않은 컴퓨터에서 사용할 수 있다.
'파이썬 GUI' 카테고리의 다른 글
파이썬 GUI로 간단한 전자계산기 만들기 (0) | 2024.08.10 |
---|---|
(파이썬 GUI) 캔버스 위젯 사용법 (0) | 2024.01.15 |
(파이썬 GUI) GUI에 프로그레스바 추가하기 (0) | 2024.01.08 |
(파이썬 GUI) 정보, 경고, 에러 메시지박스 생성하기 (0) | 2024.01.03 |
(파이썬 GUI) 탭 위젯 만들기 (0) | 2024.01.02 |