파이썬 pyqt5 설치 Qt Designer 사용법 및 ui py 파일 변환

파이썬 pyqt5 설치 Qt Designer 사용법 및 ui py 파일 변환

---

pyqt5는 Tkinter에 비해서 다소 어려운 부분이 있긴 하지만 알아둔다면 gui를 구성하는데 정말 유용한 라이브러리입니다. pyqt5는 Python 프로그램용 GUI 툴킷이며 개발자들이 GUI를 만들 수 있도록 수천 개의 클래스를 제공합니다. 특히 QT Designer라는 툴을 추가적으로 제공을 하여 보다 간편하게 gui를 만들 수 있습니다. 버튼, 메뉴, 목록, 탭 및 기타 유용한 구성 요소를 포함하여 미리 추가되어 있기 때문에 처음에 gui를 구성하는 기초 뼈대를 생성하는데 많은 도움이 됩니다.

먼저 pyqt5와 QT Designer를 사용하기 전에 설치가 우선이겠죠. 터미널에서 아래 두 개 명령어를 입력하여 pyqt5와 pyside2를 설치합니다.

pip install pyqt5
pip install pyside2

정상적으로 설치가 되었다면 파이썬이 설치된 디렉토리에서 Lib\site-packages\PySide2로 들어갑니다. 생성된 PySide2 디렉토리 내부에 designer.exe 파일을 볼 수 있습니다. 해당 프로그램이 Qt Designer 실행파일입니다.

Qt Designer를 실행하면 위와 같은 툴이 열립니다. 백지 ui를 선택하고 생성을 하고 좌측에 있는 여러 기능들을 사용하여 테스트 ui를 만들어 봅니다. 기능을 가져올 때는 드래그 앤 드롭 형태로 사용을 할 수 있습니다. 기존에 Qt Designer 없이 직접 코드로 pyqt5를 작성했던 분들이라면 Qt Designer가 아주 편리한 툴이라는 것을 알 수 있습니다.

테스트 ui를 만들고 저장을 해줍니다.

저장된 Qt Designer 파일은 ui 확장자로 저장이 되는데 이 파일을 파이썬에서 실행하기 위해서는 py파일로 변환이 필요합니다.

터미널에서 ui파일이 저장된 디렉토리로 이동 후 python -m PyQt5.uic.pyuic -x test.ui -o test.py 형식으로 명령어를 입력합니다. test.ui에서 test.py로 변환을 하는 예시입니다.

명령어를 입력하면 기존 ui파일이 있던 디렉토리에 py파일이 생성된 것을 볼 수 있습니다.

변환된 test.py 파일을 열어보면 정상적으로 ui파일이 파이썬 코드로 변환된 것을 볼 수 있습니다. 변환 후 바로 사용을 해도 되긴 하지만 개인적으로 가독성 부분이 별로 좋지 않아 조금 손을 봐주고 코드를 사용하는 편입니다. 어쨌든 Qt Designer를 사용하는 결정적인 이유는 최초 gui 디자인을 구성할 때 직접 코드로 작성을 한다면 시간이 오래 걸리기 때문에 처음 뼈대를 생성할 때 Qt Designer를 사용하고 이후에 수정 부분만 직접 코드로 변환해서 작업을 해주고 있습니다.

실행 시 기존에 만들었던 테스트 gui가 정상적으로 뜨는 것을 볼 수 있습니다. 기존에 gui 뼈대를 설계하는데 어려움을 겪고 계셨던 분들이 있다면 pyqt5의 기본적인 사용법을 배우고 Qt Designer를 활용하는 것을 추천합니다.