Utiliser qt.conf

Vous pouvez utiliser le fichier qt.conf pour remplacer les chemins d'accès ou pour spécifier les arguments à transmettre aux plugins de la plateforme.

Format et emplacement

Le fichier qt.conf est un fichier texte INI, comme décrit dans la documentation QSettings.

QLibraryInfo chargera qt.conf à partir de l'un des emplacements suivants :

1. :/qt/etc/qt.conf en utilisant le système de ressources
2. sur macOS, dans le répertoire Resource à l'intérieur du paquet d'applications, par exemple assistant.app/Contents/Resources/qt.conf
3. dans le répertoire contenant l'exécutable de l'application, par exemple QCoreApplication::applicationDirPath() + QDir::separator() + "qt.conf"

Remplacer les chemins d'accès

Le fichier qt.conf peut être utilisé pour remplacer les chemins codés en dur qui sont compilés dans la bibliothèque Qt. Ces chemins sont accessibles à l'aide de la classe QLibraryInfo. Sans qt.conf, les fonctions de QLibraryInfo renvoient ces chemins codés en dur ; sinon, elles renvoient les chemins spécifiés dans qt.conf.

Sans qt.conf, les bibliothèques Qt utiliseront les chemins codés en dur pour rechercher des plugins, des traductions, etc. Il se peut que ces chemins n'existent pas sur le système cible ou qu'ils ne soient pas accessibles. Pour cette raison, vous pouvez avoir besoin de qt.conf pour que les bibliothèques Qt cherchent ailleurs.

Le fichier doit avoir un groupe Paths qui contient les entrées correspondant à chaque valeur de l'enum QLibraryInfo::LibraryLocation. Voir la documentation de QLibraryInfo pour plus de détails sur la signification des différents emplacements.

Les chemins d'accès absolus sont utilisés comme spécifié dans le fichier qt.conf. Tous les chemins sont relatifs à Prefix. Sous Windows et Linux, Prefix est relatif au répertoire contenant l'exécutable de l'application (QCoreApplication::applicationDirPath()). Sous macOS, le Prefix est relatif au Contents dans le paquet d'applications. Par exemple, application.app/Contents/plugins/ est l'emplacement par défaut pour le chargement des plugins Qt. Notez que les plugins doivent être placés dans des sous-répertoires spécifiques sous le répertoire plugins (voir Comment créer des plugins Qt pour plus de détails).

Par exemple, un fichier qt.conf peut contenir ce qui suit :

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

Prefix = c:\\SomePath

Depuis Qt 6.8, il est possible de fournir plus d'un chemin par entrée. Ils doivent être fournis sous la forme d'une liste séparée par des virgules. Par exemple

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

Il est possible d'ajouter des espaces avant et après la virgule. Il est également possible d'omettre les guillemets autour des entrées si les chemins ne contiennent pas de virgules ou d'espaces.

Configuration des arguments pour les plugins de la plateforme

Le site qt.conf peut contenir un groupe Platforms, dont les clés sont des listes d'arguments délimitées par des virgules à transmettre au plugin de plateforme. Le nom de la clé est le nom du plugin de plate-forme, la première lettre étant en majuscule, suivie de Arguments.

Par exemple :

[Platforms]
WindowsArguments = fontengine=freetype

Le plugin de plateforme Windows utilisera le moteur de polices FreeType.

Comment gérer les installations parallèles d'anciennes versions de Qt ?

Pour les environnements qui nécessitent l'installation d'une version majeure antérieure de Qt, il est possible d'utiliser un qt.conf spécifique à la version. Ceci est souvent nécessaire dans les phases de transition d'une version de Qt à la suivante, ou pour éviter les conflits causés par un fichier existant sans version.

À cette fin, un fichier nommé qt6.conf peut être utilisé à la place du fichier qt.conf. Si les deux fichiers existent dans le répertoire décrit ci-dessus, qt6.conf est utilisé.