Дополнительные инструкции сборки для Windows

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

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

Примечания для Windows на ARM:

• Red Panda C++ может быть собран для ARM64 ABI только на Windows 11 ARM64, хотя он должен работать (хотя это ещё не проверено) на Windows 10 ARM64.
  • Поддержка хоста ARM64EC ("совместимого с эмуляцией") не предусмотрена, то есть Red Panda C++ не может быть собран с использованием ARM64EC инструментальной цепочки.
  • Целевой объект ARM64EC (теоретически) поддерживается, то есть Red Panda C++ будет создавать ARM64EC бинарники, если upstream toolchain поддерживает ARM64EC.
• В связи с устареванием ARM32 в Windows 11 Insider Preview Build 25905 поддержка ARM32 никогда не будет добавлена.

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

Необходимое оборудование:

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

   pacman -S \
     $MINGW_PACKAGE_PREFIX-{toolchain,qt5-static} \
     git

Для сборки:

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 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 не поддерживается.
   • Для MSVC инструментальной цепочки Windows должна использовать Unicode UTF-8 для поддержки мировых языков.
1. Установите Visual Studio 2017 или более позднюю версию, или Visual Studio Build Tools 2017 или более позднюю версию, с рабочим набором Desktop Development with C++.
   • В панели Installation Details под рабочим набором Desktop Development with C++ выберите как минимум один MSVC x86/x64 build tools и один Windows SDK.
2. Установите standalone 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

Для сборки с использованием VS 2019 или более поздней версии в PowerShell (Core) или Windows PowerShell:

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