Главная · Все пространства имен · Все классы · Основные классы · Классы по группам · Модули · Функции

Использование qt.conf

Файл qt.conf подменяет жёстко закодированные пути, которые скомпилированы в библиотеку Qt. Эти пути доступны с помощью класса QLibraryInfo. Без qt.conf функции в QLibraryInfo вернут эти жёстко закодированные пути; в противном случае они вернут пути как указано в qt.conf.

Без qt.conf библиотеки Qt будут использовать жёстко закодированные пути для поиска подключаемых модулей, переводов и так далее. Эти пути могут не существовать на целевой системе, или же они могут быть недоступны. В связи с этим вам нужен qt.conf, чтобы искать библиотеки Qt в другом месте.

QLibraryInfo загружает qt.conf из одного из следующих мест:

1. используя систему ресурсов - :/qt/etc/qt.conf
2. в Mac OS X - в каталоге Resource внутри пакета приложения, например, assistant.app/Contents/Resources/qt.conf
3. в каталоге с исполняемым файлом приложения, т.е. QCoreApplication::applicationDirPath() + QDir::separator() + "qt.conf"

Файл qt.conf - это текстовый INI-файл, как описано в документации к QSettings. Файл должен содержать секцию Paths, в которой содержатся записи, соответствующие каждому значению перечисления QLibraryInfo::LibraryLocation. Подробности о значении различных мест расположения смотрите в документации QLibraryInfo.

Абсолютные пути используются как указано в файле qt.conf. Все пути являются относительными к префиксу Prefix. В Windows и X11 Prefix относится к каталогу, содержащему исполняемый файл приложения (QCoreApplication::applicationDirPath()). В Mac OS X Prefix относится к Contents в пакете приложения. Например, application.app/Contents/plugins/ - место по умолчанию для загрузки подключаемых модулей Qt. Обратите внимание на то, что подключаемые модули нужно поместить в заданные подкаталоги в каталоге plugins (подробнее смотрите в Как создать подключаемые модули Qt).

Например, файл qt.conf может содержать следующее:

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

Подсекции секции Paths можно использовать для указания специфичных версий библиотек Qt. Такие подсекции имеют вид Paths/x.y.z, где x - главный номер версии библиотек Qt, y - младший номер и z - уровень патчей. Используются подсекции в наибольшей степени соответствующие текущей версии Qt. Если ни одна подсекция не совпала, то в качестве резервной используется секция Paths. Значения младшей версии и уровня патчей может быть опущены, в этом случае они по умолчанию равны нулю.

Например, даны следующие группы:

 Paths
 Paths/4
 Paths/4.1
 Paths/4.2.5
 Paths/6

Текущая версия будет соответствовать как показано ниже:

• 4.0.1 совпадает с Paths/4
• 4.1.5 совпадает с Paths/4.1
• 4.6.3 matches Paths/4.2.5
• 5.0.0 совпадает с Paths
• 6.0.2 совпадает с Paths/6