Инструменты пользователя

Инструменты сайта


ru:msvc2008

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

Скачиваем:

Установка Инструментов сборки 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+ выдают достаточно подробную информацию о процессе конфигурации.

ru/msvc2008.txt · Последнее изменение: 2024/06/16 11:24 — kukuruzo

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki