Uso de qt.conf

Puede utilizar el archivo qt.conf para anular rutas o especificar argumentos que se pasarán a los plugins de la plataforma.

Formato y ubicación

El archivo qt.conf es un archivo de texto INI, tal y como se describe en la documentación de QSettings.

QLibraryInfo cargará qt.conf desde una de las siguientes ubicaciones:

1. :/qt/etc/qt.conf utilizando el sistema de recursos
2. en macOS, en el directorio Resource dentro del paquete de la aplicación, por ejemplo assistant.app/Contents/Resources/qt.conf
3. en el directorio que contiene el ejecutable de la aplicación, por ejemplo QCoreApplication::applicationDirPath() + QDir::separator() + "qt.conf"

Anulación de rutas

El archivo qt.conf se puede utilizar para anular las rutas codificadas que se compilan en la biblioteca Qt. Estas rutas son accesibles utilizando la clase QLibraryInfo. Sin qt.conf, las funciones de QLibraryInfo devuelven estas rutas codificadas; en caso contrario, devuelven las rutas especificadas en qt.conf.

Sin qt.conf, las librerías Qt usarán las rutas codificadas para buscar plugins, traducciones, etcétera. Estas rutas pueden no existir en el sistema de destino, o pueden no ser accesibles. Debido a esto, es posible que necesite qt.conf para hacer que las bibliotecas Qt busquen en otro lugar.

El archivo debe tener un grupo Paths que contenga las entradas que corresponden a cada valor del enum QLibraryInfo::LibraryLocation. Ver la documentación de QLibraryInfo para más detalles sobre el significado de las distintas localizaciones.

Se utilizan las rutas absolutas especificadas en el archivo qt.conf. Todas las rutas son relativas a Prefix. En Windows y Linux, Prefix es relativa al directorio que contiene el ejecutable de la aplicación (QCoreApplication::applicationDirPath()). En macOS, Prefix es relativa a Contents en el paquete de la aplicación. Por ejemplo, application.app/Contents/plugins/ es la ubicación por defecto para cargar los plugins de Qt. Tenga en cuenta que los plugins deben colocarse en subdirectorios específicos bajo el directorio plugins (consulte Cómo crear plugins Qt para más detalles).

Por ejemplo, un archivo qt.conf podría contener lo siguiente:

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

Prefix = c:\\SomePath

Desde Qt 6.8, es posible proporcionar más de una ruta por entrada. Deben proporcionarse como una lista separada por comas. Por ejemplo

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

Es posible añadir espacios antes y después de la coma. También es posible omitir las comillas alrededor de las entradas si la ruta no contiene comas ni espacios.

Configuración de argumentos para los plugins de la plataforma

qt.conf puede contener un grupo Platforms, cuyas claves son listas delimitadas por comas de argumentos que se pasarán al plugin de plataforma. El nombre de la clave es el nombre del plugin de plataforma con la primera letra en mayúscula seguida de Arguments.

Por ejemplo:

[Platforms]
WindowsArguments = fontengine=freetype

haría que el complemento de plataforma de Windows utilizara el motor de fuentes FreeType.

Cómo lidiar con instalaciones paralelas de versiones antiguas de Qt

Para entornos que requieren la instalación de una versión anterior de Qt, es posible utilizar un qt.conf específico para cada versión. Esto suele ser necesario en fases de transición de una versión de Qt a la siguiente, o para evitar conflictos causados por un archivo existente sin versión.

Para ello, se puede utilizar un archivo llamado qt6.conf en lugar del archivo qt.conf. Si ambos archivos existen en el directorio descrito anteriormente, se utilizará qt6.conf.