Программа LibraryCollector предназначена для получения списка зависимостей.
Под зависимостями имеются ввиду динамические библиотеки *.dll/*.so модули и плагины Qt используемые программой. LibraryCollector позволяет выполнить автоматическое копирование этих зависимостей/библиотек в указанную папку для последующего переноса программы на другой компьютер где не установлен Qt или последующего создания из них инсталятора. При копировании LibraryCollector учитывает иерархию папок расположения плагинов Qt.
В принципе LibraryCollector это моя альтернатива windeployqt и CQtDeployer с тем отличием что сборка идет на основе анализа библиотек(модулей) уже запущенного процесса собираемой программы на машине на которой есть Qt (запущенной из QtCreator).
Прогнать Вашу программу по всему функционалу, что бы она подгрузила все плагины и qml библиотеки.
Запустить LibraryCollector.
Указать полный путь к исполняемому файлу Вашей программы (в LibraryCollector). Это можно сделать с помощью кнопки "+" указав курсором на окно Вашей программы.
Указать путь к QTDIR - путь где расположена сама библиотека Qt (в ней расположены папки bin, plugins, qml идр)
Указать в поле ввода "to" куда будут собираться все библиотеки и копироваться исполняемый файл.
По умолчанию все копирует в папку с исполняемым файлом.
В этом поле с помощью регулярных выражений автоматически подменяются:
<ExeDir> - на путь к папке где лежит исполняемый файл программы
<BaseName> - на имя исполняемого файла без расширения.
Нажать кнопку "Update" - в окне LibraryCollector отобразятся все подгруженные Вашей программой библиотеки разбитые по группам.Стандартные библиотеки будут отмечены галочкой.Если Вы используете свои библиотеки или библиотеки сторонних разработчиков Вы должны их выбрать в окне (отметить галочкой).
Для сборки - нажать кнопку "Copy", LibraryCollector скопирует все выбранные библиотеки с учетом необходимой вложенности/иерархии папок.
Вы можете менять и модифицировать js- cценарии для определения, группировки, копирования библиотек под себя.
Эти библиотеки отображаются таблице импорта исполняемого файла, их можно легко определить проанализировав его.
Раньше поиск/расположение этих библиотек соответствовала стандартным правилам поиска библиотеки в системе https://msdn.microsoft.com/ru-... .120).aspx
Но где-то с Qt 5.5.1 разработчики решили явно зашивать путь внутрь Qt5Core (хардкорно)
Поэтому при сборке приходится копировать Qt5Core, а затем патчить ее указывая в переменной qt_prfxpath текущую директорию. Примечание: в js- сценарии за патчинг отвечает utils.patchFile().
В более поздних версиях Qt патчинг убрали, не ужели патчинг было неудачное решения? ))
Плагины.
Эти библиотеки содержаться в папке QTDIR/plugins
Особенность плагинов в том что в отличии от модулей они могут грузиться не сразу при запуске программы, а подгружаться по мере необходимости, например при выполнении кода где идет подключение к БД, или при смене элементов интерфейса qml.
Они не отображаются в таблице импорта исполняемого файла, поэтому возникла необходимость анализа именно запущенного процесса.
Плагины разбросаны/сгруппированы по подпапкам, т.е. есть своя иерархия папок/файлов которую нужно соблюдать при их копировании.
Примечание: в js-сценарии за копирование файлов отвечает utils.copyFile(libName, toDir, relDir) которая позволяет третьим параметром задать папку относительно которой копировать файлы.
Библиотеки qml.
Эти библиотеки содержаться в папке QTDIR/qml.
То что касается плагинов так же касается и qml библиотек.
В отличии от плагинов для нормальной подгрузки требуется еще файлы qmldir, по этому их тоже приходится искать и копировать.
Исполняемый файл QtWebEngineProcess и файлы из папки QTDIR/resources необходимы при использовании Qt WebEngine.
Примечание: в LibraryCollector необходимость копирования QtWebEngineProcess определяется наличием Qt5WebEngineCore,Qt5WebEngineWidgets в зависимостях
И так LibraryCollector что бы определить все используемое анализирует Ваш процесс используя системные функции (Windows) и просматривая системные файлы (Linux), получая список подгруженных библиотек раскидывает их по группам.
Для определения принадлежности библиотеки к группе модулей,плагинам и qml- библиотекам производится сравнение полных путей на предмет вложенности в QTDIR/bin, QTDIR/plugins, QTDIR/qml соответственно.
Примечание: в js-сценарии для проверки вложенности используется utils.isSubPath()
Другие группы как правило определяются регулярными выражениями.
Js - сценарий придает гибкости LibraryCollector и дает возможность изменить поведение сборки для определенных приложений.
Скрипт должен содержать три функции которые будут вызываться в процессе работы LibraryCollector, и примерно должен выглядеть так:
Javascript
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
function init(){/* Ваш код инициализации, тут можно определить на какие группы будем распределять библиотеки */}function update(libs)// libs - список библиотек{/* Тут должен быть код анализа и распределения библиотек по группам*/}function copy(toDir)// toDir папка в которую нужно собирать.{/* Код копирования библиотек*/}
init() вызывается при смене скрипта в выпадающем списке, а так же при на кнопку "Clear".
update() и copy() вызываются при нажатии на соответствующие кнопки.
Внутри скрипта доступны следующие глобальные объекты:
log- дает возможность выводить сообщение в окно лога LibraryCollector
Например:
Javascript
1
log.addInfo("hello!","green");
Javascript
1
log.addError('ups!')
tree -дерево зависимостей, позволяет выводить библиотеки.
Например:
Javascript
1
2
var binGroupIndex = tree.addGroup("bin")// добавление группы "bin", возвращает индекс созданной группы