Psi+ on MS Windows: Build Instructions (win64-msvc2019)

Скачиваем исходный код Psi+ из git-репозитория:

git clone https://github.com/psi-plus/psi-plus-snapshots.git
cd psi-plus-snapshots

Скачиваем:

• CMake Можно использовать тот, что идет в комплекте с Qt
• Microsoft Visual Studio 2019
• Qt Online Installer Windows (требует регистрации на сайте)
• Gstreamer runtime libraries 1.24.4
• Gstreamer development libraries 1.24.4
• Psi+ Qt5 SDK MSVC2019 Win64 (СДК для сборки Psi+ ~30Мб)

• Сначала установим CMake при помощи скачанного установщика. Можно пропустить и установить вместе с Qt (желательно ставить в каталог ближе к корню диска, например C:\cmake и добавить путь к CMake в PATH по просьбе установщика)
• Установим Microsoft Visual Studio 2019 Community Edition при помощи скачанного online-установщика (~12Гб места на диске)

рекомендуемый набор компонентов для установки показан на рисунке:

также можно воспользоваться пунктом импортировать конфигурацию, для этого нужно создать текстовый файл со следующим содержимым:

{
  "version": "1.0",
  "components": [
    "Microsoft.VisualStudio.Component.CoreEditor",
    "Microsoft.VisualStudio.Workload.CoreEditor",
    "Microsoft.VisualStudio.Component.Roslyn.Compiler",
    "Microsoft.Component.MSBuild",
    "Microsoft.VisualStudio.Component.TextTemplating",
    "Microsoft.VisualStudio.Component.Debugger.JustInTime",
    "Microsoft.VisualStudio.Component.VC.CoreIde",
    "Microsoft.VisualStudio.Component.Windows10SDK",
    "Microsoft.VisualStudio.Component.VC.Tools.x86.x64",
    "Microsoft.VisualStudio.Component.Windows10SDK.19041",
    "Component.CPython3.x64",
    "Microsoft.VisualStudio.Component.VC.Redist.14.Latest",
    "Microsoft.VisualStudio.ComponentGroup.NativeDesktop.Core",
    "Microsoft.VisualStudio.Component.VC.ATL",
    "Microsoft.VisualStudio.Component.VC.ASAN",
    "Microsoft.VisualStudio.Component.VC.Modules.x86.x64",
    "Microsoft.VisualStudio.Workload.NativeDesktop"
  ]
}

• Затем установим необходимый комплект Qt5 при помощи online-установщика, где выбираем Qt-5.15.2 MSVC2019 64bit (рекомендуется для SDK v29.0 в Tools выбираем CDB и убеждаемся, что выбран QtCreator (установленный комплект занимает около 7Гб)

• Устанавливаем библиотеки Gstreamer желательно устанавливать в один и тот же каталог и в максимальной конфигурации

• И наконец установим SDK, который содержит набор библиотек необходимых для сборки Psi+. При установке очень желательно включить пункт “Добавить запись в реестр Windows”. Поле установки нужно перезайти в систему, чтобы обновились переменные.

• Нажимаем клавиши Win+Pause/Break и слева выбираем пункт Дополнительные параметры, в появившемся окне выбираем Переменные среды и в новом окне убеждаемся в наличии переменных: GSREAMER_1_0_ROOT_x86_64 и PSI_SDK_MSVC_WIN64

• Запускаем QtCreator, там в меню Инструменты выбираем Параметры
• Убедимся, что QtCreator нашел CMake, если не нашел добавляем его вручную

• Проверяем, что QtCreator нашел необходимые дебаггеры, если нужного нет - добавляем сами:

• Проверяем наличие необходимых компиляторов

• Проверяем наличие необходимого нам профиля Qt (у вас будут свои пути)

• Настраиваем среду сборки

• Настраиваем генератор CMake

• Дополнительно настраиваем флаги CMake по-умолчанию:

• Запускаем QtCreator, если он еще не запущен.
• Открываем файл CMakeLists.txt из корневого каталога со скачанными исходными кодами Psi+
• Настраиваем проект

Можем включать / выключать необходимые типы сборки, которые потом можно выбрать в основном окне программы

• После настройки проекта начнется предварительное конфигурирование проекта результаты которого будут представлены на вкладке Основные сообщения

• Заходим в опции проекта и выбираем необходимые нам флаги конфигурации (не забываем нажимать Применить). Рекомендуемые мною настройки:
  • Обязательно включаем флаг DEV_MODE если необходим запуск Psi+ прямо из QtCreator
  • Добавляем следующие этапы сборки:

• После настройки советую зайти в пункт меню Сборка и там по очереди выполнить Очистить конфигурацию и Запустить CMake. Желательно делать так всегда, когда вы изменяете настройки проекта (меняете состояние флагов).
• Если все прошло успешно - запускаем сборку по Ctrl+B или выбрав в меню Сборка - Собрать проект psi-plus
• Сборка займет некоторое время и если пройдет успешно, вы можете запускать Psi+ прямо из QtCreator или посмотреть в настройках запуска проекта путь к собранным файлам

• Если что-то пошло не так, то сначала убедитесь, что у вас установлены все необходимые инструменты для сборки, заданы все необходимые переменные среды или настройте пути к SDK и Gstreamer в настройках проекта (возможно вам необходимо будет добавить необходимые переменные вручную).
• Описание флагов конфигурации смотрим тут
• Сборка SDK своими руками в этом разделе не описана, т.к. эта задача - нетривиальна и порой требует специальных навыков и знаний.

==== ПРИМЕЧАНИЯ ====

1. Для ускорения сборки под Windows можно воспользоваться утилитой Ccache, для этого нужно распаковать архив с программой в удобный каталог и добавить этот каталог в переменную PATH.

2. Если у вас что-то не получается - внимательно читайте вывод CMake, cmake-скрипты Psi/Psi+ выдают достаточно подробную информацию о процессе конфигурации.