msvc2008
Table of Contents
Psi+ on MS Windows: Build Instructions (win64-msvc2019)
Microsoft Visual Studio 2019
Необходимый инструментарий
Скачиваем исходный код Psi+ из git-репозитория:
git clone https://github.com/psi-plus/psi-plus-snapshots.git cd psi-plus-snapshots
Скачиваем:
- CMake Можно использовать тот, что идет в комплекте с Qt
- Qt Online Installer Windows (требует регистрации на сайте)
- Psi+ Qt5 SDK MSVC2019 Win64 (СДК для сборки Psi+ ~30Мб)
Установка Инструментов сборки Psi+
- Сначала установим 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”. Поле установки нужно перезайти в систему, чтобы обновились переменные.
Конфигурирование Qt перед сборкой
- Нажимаем клавиши Win+Pause/Break и слева выбираем пункт Дополнительные параметры, в появившемся окне выбираем Переменные среды и в новом окне убеждаемся в наличии переменных: GSREAMER_1_0_ROOT_x86_64 и PSI_SDK_MSVC_WIN64
- Запускаем QtCreator, там в меню Инструменты выбираем Параметры
- Убедимся, что QtCreator нашел CMake, если не нашел добавляем его вручную
- Проверяем, что QtCreator нашел необходимые дебаггеры, если нужного нет - добавляем сами:
- Проверяем наличие необходимых компиляторов
- Проверяем наличие необходимого нам профиля Qt (у вас будут свои пути)
- Настраиваем среду сборки
- Настраиваем генератор CMake
- Дополнительно настраиваем флаги CMake по-умолчанию:
Компиляция Psi в программе QtCreator
- Запускаем 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+ выдают достаточно подробную информацию о процессе конфигурации.
msvc2008.txt · Last modified: 2024/06/16 11:24 by 127.0.0.1