Qt Designer 설치하기

개요

오늘은 Qt Designer 설치방법에 대해 설명하고자 합니다.

Qt Designer는 Qt앱 생성시 GUI (Graphic User Interface) 를 쉽게 구성하고 배치하는 것을 도와주는 도구 입니다.

[Qt Designer 실행화면]

C++언어로 Qt를 사용하는 경우는 Qt Creator 설치시 같이 설치되어 바로 사용이 가능하지만 파이썬의 경우 별도 패키지를 설치 후 사용가능합니다.

그럼 파이썬에서 Qt Designer를 설치하는 방법을 살펴보겠습니다.

파이썬 Qt Designer 설치하기

설치 방법은 명령어를 직접 입력해 설치하는 방법과 개발툴 (Visual Studio, PyCharm 등)을 이용해 설치하는 2가지 방법이 있습니다.

개인적으로 명령어를 직접 입력해 설치하는 방법을 더 추천하는데, 그 이유는 특정 개발툴에 얽매일 필요가 없기 때문입니다.

명령어 직접 입력 방법

먼저 명령프롬프트 (또는 Windows PowerShell or Terminal 등) 입력창을 실행합니다.

 

1. Pip 업데이트

python -m pip install --upgrade pip 입력 후 엔터

[Pip 업데이트]

위 명령어는 파이썬 패키지 설치관리자인 PIP를 최신 버전으로 업데이트 합니다.

위 과정은 앱을 설치하기 위해 구글 플레이 스토어 앱을 최신버전으로 업데이트하는 것과 유사한 과정이라고 이해하면 됩니다.

 

만약 이곳에서 아래와 같은 오류가 난다면 Python 미설치 또는 Python이 환경변수 미등록되어 발생하는 문제이므로 환경변수등록부터 진행합니다.

(환경변수 등록은 설치한 앱, 또는 경로를 전역에서 실행가능하도록 해주는 설정)

"OOO은 내부 또는 외부명령, 실행할 수 있는 프로그램, 배치파일이 아닙니다"

 

대처 1 (파이썬 미설치 경우)

파이썬 설치 진행방법

 

대처 2 (파이썬 설치 OK , 환경변수 등록 X)

제어판 -> 시스템 -> 고급시스템 설정 -> 환경변수 -> 새로 만들기

등록1. 파이썬 설치 경로

등록2. 파이썬 설치경로\Scripts

파이썬 설치가 완료 그리고 이후 환경변수 등록이 되었다면 이제 pip 명령실행이 (전역에서) 가능합니다.

 

2. Qt Designer 설치

python -m pip install pyqt5-tools 입력 후 엔터

[pyqt5-tools 패키지 설치]

 

다음과 같이 설치가 진행됩니다.

[pyqt5-tools 설치중]

 

설치 도중 붉은 색 오류가 표시된다면 아래와 같이 명령어를 수정합니다.

python -m pip install pyqt5-tools --user 입력 후 엔터

[pyqt5-tools 설치중]

 

설치가 완료되면 성공적으로 설치가 완료되었다는 메시지가 출력됩니다.

[pyqt5-tools 설치완료]

노란색으로 표시되는 경고 메시지는 너무 신경쓰지 않아도 됩니다.

PyQt5 설치버전, 파이썬 버전, 경로문제 등 환경에 따라 너무 많은 이슈가 존재하므로 설치되었다면 그냥 무시합니다.

제 경우는 파이썬 설치경로를 제가 원하는 곳에 설치해 두었더니 저런 경고 메시지가 출력됩니다.

3. Qt Designer 설치 후 경로 찾기

Qt Designer.exe 파일은 pyqt5-tools 패키지 설치 후 다음과 같은 경로에 위치합니다.

좀 경로가 복잡하니 잘 따라와야 합니다.

(참고로 파이썬이 설치된 경로는 컴퓨터마다 다를 수 있습니다.)

 

일단 파이썬의 모든 외부 패키지 (Pip로 설치한 패키지)  경로는 아래와 같습니다.

• 파이썬 설치경로 / Lib / site-packages
  

즉 아래와 같습니다.

[파이썬 외부패키지 설치 경로]

 

이 아래에 방금 설치한 pyqt5-tools 패키지중 applicaitons 폴더를 찾습니다.

• 파이썬 설치경로 / Lib / site-packages / qt5_applications
  

[pyqt5-tools 설치 경로]

다시 하위 폴더를 찾아서 몇 차례 더  내려갑니다.

• 파이썬 설치경로 / Lib / site-packages / qt5_applications / Qt / bin / designer.exe
  

[Qt Designer 설치 경로]

드디어 Qt Designer 를 만났습니다.

경로를 외우기가 힘드니 Designer.exe 실행파일을 우클릭해 바로가기를 추가해 두고 사용하면 쉽습니다. 

 

파이썬의 다른 외장모듈을 설치하는 방법도 동일합니다.

python -m pip install "외장모듈이름" 입력 후 엔터

예를 들어 pyinstaller를 설치는, 

python -m pip install pyinstaller

라고 진행하면 됩니다.

 

마지막으로 파이썬 외부 패키지가 어떤 것들이 있는지 궁금하다면 PyPI (Python Package Index)를 참조해 외장모듈(파이썬 설치 후 추가 설치) 의 정보를 알 수 있습니다.

내장모듈(파이썬 설치시 같이 설치) 정보는 파이썬 공식사이트의 modules를 참조 바랍니다.

 

Remark. 2024.11.22

Python 3.12 이상 버전과 PyQt6-tools 를 설치하는 도중 호환성 충돌 오류 확인.

Python 3.11버전에 PyQt6-tools 설치시 이상없음을 확인.

(저도 파이썬 최신버전과 외부 모듈과의 잦은 충돌로 3.11 버전을 사용중입니다.)

 

감사합니다.