자주 사용하는 툴들을 PyCharm에 External Tools에 연동하는 절차와 사용법을 기록합니다.
PyQt5 : pypi.org/project/PyQt5/
Qt Designer : pypi.org/project/PySide2/
PyUIC5 : pypi.org/project/pyqt5-tools/
PyInstaller : pypi.org/project/pyinstaller/
아래 내용은 PyCharm 2020.2.x, Python 3.8x와 Windows 10에서 진행된 내용입니다.
Qt Designer
Qt Designer는 Window를 디자인하기 위한 툴 입니다.
PySid2를 설치하면 C:\Users\YOURNAME\AppData\Local\Programs\Python\Python38\Lib\site-packages\PySide2 에 설치됩니다. (YOURNAME는 사용하는 계정으로 바꿔주세요.)
File -> Settings -> Tools -> External Tools 에서 + 아이콘을 눌러 툴을 설정합니다.
Name에 "Qt Designer" 입력
Program에 C:\Users\YOURNAME\AppData\Local\Programs\Python\Python38\Lib\site-packages\PySide2\designer.exe 입력
Arguments에 $FilePath$ 입력
Working directory에 $ProjectFileDir$ 를 입력
등록이 완료되면 Tools -> External Tools 메뉴에서 Qt Designer를 확인할 수 있습니다.
PyUIC5
Qt Designer로 제작된 .ui 파일을 .py 파일로 변환해주는 툴입니다.
File -> Settings -> Tools -> External Tools 에서 + 아이콘을 눌러 툴을 설정합니다.
Name에 "Ui2Py" 입력
Program에 C:\Users\YOURNAME\AppData\Local\Programs\Python\Python38\Scripts\pyuic5.exe 입력 (YOURNAME는 사용하는 계정으로 바꿔주세요.)
Arguments에 $FileName$ -o $FileNameWithoutExtension$.py 입력
Working directory에 $ProjectFileDir$ 를 입력
UI 파일을 열고 마우스 우측 버튼을 눌러 External Tools 메뉴에서 Ui2Py를 선택하면 ui파일을 py 파일로 변환합니다.
PyInstaller
프로젝트를 단독으로 실행 가능한 파일로 만들어주는 툴입니다.
File -> Settings -> Tools -> External Tools 에서 + 아이콘을 눌러 툴을 설정합니다.
Name에 "PyInstaller" 입력
Program에 C:\Users\YOURNAME\AppData\Local\Programs\Python\Python38\Scripts\pyinstaller.exe 입력 (YOURNAME는 사용하는 계정으로 바꿔주세요.)
Arguments에 --onefile --windowed $FilePath$ 입력 (콘솔 응용 프로그램일 경우 --windowed 옵션을 삭제하시면 됩니다.)
Working directory에 $ProjectFileDir$ 를 입력
등록이 완료되면 Tools -> External Tools 메뉴에서 PyInstaller를 선택해 실행하면 빌드가 진행됩니다. 빌드 후 프로젝트 폴더에 dist 폴더가 생성되고 그 안에 실행 가능한 파일이 생성됩니다.
프로젝트에 어떤 모듈을 설치했는지에 따라 간혹 "Failed to execute script ... " 라는 에러 메세지가 뜨면서 실행되지 않는 경우가 발생할 수 있습니다.
이때는 --windowed 옵션을 제거 후 터미널 화면에서 실행해보면 어떤 모듈을 찾을 수 없어 실행이 안되는지 확인이 가능합니다.
이 문제가 발생하는 이유는 PyCharm의 경우 빌드환경을 툴에서 프로젝트 별로 운영하기 때문인데, 이는 해당 프로젝트에 venv로 시작하는 폴더명이 있는 것을 통해 알 수 있습니다.
PyCharm에서 프로젝트를 만들면 기본적인 venv 폴더를 만들어 운영하며, 프로젝트에 설치한 모든 모듈들은 해당 프로젝트에만 종속적으로 설치됩니다. 설치 위치는 해당프로젝트폴더\venv\Lib\site-packages 입니다.
pyinstaller는 기본 설치 환경인 C:\Users\YOURNAME\AppData\Local\Programs\Python\Python38\Lib\site-packages 에서 모듈을 찾아 프로젝트에 포함시키기 때문에 PyCharm에서 프로젝트에 종속적으로 설치된 모듈의 경우는 찾을 수 없습니다.
이를 해결하기 위해서는 터미널에서 다시 한번 관련 모듈을 설치한 후 재빌드하면 문제가 해결됩니다.
'개발 이야기 > Python' 카테고리의 다른 글
tensorflow gpu 가속 기능 사용 설정 (0) | 2021.01.12 |
---|---|
윈도우에서 pytesseract 로 이미지에서 숫자 추출하기 (0) | 2020.10.22 |
Python으로 제작한 자동 번역 및 음성 파일 생성툴 (0) | 2020.09.23 |
PyCharm에 자주 쓰는 툴 설치 (0) | 2020.09.22 |
PyCharm Repositories 변경 (0) | 2020.09.14 |