Utilisation de qt.conf

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

Format et emplacement

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

QLibraryInfo chargera le fichier « qt.conf » à partir de l'un des emplacements suivants :

1. :/qt/etc/qt.conf à l’aide du système de ressources
2. sur les plateformes Apple, dans le répertoire Resource situé à l'intérieur du bundle de l'application, par exemple assistant.app/Contents/Resources/qt.conf sous macOS.
3. dans le répertoire contenant l'exécutable de l'application, c'est-à-dire QCoreApplication::applicationDirPath() + QDir::separator() + "qt.conf"

Remplacer les chemins d'accès

Le fichier ` qt.conf ` peut être utilisé pour redéfinir les chemins par défaut utilisés par Qt. Ces chemins sont accessibles via la classe ` QLibraryInfo `.

Sans le fichier ` qt.conf`, les bibliothèques Qt utiliseront les chemins par défaut pour rechercher les plugins, les traductions, etc. Il se peut que ces chemins n’existent pas sur le système cible ou qu’ils ne soient pas accessibles. C’est pourquoi vous aurez peut-être besoin du fichier ` qt.conf ` pour que les bibliothèques Qt cherchent ailleurs.

Le fichier doit comporter un groupe « Paths » contenant une ou plusieurs entrées correspondant aux valeurs de l’énumération QLibraryInfo::LibraryLocation. Consultez la documentation relative à QLibraryInfo pour plus de détails sur la signification des différents emplacements.

Les chemins absolus sont utilisés tels que spécifiés dans le fichier qt.conf. Tous les chemins sont relatifs au répertoire Prefix. Sous Windows et Linux, le chemin Prefix est relatif au répertoire contenant l’exécutable de l’application (QCoreApplication::applicationDirPath()). Sous macOS, le chemin Prefix est relatif au répertoire Contents dans le bundle de l’application. 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 du répertoire plugins (voir Comment créer des plugins Qt pour plus de détails).

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

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

Prefix = c:\\SomePath

Depuis Qt 6.8, il est possible de fournir plusieurs chemins d’accès par entrée. Ceux-ci doivent être indiqués sous forme de 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 ni virgules ni espaces.

Configuration des arguments des plugins de plateforme

Le fichier « qt.conf » peut contenir un groupe « Platforms », dont les clés sont des listes d'arguments séparées par des virgules à transmettre au plugin de plateforme. Le nom de la clé correspond au nom du plugin de plateforme, dont la première lettre est en majuscule, suivi de « Arguments ».

Par exemple :

[Platforms]
WindowsArguments = fontengine=freetype

cela entraînerait l'utilisation du moteur de polices FreeType par le plugin de la plateforme Windows.

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

Pour les environnements qui nécessitent également l'installation d'une version majeure antérieure de Qt, il est possible d'utiliser un fichier qt.conf spécifique à chaque version. Cela s'avère souvent nécessaire lors des 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, c'est le fichier « qt6.conf » qui est utilisé.