Подробные руководства по сборке — Windows

Переменные qmake:

• PREFIX: путь установки для $MAKE install.
• WINDOWS_PREFER_OPENCONSOLE=ON (на этапе make): предпочесть совместимый с UTF-8 OpenConsole.exe.
  • OpenConsole.exe является компонентом Windows консоли, который в версии 1.18 получил поддержку вывода UTF-8.
  • OpenConsole.exe требует интерфейса ConPTY, добавленного в Windows 10 1809.

Примечание относительно Windows на ARM:

• Краснопанда C++ может быть собрана как ARM64 версия только на Windows 11 ARM64 (готовое приложение должно работать на Windows 10 ARM64, но это не было протестировано).
  • Неподдерживаемый тип хоста ARM64EC ("совместимость эмуляцией"), то есть нельзя использовать ARM64EC цепочку инструментов для сборки Краснопанды C++.
  • Теоретически поддерживается цель ARM64EC, то есть если верхний уровень инструментов поддерживает ARM64EC, то Краснопанда C++ может создавать программы и библиотеки ARM64EC.
• Поскольку Windows 11 Insider Preview Build 25905 отменил ARM32, поддержка ARM32 больше не будет добавлена в Краснопанду C++.

Ручная сборка в окружении MSYS2

Предварительные условия:

0. Windows 8.1 x64 или более новая версия, или Windows 11 ARM64.
1. Установите MSYS2.
2. В выбранной среде установите цепочку инструментов и библиотеки Qt 5:

   pacman -S $MINGW_PACKAGE_PREFIX-toolchain $MINGW_PACKAGE_PREFIX-qt5-static

Сборка:

1. В выбранной среде установите переменные:

   SRC_DIR="/c/src/redpanda-src" # Например, "C:\src\redpanda-src"
   BUILD_DIR="/c/src/redpanda-build" # Например, "C:\src\redpanda-build"
   INSTALL_DIR="/c/src/redpanda-pkg" # Например, "C:\src\redpanda-pkg"
2. Перейдите в каталог сборки:

   rm -rf "$BUILD_DIR" # Полностью очистить каталог сборки, если требуется
   mkdir -p "$BUILD_DIR" && cd "$BUILD_DIR"
3. Настройте, соберите и установите:

   $MSYSTEM_PREFIX/qt5-static/bin/qmake PREFIX="$INSTALL_DIR" "$SRC_DIR/Red_Panda_CPP.pro"
   mingw32-make -j$(nproc)
   mingw32-make install

Qt.io библиотеки Qt + MinGW цепочки инструментов или MSVC цепочки инструментов

Предварительные условия:

0. Windows 10 x64 или более новая версия. Поддержка ARM64 не предусмотрена.
   • Для MSVC цепочек инструментов Windows должна предоставлять глобальную поддержку языков через Unicode UTF-8.
1. Установите Qt с помощью Qt.io или зеркало сайта онлайн-инсталлятора.
   • Выберите группы библиотек Qt ("Qt" группа, "Qt 5.15.2" подгруппа, отметьте "MinGW 8.1.0 32-bit", "MinGW 8.1.0 64-bit", "MSVC 2019 32-bit", "MSVC 2019 64-bit").
   • Для MinGW цепочек инструментов выберите соответствующую цепочку инструментов ("Qt" группа, "Developer and Designer Tools" подгруппа, "MinGW 8.1.0 32-bit" или "MinGW 8.1.0 64-bit", совпадающую с версией библиотек).
   • По необходимости выберите Qt Creator ("Qt" группа, "Developer and Designer Tools" подгруппа, рекомендовано выбрать при использовании MSVC цепочек инструментов для поддержки параллельной сборки).

Сборка:

1. Откройте окружение Qt из меню "Пуск".
2. В окружении Qt установите переменные:

   rem Добавление кавычек не обязательно даже если путь содержит пробелы
   set SRC_DIR=C:\src\redpanda-src
   set BUILD_DIR=C:\src\redpanda-build
   set INSTALL_DIR=C:\src\redpanda-pkg
   rem Только для MSVC цепочек инструментов
   set VS_INSTALL_PATH=C:\Program Files\Microsoft Visual Studio\2022\Community
   rem Только для MSVC цепочек инструментов; или x86
   set VC_ARCH=amd64
   rem Только для MSVC цепочек инструментов; если Qt Creator не установлен, не устанавливайте эту переменную
   set QT_CREATOR_DIR=C:\Qt\Tools\QtCreator
3. Перейдите в каталог сборки:

   rem Полностью очистить каталог сборки, если требуется
   rmdir /s /q "%BUILD_DIR%"
   mkdir "%BUILD_DIR%" && cd /d "%BUILD_DIR%"
4. Настройте, соберите и установите. Для MinGW цепочек инструментов:

   qmake PREFIX="%INSTALL_DIR%" "%SRC_DIR%\Red_Panda_CPP.pro"
   mingw32-make -j%NUMBER_OF_PROCESSORS%
   mingw32-make install
   windeployqt "%INSTALL_DIR%\RedPandaIDE.exe"
   Для MSVC цепочек инструментов:

   call "%VS_INSTALL_PATH%\Common7\Tools\VsDevCmd.bat" -arch=%VC_ARCH%
   qmake PREFIX="%INSTALL_DIR%" "%SRC_DIR%\Red_Panda_CPP.pro"
   
   set JOM=%QT_CREATOR_DIR%\bin\jom\jom.exe
   if "%QT_CREATOR_DIR%" neq "" (
      "%JOM%" -j%NUMBER_OF_PROCESSORS%
      "%JOM%" install
   ) else (
      nmake
      nmake install
   )
   windeployqt "%INSTALL_DIR%\RedPandaIDE.exe"

Расширенные опции: статические библиотеки Qt vcpkg + MSVC цепочки инструментов

Предварительные условия:

0. Windows 10 x64 или более новая версия. Поддержка ARM64 не предусмотрена.
   • Windows должна предоставлять глобальную поддержку языков через Unicode UTF-8.
1. Установите Visual Studio 2017 или более новую версию, или "Visual Studio Build Tools 2017" или более новую версию, содержащие рабочий профиль "Desktop development with C++".
   • В разделе "Details of installation" ("Информация о деталях установки"), в разделе "Desktop development with C++", выберите хотя бы один "MSVC x86/x64 build tools" и одну версию Windows SDK.
2. Установите независимую версию vcpkg.
3. Установите Qt с помощью vcpkg.

   $TARGET = "x64-windows-static" # или "x86-windows-static"
   vcpkg install qt5-base:$TARGET qt5-svg:$TARGET qt5-tools:$TARGET qt5-translations:$TARGET

Сборка в PowerShell (Core) или Windows PowerShell с использованием VS 2019 или более новой версии:1. Установите переменные:

$SRC_DIR = "C:\src\redpanda-src"
$BUILD_DIR = "C:\src\redpanda-build"
$INSTALL_DIR = "C:\src\redpanda-pkg"
$VCPKG_ROOT = "C:\src\vcpkg"
$VCPKG_TARGET = "x64-windows-static" # или "x86-windows-static"
$VS_INSTALL_PATH = "C:\Program Files\Microsoft Visual Studio\2022\Community"
$VC_ARCH = "amd64" # или "x86"
$JOM = "$VCPKG_ROOT\downloads\tools\jom\jom-1.1.3\jom.exe" # проверьте номер версии

2. Перейдите в каталог сборки:

   Remove-Item -Recurse -Force "$BUILD_DIR" # полностью очистить каталог сборки, если требуется
   (New-Item -ItemType Directory -Force "$BUILD_DIR") -and (Set-Location "$BUILD_DIR")
3. Настройте, соберите и установите:

   Import-Module "$VS_INSTALL_PATH\Common7\Tools\Microsoft.VisualStudio.DevShell.dll"
   Enter-VsDevShell -VsInstallPath "$VS_INSTALL_PATH" -SkipAutomaticLocation -DevCmdArguments "-arch=$VC_ARCH"
   & "$VCPKG_ROOT\installed\$VCPKG_TARGET\tools\qt5\bin\qmake.exe" PREFIX="$INSTALL_DIR" "$SRC_DIR\Red_Panda_CPP.pro"
   & "$JOM" "-j${Env:NUMBER_OF_PROCESSORS}"
   & "$JOM" install

Сборка в командной строке с использованием VS 2017 или более новой версии:

1. Откройте подходящее окружение VC из меню "Пуск".
2. Установите переменные:

   rem Добавление кавычек не обязательно даже если путь содержит пробелы
   set SRC_DIR=C:\src\redpanda-src
   set BUILD_DIR=C:\src\redpanda-build
   set INSTALL_DIR=C:\src\redpanda-pkg
   set VCPKG_ROOT=C:\src\vcpkg
   rem или x86-windows-static
   set VCPKG_TARGET=x64-windows-static
   rem проверьте номер версии
   set JOM=%VCPKG_ROOT%\downloads\tools\jom\jom-1.1.3\jom.exe
3. Перейдите в каталог сборки:

   rem полностью очистить каталог сборки, если требуется
   rmdir /s /q "%BUILD_DIR%"
   mkdir "%BUILD_DIR%" && cd /d "%BUILD_DIR%"
4. Настройте, соберите и установите:

   "%VCPKG_ROOT%\installed\%VCPKG_TARGET%\tools\qt5\bin\qmake.exe" PREFIX="%INSTALL_DIR%" "%SRC_DIR%\Red_Panda_CPP.pro"
   "%JOM%" -j%NUMBER_OF_PROCESSORS%
   "%JOM%" install