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

- 진행하기 전에 아래 항목들이 준비되어 있어야 합니다.
  * Python 설치된 개발PC(window)와 모듈라PI 
  * VS Code SSH 접속 환경[[https://www.comfilewiki.co.kr/ko/doku.php?id=modularpi:pythonsetting|(Python 개발환경)]]

개발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 버전으로 가상환경을 구성하는 것을 권장합니다.
[[https://www.anaconda.com/docs/getting-started/miniconda/main|Conda]]는 Python과 관련 개발 라이브러리를 쉽게 설치하고 관리할 수 있는 패키지 및 가상환경 관리 도구입니다.
하나의 PC에서 여러 버전의 Python 환경과 서로 다른 라이브러리 구성을 독립적으로 사용할 수 있도록 도와줍니다.

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

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

  * 1. [[https://www.anaconda.com/download/success|Miniconda 다운로드]] 하여 개발pc(Window PC)에 아래와 같이 설치합니다.

{{ :modularpi:python:uipyqtsetting:conda_setup.png?nolink |}}

  * 2. Conda 초기화 : ''"C:\Users\COMFILE\miniconda3\condabin\conda.bat" init cmd.exe''
  * **eg.** 설치 확인: ''conda --version''

{{ :modularpi:python:uipyqtsetting:anaconinit.png?nolink |}}


===== 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를 설치하도록 구성되어 있습니다.)

<code c>
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 포함 패키지
</code>

  * **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')"''

{{ :modularpi:python:uipyqtsetting:vscod_conda.png?nolink |}}

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

{{ :modularpi:python:uipyqtsetting:designer_setup.png?nolink |}}

\\

===== 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 이상 버전에서는 동작하지 않습니다.)//

[[..:index|Python을 이용한 CFNET I/O 개발]]