PyInstaller를 사용해 Tkinter Python 앱을 .exe 실행 파일로 만드는 방법

Python은 방대한 확장 라이브러리와 패키지 생태계로 잘 알려져 있습니다. 필요한 패키지를 손쉽게 설치하고 가져와 사용할 수 있죠. 하지만 Windows 운영체제에서 Tkinter 애플리케이션을 별도의 Python 환경 없이 실행하려면, 앱을 네이티브 실행 파일(.exe)로 변환하는 과정이 필요합니다. 이때 가장 널리 쓰이는 도구가 바로 PyInstaller입니다.

PyInstaller는 Python 기반 애플리케이션을 단독으로 실행 가능한 네이티브 실행 파일(.exe)로 변환해 주며, 아래 단계에 따라 Tkinter 애플리케이션을 실행 파일로 컴파일할 수 있습니다.

실행 파일로 변환하는 방법

• 터미널(명령 프롬프트)에서 pip install pyinstaller 명령어로 PyInstaller를 설치합니다.
• 애플리케이션 파일이 있는 디렉터리에서 명령 프롬프트나 셸을 열고 pyinstaller --onefile app.py 명령어를 실행합니다. 그러면 바이너리 및 기타 소스 파일을 포함한 필요한 폴더들이 자동으로 생성됩니다.
• 생성된 dist 폴더로 이동하면 애플리케이션의 실행 파일(.exe)이 들어 있습니다.
• .exe 파일을 실행하여 정상적으로 작동하는지 확인합니다.

예제 코드

app.py

#필요한 라이브러리 임포트
from tkinter import *

#Tkinter 프레임 인스턴스 생성
win = Tk()

#창 크기 설정
win.geometry("750x350")

def display_text():
    Label(win, text= "Hey There! Welcome to TutorialsPoint", font= ('Helvetica 22 bold'), foreground="navy").pack()

#버튼 생성
Button(win, text= "Click Me", font= ('Helvetica 13 bold'), foreground= "OrangeRed3", background= "White", command= display_text).pack(pady=50)
win.mainloop()

실행 결과

컴파일이 완료되면 dist 폴더 안에 .exe 파일이 생성됩니다.

생성된 실행 파일을 실행하면 버튼이 하나 있는 창이 화면에 나타납니다.

"Click Me" 버튼을 클릭하면 같은 창 안에 텍스트 레이블이 표시됩니다.