Verwendung von qt.conf

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

Format und Speicherort

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

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

1. :/qt/etc/qt.conf über das Ressourcensystem
2. auf Apple-Plattformen aus dem Verzeichnis „Resource“ innerhalb des Anwendungsbundles, zum Beispiel „ assistant.app/Contents/Resources/qt.conf “ unter macOS.
3. im Verzeichnis, das die ausführbare Datei der Anwendung enthält, d. h. QCoreApplication::applicationDirPath() + QDir::separator() + „qt.conf“

Pfade überschreiben

Die Datei „ qt.conf “ kann verwendet werden, um die von Qt verwendeten Standardpfade zu überschreiben. Auf diese Pfade kann über die Klasse „ QLibraryInfo “ zugegriffen werden.

Ohne „ qt.conf “ verwenden die Qt-Bibliotheken die Standardpfade, um nach Plugins, Übersetzungen usw. zu suchen. Diese Pfade sind auf dem Zielsystem möglicherweise nicht vorhanden oder nicht zugänglich. Aus diesem Grund benötigen Sie möglicherweise „ qt.conf “, damit die Qt-Bibliotheken an anderer Stelle suchen.

Die Datei sollte eine Gruppe namens „ Paths “ mit einem oder mehreren Einträgen enthalten, die den Werten der Enumeration `QLibraryInfo::LibraryLocation` entsprechen. Einzelheiten zur Bedeutung der verschiedenen Speicherorte finden Sie in der Dokumentation zu „ QLibraryInfo “.

Es werden absolute Pfade verwendet, wie in der Datei „ qt.conf “ angegeben. Alle Pfade sind relativ zu „ Prefix “. Unter Windows und Linux ist „ Prefix “ relativ zum Verzeichnis, das die ausführbare Anwendungsdatei enthält (QCoreApplication::applicationDirPath()). Unter macOS ist „ Prefix “ relativ zu „ Contents “ im Anwendungsbundle. Beispielsweise ist application.app/Contents/PlugIns/ der Standardspeicherort zum Laden von Qt-Plugins. Beachten Sie, dass die Plugins in bestimmten Unterverzeichnissen unter dem Verzeichnis „ plugins “ abgelegt werden müssen (Einzelheiten finden Sie unter „So erstellen Sie Qt-Plugins“ ).

Beispielsweise könnte eine „ qt.conf “-Datei Folgendes enthalten:

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

Prefix = c:\\SomePath

Seit Qt 6.8 ist es möglich, pro Eintrag mehrere Pfade anzugeben. Diese müssen als durch Kommas getrennte Liste angegeben werden. Zum Beispiel

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

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

Konfigurieren von Argumenten für die Plattform-Plugins

Die Datei „ qt.conf “ kann eine Gruppe „ Platforms “ enthalten, deren Schlüssel aus durch Kommas getrennten Listen von Argumenten bestehen, die an das Plattform-Plugin übergeben werden sollen. Der Schlüsselname ist der Name des Plattform-Plugins, wobei der erste Buchstabe großgeschrieben wird und darauf „ Arguments “ folgt.

Beispiel:

[Platforms]
WindowsArguments = fontengine=freetype

Dies würde bewirken, dass das Windows-Plattform-Plugin die FreeType-Schriftart-Engine verwendet.

Umgang mit parallelen Installationen älterer Qt-Versionen

In Umgebungen, in denen auch die Installation einer früheren Hauptversion von Qt erforderlich ist, kann eine versionsspezifische qt.conf verwendet werden. Dies ist häufig in Übergangsphasen von einer Qt-Version zur nächsten erforderlich oder um Konflikte zu vermeiden, die durch eine vorhandene Datei ohne Versionsangabe verursacht werden.

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