This is an old revision of the document!

Table of Contents

UI 개발환경

개발 PC(Windows)에서 PyQt5로 작성한 UI 파일을 모듈라 Pi(Raspberry Pi)에서 실행하기 위한 기본 환경 설정 방법을 안내합니다.

- 진행하기 전에 아래 항목들이 준비되어 있어야 합니다.

개발PC(window)와 Modular Pi(Raspberry pi)에 pyQt5와 Tool을 설치해야 합니다.

모듈라 PI에 pyQt5 설치

  • 모듈라 PI pyQt5 설치 : sudo apt install -y qtbase5-dev qtchooser qt5-qmake qtbase5-dev-tools python3-pyqt5

Conda 설치

Conda 가상환경에서 설치하여 사용하면, 프로젝트별로 라이브러리 버전을 독립적으로 관리할 수 있어 개발 환경을 안정적으로 유지할 수 있습니다.

PyQt5는 Python 3.6부터 3.12 버전까지 지원됩니다. 만약 시스템에 더 최신 버전의 Python이 설치되어 있다면, Conda를 이용하여 해당 범위의 Python 버전으로 가상환경을 구성하는 것을 권장합니다. Conda는 Python과 관련 개발 라이브러리를 쉽게 설치하고 관리할 수 있는 패키지 및 가상환경 관리 도구입니다. 하나의 PC에서 여러 버전의 Python 환경과 서로 다른 라이브러리 구성을 독립적으로 사용할 수 있도록 도와줍니다.

  • 프로젝트별로 Python 및 라이브러리 버전을 독립적으로 관리할 수 있습니다.
  • 라이브러리 간 호환성 문제를 방지하여 환경 충돌 없이 개발할 수 있습니다. (예: PyQt5 및 PySide6 동시 개발 가능)

이를 통해 UI 개발 환경을 안정적이고 효율적으로 유지할 수 있습니다.

  • 2. Conda 초기화 : “C:\Users\COMFILE\miniconda3\condabin\conda.bat” init cmd.exe
  • eg. 설치 확인: conda –version


Conda + pyQt5(Designer) 설치

Visual Studio Code(VS Code)를 사용하면 Conda 가상환경을 보다 편리하게 관리할 수 있습니다. 아래는 환경 설정 파일(environment.win.yml)을 사용하여 PyQt5 개발 환경을 생성하고 구성하는 방법입니다.

  • 1. VS code에서 새 프로젝트 폴더를 생성한 뒤, 다음 내용으로 environment.win.yml 파일을 만듭니다.
  • (해당 환경 파일은 pyqt-win 가상환경에 Python 3.11, PyQt5, pyqt5-tools를 설치하도록 구성되어 있습니다.)
name: pyqt-win
channels:
  - conda-forge
  - defaults
dependencies:
  - python=3.11
  - pyqt=5.*
  - pip
  - pip:
      - pyqt5-tools==5.15.9.3.3  # (선택) Qt Designer/pyuic 포함 패키지
  • 2. 환경 파일이 폴더로 이동 → 환경 생성 → 환경 활성화 → 설치 확인
  • 1 ) cd 새 폴더\ environment.win.yml → 2 ) conda env create -f environment.win.yml → 3 ) conda env create -f environment.win.yml → 4 ) python -c “from PyQt5 import QtWidgets; print('PyQt OK')”

  • 3. pyQt Designer 실행
  • 1 ) pyQt5가 설치된 conda 가상환경 실행 :conda activate pyqt-win → 2 ) pyQt designer 실행 : pyqt5-tools designer


PyQt5(Designer) 설치

만약 “Conda + PyQt5 설치” 방법을 사용하지 않고, 일반 환경(기본 Python 환경)에 직접 설치하고자 한다면 아래 명령어를 이용하여 설치할 수 있습니다.

  • pyqt5 설치 : python -m pip install PyQt5
  • pyqt5-tools설치(Qt designer) : python -m pip install pyqt5-tools

☞ PyQt5를 설치하기 전에 Python 3.6 ~ 3.12 버전이 설치되어 있어야 합니다. (Python 3.13 이상 버전에서는 동작하지 않습니다.)

Python을 이용한 CFNET I/O 개발