Ubuntu에서 시작하는 PyQt5 개발: Qt Designer 설치 가이드

Ubuntu 리눅스에서 GUI 애플리케이션 개발을 시작하고자 하는 개발자들에게 PyQt5는 매력적인 선택지입니다. PyQt5는 Python 바인딩을 제공하는 Qt 애플리케이션 프레임워크로, 강력한 GUI 애플리케이션을 손쉽게 개발할 수 있도록 합니다. 이 글에서는 Ubuntu 환경에서 PyQt5와 Qt Designer를 설치하고 기본적인 애플리케이션을 만드는 과정을 단계별로 안내해드리겠습니다.

Ubuntu에서 시작하는 PyQt5 개발: Qt Designer 설치 가이드

1단계: 시스템 업데이트

첫 번째 단계는 시스템을 최신 상태로 유지하는 것입니다. 터미널을 열고 다음 명령어를 입력하세요.

sudo apt-get update
sudo apt-get upgrade

2단계: PyQt5 설치

PyQt5를 설치하는 것은 단순합니다. 다음 명령어를 터미널에 입력하세요.

sudo apt-get install python3-pyqt5

3단계: Qt Designer 설치

Qt Designer는 GUI 디자인을 위한 강력한 도구입니다. 다음 명령으로 설치할 수 있습니다.

sudo apt-get install qttools5-dev-tools

4단계: pyqt5-dev-tools 설치

pyqt5-dev-tools 패키지는 PyQt5 개발을 위한 추가 도구를 제공합니다. 이 패키지에는 UI 파일을 Python 코드로 변환하는 pyuic5 도구가 포함되어 있습니다. 설치하려면 다음 명령을 실행하세요.

sudo apt-get install pyqt5-dev-tools

5단계: 첫 PyQt5 애플리케이션 생성 테스트

Qt Designer로 디자인한 인터페이스를 Python 코드와 연동하여 첫 애플리케이션을 만듭니다. 간단한 예제를 통해 시작해봅시다.

1. Qt Designer 실행: 터미널에서 designer 명령어를 입력하여 Qt Designer를 시작합니다.
2. 새 폼 선택: "Main Window"나 "Dialog without Buttons" 중 원하는 폼을 선택하고, "Create" 버튼을 클릭합니다.
3. 위젯 추가 및 배치: 좌측의 위젯 박스에서 필요한 위젯(예: 버튼, 텍스트 필드)을 드래그하여 메인 윈도우로 옮기고, 적절히 배치합니다.
4. 위젯 속성 설정: 오른쪽의 속성 에디터를 사용하여 각 위젯의 속성(예: 크기, 라벨 등)을 설정합니다.
5. UI 파일 저장: 작업한 디자인을 .ui 파일로 저장합니다. 예를 들어, main_window.ui라는 이름으로 저장할 수 있습니다.

우분투 리눅스 환경에서 Qt Designer 최초 실행 화면

UI 파일을 Python 코드로 변환하기

Qt Designer에서 생성한 .ui 파일을 Python 코드로 변환하려면, 터미널에서 pyuic5 명령어를 사용합니다. 변환 과정은 다음과 같습니다.

pyuic5 -x main_window.ui -o main_window.py

이 명령은 main_window.ui 파일을 main_window.py Python 스크립트로 변환합니다. -x 옵션은 변환된 스크립트에 직접 실행 가능한 코드를 포함시키라는 의미입니다.

Python에서 애플리케이션 실행하기

변환된 Python 코드를 사용하여 PyQt5 애플리케이션을 실행할 수 있습니다. 기본적인 실행 코드는 다음과 같습니다:

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow
from main_window import Ui_MainWindow

class MyApplication(QMainWindow, Ui_MainWindow):
    def __init__(self):
        super().__init__()
        self.setupUi(self)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    mainWin = MyApplication()
    mainWin.show()
    sys.exit(app.exec_())

이 코드는 PyQt5 애플리케이션을 생성하고, 변환된 UI 클래스를 메인 윈도우로 설정한 후, 애플리케이션을 실행합니다.

애플리케이션 테스트

모든 설정이 완료되었으면, Python 스크립트를 실행하여 GUI 애플리케이션을 테스트합니다. 터미널에서 다음과 같이 입력합니다:

python3 main_window.py

Ubuntu 리눅스 환경에서 PyQt5와 Qt Designer를 사용하여 GUI 애플리케이션을 개발하는 과정은 간단합니다. 이 가이드가 첫 번째 애플리케이션을 성공적으로 만드는 데 도움이 되시기를 바랍니다.