qt.conf verwenden

Sie können die Datei qt.conf verwenden, um Pfade zu überschreiben oder um Argumente anzugeben, die an die Plattform-Plugins übergeben werden.

Format und Speicherort

Die Datei qt.conf ist eine INI-Textdatei, wie in der Dokumentation QSettings beschrieben.

QLibraryInfo Die Datei qt.conf wird von einem der folgenden Speicherorte geladen:

1. :/qt/etc/qt.conf unter Verwendung des Ressourcensystems
2. unter macOS in das Ressourcenverzeichnis innerhalb des Anwendungspakets, zum Beispiel assistant.app/Contents/Resources/qt.conf
3. in dem Verzeichnis, das die ausführbare Anwendung enthält, d.h. QCoreApplication::applicationDirPath() + QDir::separator() + "qt.conf"

Pfade außer Kraft setzen

Die Datei qt.conf kann verwendet werden, um die fest kodierten Pfade, die in die Qt-Bibliothek kompiliert werden, zu überschreiben. Diese Pfade sind über die Klasse QLibraryInfo zugänglich. Ohne qt.conf geben die Funktionen in QLibraryInfo diese fest kodierten Pfade zurück; andernfalls geben sie die Pfade zurück, die in qt.conf angegeben sind.

Ohne qt.conf verwenden die Qt-Bibliotheken die fest kodierten Pfade, um nach Plugins, Übersetzungen usw. zu suchen. Diese Pfade existieren möglicherweise nicht auf dem Zielsystem, oder sie sind nicht zugänglich. Aus diesem Grund benötigen Sie möglicherweise qt.conf, um die Qt-Bibliotheken dazu zu bringen, woanders zu suchen.

Die Datei sollte eine Paths Gruppe haben, die die Einträge enthält, die jedem Wert des QLibraryInfo::LibraryLocation enum entsprechen. Siehe die QLibraryInfo Dokumentation für Details über die Bedeutung der verschiedenen Orte.

Absolute Pfade werden wie in der Datei qt.conf angegeben verwendet. Alle Pfade sind relativ zu Prefix. Unter Windows und X11 ist Prefix relativ zu dem Verzeichnis, das die ausführbare Anwendung enthält (QCoreApplication::applicationDirPath()). Unter macOS bezieht sich Prefix auf die Datei Contents im Anwendungsbündel. Zum Beispiel ist application.app/Contents/plugins/ der Standardspeicherort für das Laden von Qt-Plugins. Beachten Sie, dass die Plugins in bestimmten Unterverzeichnissen unter dem Verzeichnis plugins platziert werden müssen (siehe How to Create Qt Plugins für weitere Details).

Eine qt.conf Datei könnte zum Beispiel folgendes enthalten:

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

Prefix = c:\\SomePath

Seit Qt 6.8 ist es möglich, mehr als einen Pfad pro Eintrag anzugeben. Sie müssen als kommagetrennte Liste angegeben werden. Zum Beispiel

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

Es ist möglich, Leerzeichen vor und nach dem Komma einzufügen. Es ist auch möglich, die Anführungszeichen um die Einträge wegzulassen, wenn der Pfad keine Kommas oder Leerzeichen enthält.

Konfigurieren der Argumente für die Plattform-Plugins

qt.conf kann eine Platforms Gruppe enthalten, deren Schlüssel kommagetrennte Listen von Argumenten sind, die an das Plattform-Plugin übergeben werden. Der Schlüsselname ist der Name des Plattform-Plugins, wobei der erste Buchstabe in Großbuchstaben geschrieben wird, gefolgt von Arguments.

Zum Beispiel:

[Platforms]
WindowsArguments = fontengine=freetype

würde das Windows-Plattform-Plugin veranlassen, die FreeType-Schriftart-Engine zu verwenden.

Wie man mit parallelen Installationen von älteren Qt-Versionen umgeht

Für Umgebungen, die auch eine Installation einer früheren Hauptversion von Qt erfordern, ist es möglich, eine versionsspezifische qt.conf zu verwenden. Dies ist oft in Übergangsphasen von einer Qt-Version zur nächsten notwendig, oder um Konflikte zu vermeiden, die durch eine bestehende Datei ohne Version verursacht werden.

Zu diesem Zweck kann anstelle der Datei qt.conf eine Datei namens qt6.conf verwendet werden. Wenn beide Dateien in dem oben beschriebenen Verzeichnis existieren, wird qt6.conf verwendet.