[ubuntu] Qt 설치
1. 사전 준비
Step 1. 개발 도구 설치
Qt 프로그램을 빌드하려면 컴파일러와 기본 빌드 도구가 필요합니다.
Ubuntu에서는 build-essential 설치만으로 g++, make 등 주요 도구를 함께 준비할 수 있습니다.
sudo apt update
sudo apt install -y build-essential cmake ninja-build git
Step 2. 각종 라이브러리 설치 (Ubuntu 24.04 LTS)
Qt GUI/Widgets는 Linux에서 주로 xcb 플랫폼 플러그인을 사용하므로, 관련 X11/xcb 계열 라이브러리가 필요할 수 있습니다. 공식 문서도 Linux에서 xcb 기반 의존성을 안내하고 있습니다.
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
Step 3. Qt 다운로드 링크 에서 설치 파일 다운로드
linux 설치 파일, .run 확장자 파일 다운로드
Step 4. 다운 받은 파일이 있는 곳에서 터미널 실행
보통 Downloads 폴더에 해당 실행 파일을 다운 받았을 것이다.
cd ~/Downloads
Step 5. run 파일 권한 확인
ls -tlr
아래 이미지처럼 Qt 설치 파일의 권한에, x 가 없는 상태가 출력되하면 아래 명령어 실행
(파일명 생략을 위해 *(와일드카드)를 사용하거나, 파일명 일부 입력 후 Tab 키를 눌러 완성한다.)
chmod a+x qt(파일명)
Step 6. 다운받은 Qt run 파일 실행
다운받은 run 파일을 실행한다.
Qt 파일명 뒤에, 미러 서버를 입력하면 기본 다운로드 서버가 느리거나 연결이 불안정한 경우에는 mirror 옵션을 사용해 가까운 서버를 지정할 수 있습니다.
mirror 설정을 한국 근처의 서버를 선택한다.
(파일명 입력은, 파일명 일부 입력 후 Tab 키를 눌러 완성하거나, 파일명 생략을 위해 *(와일드카드)를 사용한다.)
./qt-online-installer-linux-x64-online.run --mirror http://ftp.jaist.ac.jp/pub/qtproject
2. Qt 설치
Qt 를 설치하려면 회원가입이 필수다.
gmail 외, 다른 이메일은 "인증" 이메일 수신이 안될 수 있으니 gmail 을 이용해 가입한다.
그 외, 특정 버전을 선택하는 경우
- Custom Installation ( 사용자 지정 설치 ) 선택 후 특정 버전, 필요한 라이브러리 선택 후 설치 진행
- 설치 완료 후에, Qt Maintenance Tool 에서 추가 설치 가능
추가 에러 해결방법
Error 1) Qt ver. 6.5 이상인 경우, libxcb-cursor0 플러그인 필요
Qt ver. 6.5 이상에서 Qt Creator 실행시, 아래와 같은 메시지가 뜨고 실행이 안되는 경우가 있다.
터미널을 열고 아래 플러그인을 설치한다.
sudo apt update
sudo apt install -y \
libxcb-cursor0 \
libxcb-cursor-dev \
libxcb1 \
libx11-xcb1 \
libxcb-icccm4 \
libxcb-image0 \
libxcb-keysyms1 \
libxcb-render-util0 \
libxcb-shape0 \
libxcb-shm0 \
libxcb-sync1 \
libxcb-xfixes0 \
libxcb-xinerama0 \
libxcb-xkb1 \
libxkbcommon-x11-0 \
libglu1-mesa \
libgl1-mesa-glx
Error 2) GLX
3-d graphics library with an api
빌드시 아래와 같은 이슈가 발생하면,
터미널을 열고 아래 패키지를 설치한다.
sudo apt install libgl1-mesa-dev
Error 3) xcb (1)
X 윈도 시스템을 위한 C 언어 바인딩이다.
실행시 아래와 같은 에러가 발생하면,
터미널을 열고 아래 패키지를 설치한다.
sudo apt-get install xcb*
계속 동일 문제가 발생하면, 아래 패키지를 설치한다.
sudo apt-get install '^libxcb.*-dev' libx11-xcb-dev libglu1-mesa-dev libxrender-dev libxi-dev libxkbcommon-dev libxkbcommon-x11-dev
Error 4) make
터미널을 열고 아래 패키지를 설치한다.
sudo apt install make make-guile
Error 5) libxcb-xinerama
터미널을 열고 아래 패키지를 설치한다.
sudo apt install libxcb-xinerama0-dev
Error 6) 그 외 패키지 문제 발생시
sudo apt install \
build-essential libgl1-mesa-dev cmake \
libfontconfig1-dev libfreetype6-dev \
libx11-dev libx11-xcb-dev libxext-dev libxfixes-dev libxi-dev libxrender-dev \
libxcb1-dev libxcb-cursor-dev libxcb-glx0-dev libxcb-keysyms1-dev libxcb-image0-dev \
libxcb-shm0-dev libxcb-icccm4-dev libxcb-sync-dev libxcb-xfixes0-dev \
libxcb-shape0-dev libxcb-randr0-dev libxcb-render-util0-dev libxcb-util-dev \
libxcb-xinerama0-dev libxcb-xkb-dev libxkbcommon-dev libxkbcommon-x11-dev \
libxcb-cursor0 xcb* libglu1-mesa-dev make make-guile