qt.conf 사용하기

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

형식 및 위치

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

QLibraryInfo 다음 위치 중 하나에서 qt.conf 를 로드합니다:

1. :/qt/etc/qt.conf 리소스 시스템 사용
2. macOS의 경우 애플리케이션 번들 내의 리소스 디렉토리(예 assistant.app/Contents/Resources/qt.conf
3. 애플리케이션 실행 파일이 들어 있는 디렉토리, 즉 QCoreApplication::applicationDirPath() + QDir::separator() + "qt.conf"

경로 재정의하기

qt.conf 파일은 Qt 라이브러리에 컴파일된 하드 코딩된 경로를 재정의하는 데 사용할 수 있습니다. 이러한 경로는 QLibraryInfo 클래스를 사용하여 액세스할 수 있습니다. qt.conf 가 없으면 QLibraryInfo 의 함수는 이러한 하드 코딩된 경로를 반환하고, 그렇지 않으면 qt.conf 에 지정된 경로를 반환합니다.

qt.conf 이 없으면 Qt 라이브러리는 하드 코딩된 경로를 사용하여 플러그인, 번역 등을 찾습니다. 이러한 경로는 대상 시스템에 존재하지 않거나 액세스할 수 없을 수 있습니다. 따라서 Qt 라이브러리를 다른 곳에서 찾으려면 qt.conf 이 필요할 수 있습니다.

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

절대 경로는 qt.conf 파일에 지정된 대로 사용됩니다. 모든 경로는 Prefix 에 상대적입니다. Windows 및 X11에서 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 파일이 사용됩니다.