1. 시스템 환경 최적화 및 업데이트

Kylin V10(x86_64) 운영체제에서 Qt 개발 환경을 구축하기 위해 가장 먼저 수행해야 할 작업은 시스템 패키지 저장소를 최신 상태로 갱신하는 것입니다. 이는 의존성 문제를 방지하고 설치 프로세스의 안정성을 확보하기 위함입니다. 터미널을 열고 다음 명령어를 실행하여 시스템 업데이트를 진행합니다.

sudo apt update
sudo apt upgrade -y

업데이트가 완료되면 C++ 개발에 필요한 핵심 도구 모음인 build-essential을 설치합니다. 이 패키지에는 gcc, g++, make 등 Qt 소스 코드를 컴파일하기 위해 필수적인 도구들이 포함되어 있습니다.

sudo apt install -y build-essential

설치 후 gcc --version 명령어를 통해 컴파일러가 정상적으로 설치되었는지 확인할 수 있습니다.

2. 패키지 관리자를 이용한 Qt 온라인 설치

네트워크가 연결된 환경에서 가장 빠르고 간편하게 Qt 환경을 구성하는 방법은 시스템 기본 저장소를 이용하는 것입니다. Kylin V10은 일반적으로 Qt 5.9 또는 5.12 버전의 안정적인 패키지를 제공합니다.

2.1 Qt Creator 및 라이브러리 설치

먼저 통합 개발 환경(IDE)인 Qt Creator와 기본 개발 라이브러리를 설치합니다.

sudo apt install -y qtcreator qt5-default qtbase5-dev

• qtcreator: 프로젝트 관리, 코드 작성 및 디버깅을 위한 GUI 도구입니다.
• qt5-default: 시스템의 기본 Qt 버전을 Qt5로 설정하고 실행 환경을 구성합니다.
• qtbase5-dev: #include <QWidget>와 같은 표준 헤더 파일과 링크를 위한 라이브러리 파일들을 제공합니다.

2.2 디버깅 및 빌드 도구 보강

실제 프로젝트 개발 시 필수적인 디버거와 최신 빌드 시스템인 CMake를 추가로 설치하는 것이 권장됩니다.

sudo apt install -y gdb cmake extra-cmake-modules

설치가 완료되면 프로그램 메뉴에서 Qt Creator를 실행하여 설치된 Qt 버전과 컴파일러 설정(Kits)이 올바르게 인식되었는지 확인합니다.

3. 특정 버전을 위한 오프라인 설치 방식

프로젝트에서 특정 Qt 버전(예: Qt 5.15.2 등)이 필요하거나 보안상의 이유로 외부망 연결이 제한된 환경에서는 오프라인 설치 파일(.run)을 사용해야 합니다.

먼저 Qt 공식 아카이브 또는 미러 사이트에서 해당 아키텍처(x86_64)에 맞는 설치 파일을 다운로드합니다. 다운로드한 파일에 실행 권한을 부여한 뒤 설치 관리자를 실행합니다.

chmod +x qt-opensource-linux-x64-5.x.x.run
./qt-opensource-linux-x64-5.x.x.run

설치 마법사 실행 시, 필요한 컴포넌트(Desktop gcc 64-bit 등)를 선택하여 설치를 진행합니다. 오프라인 설치의 경우 시스템 라이브러리와의 링크 문제가 발생할 수 있으므로, 실행 중 libGL 관련 오류가 발생한다면 다음 패키지를 추가로 설치하여 해결할 수 있습니다.

sudo apt install -y libgl1-mesa-dev libglu1-mesa-dev