Qt CLI 빌드 환경 세팅 (Ubuntu 22.04 기준)

이전 글 : QtCreator 6.8.3 환경 세팅 (Ubuntu VirtualBox)

이전 글에서 QtCreator GUI 환경을 세팅하였습니다.
이번 글에서는 터미널에서 직접 Qt 프로젝트를 빌드하고 실행하는 방법을 정리하였습니다.

---

1. 빌드 스크립트 작성

매번 cmake 명령을 직접 입력하는 것은 번거롭습니다.
아래와 같이 빌드 스크립트를 작성해두면 실행하려는 폴더 위치에 들어가서 qtbuild.sh 명령어만으로 간편하게 빌드할 수 있습니다.

mkdir -p ~/bin
vi ~/bin/qtbuild.sh

qtbuild.sh 내용:

#!/bin/bash
if [ ! -d build ]; then
    mkdir build
fi
cd build
qt-cmake -G Ninja -S .. -B .
ninja

• qt-cmake : Qt 전용 CMake 래퍼로, Qt 관련 설정이 자동으로 적용됩니다.
• -G Ninja : 빌드 시스템으로 Ninja를 사용합니다.
• -S .. : 소스 디렉토리를 상위 폴더(프로젝트 루트)로 지정합니다.
• -B . : 빌드 디렉토리를 현재 폴더(build/)로 지정합니다.

실행 권한을 부여합니다.

chmod +x ~/bin/qtbuild.sh

---

2. ~/bin PATH 등록

스크립트를 어디서든 실행하려면 ~/bin 을 PATH에 추가해야 합니다. 일단 홈 디렉토리에 bin 디렉토리가 있는지 확인하고, 없다면 mkdir bin 으로 만들어주기만 하면 됩니다.

~/.bashrc에 아래 줄을 추가합니다.

export PATH="$HOME/bin:$PATH"

적용합니다.

source ~/.bashrc

---

3. 프로젝트 빌드

CMakeLists.txt 가 있는 프로젝트 폴더로 이동한 후 스크립트를 실행합니다.

cd ~/qt-class/QT-examples/ch05/02_QCommandLinkButton
qtbuild.sh

빌드가 성공하면 아래와 같이 출력됩니다.

-- Configuring done
-- Generating done
-- Build files have been written to: .../build
[5/5] Linking CXX executable 02_QCommandLinkButton

CMakeLists.txt가 없는 폴더에서 실행하면 CMake 오류가 발생합니다.
반드시 프로젝트 루트 폴더(CMakeLists.txt가 있는 위치)에서 실행해야 합니다.

---

4. 빌드 결과물 실행

빌드가 완료되면 build/ 폴더 안에 실행 파일이 생성됩니다.

./build/02_QCommandLinkButton

애플리케이션 창이 정상적으로 뜨면 빌드 및 실행이 완료된 것입니다.

---

전체 흐름 요약

프로젝트 폴더 이동
    ↓
qtbuild.sh 실행  (cmake configure + ninja build)
    ↓
./build/실행파일명 실행