Qt 버전 추가하기

개발 PC에 여러 버전의 Qt를 설치하여 프로젝트를 빌드하는 데 사용할 수 있습니다. 예를 들어, 기기 제조업체는 자사 기기용 애플리케이션 개발을 위한 특별한 Qt 버전을 제공합니다.

설치된 Qt 버전을 보려면 환경설정 > Kits > Qt Versions 을 선택합니다.

각 Qt 버전에 대한 자세한 정보를 보려면 목록에서 해당 버전을 선택하고 Qt version for 섹션에서 Details 을 선택합니다.

유효하지 않은 Qt 버전을 제거하려면 Clean Up 을 선택합니다.

설치된 Qt 버전 등록하기

설치된 Qt에 링크하여 Qt Online Installer 를 설치하여 설치된 Qt 버전을 자동으로 감지할 수 있습니다. 그러나 Linux 배포판, macOS의 brew 또는 Windows의 Chocolatey와 같은 다른 패키지 관리자와 함께 시스템이 설치한 Qt나 자체 빌드한 Qt에는 링크할 수 없습니다. 이러한 경우 Qt Versions 탭에서 Add 을 선택하여 새 Qt 버전 설정에 안내된 대로 수동으로 Qt 버전을 추가합니다.

Qt 설치에 연결하려면:

1. 환경설정 > Kits > Qt Versions > Link with Qt 을 선택합니다.

   

2. Qt installation path 필드에 Qt를 설치한 디렉터리 경로를 입력합니다.
3. Link with Qt 을 선택하여 Qt 버전과 키트를 Qt 설치 디렉토리에 자동으로 등록합니다.
4. Restart Now 을 선택하여 Qt Creator 을 다시 시작합니다.

목록에서 자동으로 감지된 Qt 버전을 제거하려면 Remove Link 을 선택합니다.

Qt Versions 탭에 Auto-detected 아래에 Qt 버전이 표시되지 않으면 수동으로 설정합니다.

환경설정 > Kits 에서 프로젝트 빌드 및 실행을 위해 각 키트에 사용할 Qt 버전을 지정합니다.

새 Qt 버전 설정하기

Qt 버전을 등록하려면 해당 Qt 버전에 대한 qmake 또는 qtpaths 실행 파일이 포함된 디렉터리 경로를 설정합니다.

Qt 버전을 추가하려면:

1. 환경설정 > Kits > Qt Versions > Add 을 선택합니다.

   원격 Linux 장치 또는 Docker에서 Qt 버전을 추가하려면 Shift 키를 누른 다음 Add 을 선택합니다.

2. 추가할 Qt 버전에 대한 qmake 또는 qtpaths 실행 파일을 선택합니다.
3. Qt 버전을 선택하여 보고 편집합니다.
4. Name 필드에서 Qt Creator 에서 제안하는 Qt 버전에 대한 이름을 편집합니다.
5. qmake path 필드에서 qmake 또는 qtpaths 의 위치를 변경할 수 있습니다.
6. Qt 버전이 QNX용인 경우 QNX SDK 필드에 QNX SDK의 경로를 입력합니다.

수동으로 추가한 Qt 버전을 제거하려면 Manual 목록에서 해당 버전을 선택한 다음 Remove 을 선택합니다.

문서 등록

기본적으로 Qt Creator 은 설치된 각 Qt 모듈에 대해 사용 가능한 최신 버전의 설명서만 등록합니다.

설치된 모든 Qt 버전의 문서 세트를 등록하려면 Register documentation 목록에서 All 을 선택합니다. Qt 문서를 전혀 등록하지 않으려면 None 을 선택합니다. 기본 동작은 Highest Version Only 입니다.

Qt 설치 문제 해결

Qt Creator 에서 Qt 버전 설치에 문제가 감지되면 목록에서 Qt 버전 이름 옆에 경고 및 오류를 표시합니다. Qt 버전을 선택하면 문제에 대한 자세한 정보와 문제 해결을 위한 제안을 볼 수 있습니다.

특정 Qt 버전의 설치를 확인하려면 Qt Creator qmake -query 을 호출하여 출력에 참조된 디렉터리가 존재하는지 확인합니다. Qt Online Installer 을 사용하여 Qt를 설치한 경우 Qt Maintenance Tool 을 실행하여 업데이트를 확인하거나 Qt 버전을 다시 설치합니다.

자체 빌드된 Qt 버전

자체 빌드한 Qt 버전으로 프로젝트를 빌드하려면 새 Qt 버전 설정에 설명된 대로 해당 버전을 추가합니다.

Qt는 다음과 같은 최소 요구 사항을 충족해야 합니다:

• qmake는 -query 명령줄 인수를 이해하는 실행 파일이어야 합니다.
• bin 및 include 디렉터리가 존재해야 합니다. Qt Creator 은 qmake -query 을 실행하여 이러한 디렉터리를 가져옵니다.

Qt 버전용 키트를 추가하고 CMake에 맞게 구성합니다.

Qt Creator 가 누락되면 경고를 발행합니다:

• libQtCore.so 가 누락되어 Qt Creator 에서 ABI를 감지할 수 없습니다.
• toolchain.cmake 가 누락된 경우. 예를 들어 x86 플랫폼에 대해 -static 옵션을 사용하여 Qt를 빌드했습니다.

다음을 시도해 보세요:

• 빌드 디렉토리에서 make install 을 실행하여 Qt를 구성된 위치에 설치합니다.
• Preferences > Kits > Kits > CMake Configuration 에서 CMAKE_PREFIX_PATH 변수 값을 Qt를 설치한 위치로 설정합니다.