Qt Creartor 설치 및 초기 실습

Qt Creator + PySide6 설치 및 실행 과정

Ubuntu 환경에서 Qt Creator를 설치하고, PySide6 프로젝트를 실행하는 과정이다. PySide6는 Python으로 Qt GUI 프로그램을

만들 수 있게 해주는 라이브러리이다.

 

1. 패키지 업데이트

sudo apt update

2. 개발 도구 설치

sudo apt install -y build-essential cmake ninja-build git

3. Python 가상환경 관련 패키지 설치

sudo apt install -y \
  libgl1-mesa-dev libglu1-mesa-dev \
  libfontconfig1-dev libfreetype6-dev libgtk-3-dev \
  libx11-dev libx11-xcb-dev libxext-dev libxfixes-dev libxi-dev libxrender-dev \
  libxcb1-dev libxcb-cursor-dev libxcb-glx0-dev libxcb-icccm4-dev \
  libxcb-image0-dev libxcb-keysyms1-dev libxcb-randr0-dev libxcb-render-util0-dev \
  libxcb-shape0-dev libxcb-shm0-dev libxcb-sync-dev libxcb-util-dev \
  libxcb-xfixes0-dev libxcb-xinerama0-dev libxcb-xkb-dev \
  libxkbcommon-dev libxkbcommon-x11-dev

4. Qt Creator 설치 파일 다운로드

https://download.qt.io/official_releases/online_installers/

Index of /official_releases/online_installers

 

Qt 공식 홈페이지에서 Linux용 Qt Online Installer를 다운로드한다. 다운로드가 완료되면 다운로드 폴더로 이동한다.

cd ~/다운로드

5. 설치 파일 실행 권한 부여

ls -tlr

 

chmod +x qt-online-installer-linux-x64-4.11.0.run

6. Qt Online Installer 실행

./qt-online-installer-linux-x64-online.run --mirror http://ftp.jaist.ac.jp/pub/qtproject

설치 창이 열리면 로그인 후 Qt Creator와 필요한 구성 요소를 선택하여 설치한다.

(서버는 한국서버가 없어서 가까운 국가의 서버로 지정한다)

7. Qt Creator 실행

설치가 완료되면 Qt Creator를 실행한다.

8. PySide6 프로젝트 생성

File → New Project → Application → Qt for Python

PySide Widgets Project를 선택하여 새 프로젝트를 생성한다.

9. 프로젝트 기본 파일 구조

프로젝트 폴더
├── form.ui
├── main.py
├── widget.py
└── widget.pyproject

10. main.py 파일 역할

main.py는 프로그램을 실행하는 시작 파일이다. QApplication을 생성하고 Widget 클래스를 불러와 화면을 실행한다.

import sys
from PySide6.QtWidgets import QApplication

from widget import Widget

if __name__ == "__main__":
    app = QApplication(sys.argv)

    widget = Widget()
    widget.show()

    sys.exit(app.exec())

11. widget.py 파일 역할

widget.py는 실제 화면을 불러오는 파일이다. form.ui에서 만든 디자인을 Python 코드와 연결하는 역할을 한다.

from PySide6.QtWidgets import QWidget
from ui_form import Ui_Widget

class Widget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)

        self.ui = Ui_Widget()
        self.ui.setupUi(self)

12. form.ui 파일 역할

form.ui는 Qt Designer에서 만든 화면 디자인 파일이다. 버튼, 라벨, 입력창 같은 UI 요소가 저장된다.

13. ui_form.py 파일 역할

ui_form.py는 form.ui 파일을 Python 코드로 변환한 파일이다. widget.py에서 이 파일을 불러와 화면을 실행한다.

14. 전체 실행 흐름

main.py 실행
↓
widget.py의 Widget 클래스 호출
↓
ui_form.py의 Ui_Widget 불러오기
↓
form.ui 디자인 적용
↓
프로그램 창 실행

15. PySide6 설치 오류 발생

처음 실행했을 때 아래와 같은 오류가 발생할 수 있다.

ModuleNotFoundError: No module named 'PySide6'

이 오류는 Qt Creator가 사용하는 Python 가상환경 안에 PySide6가 설치되어 있지 않아서 발생한다.

16. Qt Creator 가상환경 경로 확인

실행 로그를 보면 Qt Creator가 사용하는 Python 경로를 확인할 수 있다.

/home/joy/untitled1/.qtcreator/Python_3_11_15venv/bin/python

17. pip 오류 확인

PySide6를 설치하려고 할 때 아래 오류가 발생할 수 있다.

No module named pip

이 경우 가상환경 안에 pip가 없는 상태이므로 가상환경을 다시 만들어야 한다.

18. 기존 가상환경 삭제

rm -rf /home/joy/untitled1/.qtcreator/Python_3_11_15venv

19. 가상환경 다시 생성

python3.11 -m venv /home/joy/untitled1/.qtcreator/Python_3_11_15venv

20. pip 설치 확인

/home/joy/untitled1/.qtcreator/Python_3_11_15venv/bin/python -m pip --version

21. PySide6 설치

/home/joy/untitled1/.qtcreator/Python_3_11_15venv/bin/python -m pip install PySide6

22. PySide6 설치 확인

/home/joy/untitled1/.qtcreator/Python_3_11_15venv/bin/python -m pip show PySide6

23. 다시 실행

Qt Creator에서 Run 버튼을 눌러 다시 실행한다. 실행 결과에 아래처럼 표시되면 정상적으로 실행된 것이다.

finished successfully

24. 정리

Qt Creator에서 PySide6 프로젝트를 실행하기 위해서는 Qt Creator가 사용하는 가상환경에 PySide6가 설치되어 있어야 한다. 시스템 Python에 PySide6를 설치해도 Qt Creator의 가상환경이 다르면 오류가 발생할 수 있다.