qt.conf 사용법

qt.conf 파일을 사용하여 QLibraryInfo 경로를 재정의하거나, 플랫폼 플러그인에 전달할 인수를 지정할 수 있습니다.

형식 및 위치

qt.conf 파일은 QSettings 문서에 설명된 대로 INI 텍스트 파일입니다.

QLibraryInfo 다음 위치 중 하나에서 qt.conf 파일을 불러옵니다:

1. :/qt/etc/qt.conf 리소스 시스템을 사용하여
2. Apple 플랫폼의 경우, 애플리케이션 번들 내의 Resource 디렉터리에서, 예를 들어 macOS의 경우 assistant.app/Contents/Resources/qt.conf 입니다.
3. 애플리케이션 실행 파일이 포함된 디렉터리, 즉 QCoreApplication::applicationDirPath() + QDir::separator() + "qt.conf"

경로 재정의

qt.conf 파일을 사용하면 Qt에서 사용하는 기본 경로를 재정의할 수 있습니다. 이러한 경로는 QLibraryInfo 클래스를 사용하여 접근할 수 있습니다.

qt.conf 가 없으면 Qt 라이브러리는 플러그인, 번역 파일 등을 찾기 위해 기본 경로를 사용합니다. 이러한 경로는 대상 시스템에 존재하지 않거나 접근할 수 없을 수도 있습니다. 이 때문에 Qt 라이브러리가 다른 위치를 검색하도록 하려면 qt.conf 가 필요할 수 있습니다.

이 파일에는 QLibraryInfo::LibraryLocation 열거형의 값에 해당하는 하나 이상의 항목이 포함된 Paths 그룹이 있어야 합니다. 다양한 위치의 의미에 대한 자세한 내용은 QLibraryInfo 문서를 참조하십시오.

qt.conf 파일에 명시된 대로 절대 경로가 사용됩니다. 모든 경로는 Prefix 를 기준으로 합니다. Windows 및 Linux에서는 Prefix 가 애플리케이션 실행 파일(QCoreApplication::applicationDirPath())이 포함된 디렉터리를 기준으로 합니다. macOS에서는 Prefix 가 애플리케이션 번들 내의 Contents 를 기준으로 합니다. 예를 들어, application.app/Contents/PlugIns/ 는 Qt 플러그인을 로드하기 위한 기본 위치입니다. 플러그인은 plugins 디렉터리 아래의 특정 하위 디렉터리에 배치되어야 한다는 점에 유의하십시오(자세한 내용은 ‘Qt 플러그인 생성 방법’ 참조).

예를 들어, qt.conf 파일에는 다음과 같은 내용이 포함될 수 있습니다:

[Paths]
Prefix = /some/path
Translations = i18n

Prefix = c:\\SomePath

Qt 6.8부터는 항목당 하나 이상의 경로를 지정할 수 있습니다. 경로는 쉼표로 구분된 목록 형태로 제공해야 합니다. 예를 들어

QmlImports = "/path/to/imports1","/path/to/imports2"

쉼표 앞뒤에 공백을 넣을 수 있습니다. 또한 경로에 쉼표나 공백이 포함되어 있지 않은 경우, 항목 주위의 따옴표를 생략할 수도 있습니다.

플랫폼 플러그인 인수 구성

qt.conf 에는 Platforms 그룹이 포함될 수 있으며, 이 그룹의 키는 플랫폼 플러그인에 전달될 인수의 쉼표로 구분된 목록입니다. 키 이름은 플랫폼 플러그인의 이름에서 첫 글자를 대문자로 변경한 뒤 Arguments 를 붙인 형태입니다.

예를 들어:

[Platforms]
WindowsArguments = fontengine=freetype

이 경우 Windows 플랫폼 플러그인은 FreeType 글꼴 엔진을 사용하게 됩니다.

이전 버전의 Qt가 병렬로 설치된 경우 처리 방법

이전 주요 버전의 Qt도 함께 설치해야 하는 환경의 경우, 버전별 qt.conf를 사용할 수 있습니다. 이는 한 Qt 버전에서 다음 버전으로 전환하는 단계에서, 또는 버전이 명시되지 않은 기존 파일로 인해 발생하는 충돌을 피하기 위해 종종 필요합니다.

이를 위해 qt.conf 파일 대신 qt6.conf 라는 파일을 사용할 수 있습니다. 위에서 설명한 디렉터리에 두 파일이 모두 존재하는 경우, qt6.conf 파일이 사용됩니다.