Uso de qt.conf
Puedes utilizar el archivo « qt.conf » para anular las rutas de « QLibraryInfo » o para especificar los argumentos que se pasarán a los complementos 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:
:/qt/etc/qt.confutilizando el sistema de recursos- en plataformas Apple, en el directorio «Resource» dentro del paquete de la aplicación; por ejemplo, «
assistant.app/Contents/Resources/qt.conf» en macOS. - en el directorio que contiene el ejecutable de la aplicación, es decir, QCoreApplication::applicationDirPath() + QDir::separator() + «qt.conf»
Sobrescribir rutas
El archivo « qt.conf » se puede utilizar para anular las rutas predeterminadas que utiliza Qt. Se puede acceder a estas rutas mediante la clase « QLibraryInfo ».
Sin qt.conf, las bibliotecas de Qt utilizarán las rutas predeterminadas para buscar complementos, traducciones, etc. Es posible que estas rutas no existan en el sistema de destino o que no sean accesibles. Por este motivo, es posible que necesites qt.conf para que las bibliotecas de Qt busquen en otra ubicación.
El archivo debe contener un grupo « Paths » con una o más entradas que se correspondan con los valores de la enumeración QLibraryInfo::LibraryLocation. Consulta la documentación de QLibraryInfo para obtener más detalles sobre el significado de las distintas ubicaciones.
| Entrada | Valor por defecto |
|---|---|
Prefix | QCoreApplication::applicationDirPath() |
Documentation | doc |
Headers | include |
Libraries | lib |
LibraryExecutables | libexec en Unix, bin en Windows |
Binaries | bin |
Plugins | plugins |
QmlImports | qml |
ArchData | . |
Data | . |
Translations | translations |
Examples | examples |
Tests | tests |
Settings | . |
Se utilizan rutas absolutas tal y como se especifican en el archivo qt.conf. Todas las rutas son relativas a Prefix. En Windows y Linux, la ruta Prefix es relativa al directorio que contiene el ejecutable de la aplicación (QCoreApplication::applicationDirPath()). En macOS, la ruta Prefix es relativa a Contents dentro del paquete de la aplicación. Por ejemplo, application.app/Contents/PlugIns/ es la ubicación predeterminada para cargar los complementos de Qt. Ten en cuenta que los complementos deben colocarse en subdirectorios específicos dentro del directorio plugins (consulta «Cómo crear complementos de Qt» para obtener más detalles).
Nota: Por motivos de compatibilidad con versiones anteriores, la entrada Qml2Imports es válida en la sección Paths y se trata como alternativa a QmlImports.
Por ejemplo, un archivo qt.conf podría contener lo siguiente:
[Paths]
Prefix = /some/path
Translations = i18nNota: El carácter de barra invertida se considera un carácter especial en los archivos INI (véase QSettings). Por lo tanto, se recomienda utilizar barras inclinadas también en las rutas de acceso en Windows. De lo contrario, se requiere un carácter de escape:
Prefix = c:\\SomePathDesde Qt 6.8, es posible indicar más de una ruta por entrada. Deben indicarse como una lista separada por comas. Por ejemplo
QmlImports = "/path/to/imports1","/path/to/imports2"Se pueden añadir espacios antes y después de la coma. También se pueden omitir las comillas que enmarcan las entradas si las rutas no contienen comas ni espacios.
Configuración de los argumentos de los complementos de plataforma
El archivo « qt.conf » puede contener un grupo « Platforms », cuyas claves son listas delimitadas por comas de los argumentos que se van a pasar al complemento de la plataforma. El nombre de la clave es el nombre del complemento de la plataforma con la primera letra en mayúscula, seguido de « Arguments ».
Por ejemplo:
[Platforms]
WindowsArguments = fontengine=freetypeharía que el complemento de la plataforma Windows utilizara el motor de fuentes FreeType.
Cómo gestionar las instalaciones paralelas de versiones anteriores de Qt
En entornos que también requieran la instalación de una versión principal anterior de Qt, es posible utilizar un archivo qt.conf específico para cada versión. Esto suele ser necesario en las fases de transición de una versión de Qt a la siguiente, o para evitar conflictos causados por un archivo existente sin especificar la 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 utiliza « qt6.conf ».
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.