Компиляция для Windows

Автор: Кан Лин kl222@126.com
Переводчик: Аллан Нордхой epost@anotheragency.no

Среда

Операционная система

Windows 10, версия 20H2 (19042.985)

QtCreator

Версия: v11.0.0 .
Рекомендуется использовать версию v5.0.2 или более позднюю.
В предыдущих версиях отсутствует поддержка CMake.

Инструменты

• Компилятор
  • Visual Studio
    • Домашняя страница
      • https://visualstudio.microsoft.com/vs/
      • http://msdn.microsoft.com/zh-cn/vstudio
      • https://visualstudio.microsoft.com/zh-hans/downloads/
    • Версия:
      • Visual Studio 2013
      • Visual Studio 2015
      • Visual Studio 2017
      • Visual Studio 2019
      • Visual Studio 2022
    • Ключ Visual Studio: https://github.com/KangLin/Documents/blob/master/c/VisualStudioKey.md
    • Текущая версия: VS 2017
• Windows SDK: https://developer.microsoft.com/en-us/windows/downloads/sdk-archive
  Установите SDK, соответствующий вашей операционной системе. (Должен быть установлен CDB, требуется отладка Qt.)
• [ДОПОЛНИТЕЛЬНО] Windows Driver Kit: https://docs.microsoft.com/zh-cn/windows-hardware/drivers/download-the-wdk
• DirectX: https://support.microsoft.com/zh-cn/topic/%E5%A6%82%E4%BD%95%E5%AE%89%E8%A3%85%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC%E7%9A%84-directx-d1f5ffa5-dae2-246c-91b1-ee1e973ed8c2
  Требуется для запуска Qt.
• Qt
  • Qt (официальный выпуск): https://download.qt.io/official_releases/qt/
    Текущая версия: Qt 6.7.0
  • IDE: Qt Creator. Рекомендуется использовать версию v5.0.2 или более позднюю.
    Текущая версия: 12.0.2 В предыдущих версиях отсутствует поддержка CMake.
• Git: https://www.git-scm.com/
• CMake: https://www.cmake.org/ Версия: 3.27.0
• Doxygen: http://www.doxygen.nl/
• Nsis: https://nsis.sourceforge.io/Download
• vcpkg: https://github.com/microsoft/vcpkg

Компиляция

См.: Компиляция интеграции

Библиотеки зависимостей

• [ОБЯЗАТЕЛЬНО] RabbitCommon: https://github.com/KangLin/RabbitCommon
• [ОБЯЗАТЕЛЬНО] Openssl: Требуется для запуска Qt.
• [ДОПОЛНИТЕЛЬНО] RFB
  • [Дополнительно] RabbitVNC: https://github.com/KangLin/RabbitVNC
  • [ДОПОЛНИТЕЛЬНО] LibVNCServer: https://github.com/LibVNC/libvncserver
  • [ДОПОЛНИТЕЛЬНО] TigerVNC: https://github.com/KangLin/tigervnc
• [ДОПОЛНИТЕЛЬНО] FreeRDP: https://github.com/FreeRDP/FreeRDP
• [ДОПОЛНИТЕЛЬНО] SSH
  • libssh:
    • https://www.libssh.org
    • API libssh
  • libssh2:
    • https://www.libssh2.org/
    • https://github.com/libssh2/libssh2
• [ДОПОЛНИТЕЛЬНО] QTermWidget: https://github.com/lxqt/qtermwidget
• [ДОПОЛНИТЕЛЬНО] libtelnet: https://github.com/seanmiddleditch/libtelnet
• [ДОПОЛНИТЕЛЬНО] libdatachannel: https://github.com/paullouisageneau/libdatachannel
• [ДОПОЛНИТЕЛЬНО] QXmpp: https://github.com/qxmpp-project/qxmpp
• [ДОПОЛНИТЕЛЬНО] QtService: https://github.com/KangLin/qt-solutions/
• [ДОПОЛНИТЕЛЬНО] PcapPlusPlus: https://github.com/seladb/PcapPlusPlus
• [ДОПОЛНИТЕЛЬНО] FFMPEG: Мультимедийные возможности обязательны

RabbitCommon

Эта библиотека по умолчанию размещается на том же уровне каталога, что и проект. Если нет, вы должны указать параметры CMake: -DRabbitCommon_ROOT=[путь установки RabbitCommon]

git clone https://github.com/KangLin/RabbitCommon.git

FreeRDP

• Используйте vcpkg

  • Расположение исходного кода: https://github.com/microsoft/vcpkg/

    git clone https://github.com/microsoft/vcpkg.git
    cd vcpkg
    bootstrap-vcpkg.bat
    vcpkg install freerdp

  • Укажите CMake Клонирование проекта qxmpp

• git clone https://github.com/qxmpp-project/qxmpp.git

Переход в каталог проекта

• cd qxmpp

Создание каталога для сборки

• mkdir build

Перемещение в каталог сборки

• cd build

Настройка параметров CMake

• cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=%CD%/install -DQt5_DIR=[путь установки Qt]/lib/cmake/Qt5

Сборка проекта с конфигурацией Release и установка

• cmake --build . --config Release --target install

• Укажите параметры CMake: -DQXmpp_DIR=[путь установки QXmpp]/lib/cmake/qxmpp

QTermWidget (в настоящее время не поддерживается в Windows)

• Скомпилируйте из исходного кода

  • Расположение исходного кода: https://github.com/lxqt/qtermwidget

    • Укажите параметры CMake: -Dqtermwidget5_DIR=[путь установки qtermwidget]/lib/cmake/qtermwidget5

libssh

• Используйте vcpkg

  • Расположение исходного кода: https://github.com/microsoft/vcpkg/

    • cd vcpkg
    • vcpkg install libssh
    • Укажите параметры CMake: -DCMAKE_TOOLCHAIN_FILE=[путь установки vcpkg]/scripts/buildsystems/vcpkg.cmake

• Скомпилируйте из исходного кода

  • Расположение исходного кода: https://www.libssh.org

    • Укажите параметры CMake: -Dlibssh_DIR=[путь установки libssh]/lib/cmake/libssh

QtService

• Скомпилируйте из исходного кода

  • Расположение исходного кода: https://github.com/KangLin/qt-solutions/

    • git clone https://github.com/KangLin/qt-solutions.git
    • cd qt-solutions
    • mkdir build
    • cd build
    • cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=%CD%/install
    • cmake --build . --config Release --target install
    • Укажите параметры CMake: -DQtService_DIR=[путь установки QtService]/lib/cmake/QtService

PcapPlusPlus

• Скомпилируйте из исходного кода

  • Расположение исходного кода: https://github.com/seladb/PcapPlusPlus

    • Укажите параметры CMake: -DPcapPlusPlus_DIR=[путь установки PcapPlusPlus]/lib/cmake/pcapplusplus
    • git clone https://github.com/seladb/PcapPlusPlus.git

• Используйте vcpkg

  • Расположение исходного кода: https://github.com/microsoft/vcpkg/

    • git clone https://github.com/microsoft/vcpkg.git
    • cd vcpkg
    • vcpkg install pcapplusplus

Компиляция этого проекта

• Расположение проекта: https://github.com/KangLin/RabbitRemoteControl

• Загрузите исходный код:

  • git clone https://github.com/KangLin/RabbitRemoteControl.git

• Параметры CMake:

  • RabbitCommon_ROOT: расположение исходного кода RabbitCommon
  • BUILD_CLIENT: скомпилировать клиент. по умолчанию включено
  • BUILD_SERVICE: скомпилировать сервис. зависимость по умолчанию — наличие QtService
  • BUILD_PLUGINS: скомпилировать плагины. по умолчанию включено
  • BUILD_APP: скомпилировать приложение. по умолчанию включено
  • BUILD_DOCS: создать документацию. по умолчанию отключено
  • BUILD_SHARED_LIBS: скомпилировать общие библиотеки. по умолчанию включено
  • BUILD_FREERDP: если компилируется FreeRDP. по умолчанию отключено
  • WinPR_DIR: [путь установки FreeRDP]/lib/cmake/WinPR2
  • FreeRDP_DIR: [путь установки FreeRDP]/lib/cmake/FreeRDP2
  • FreeRDP-Client_DIR: [путь установки FreeFRP]/lib/cmake/FreeRDP-Client2
  • BUILD_RABBITVNC: скомпилировать RabbitVNC. по умолчанию включено
  • RabbitVNC_DIR: [путь установки RabbitVNC]/lib/cmake/RabbitVNC
  • BUILD_TigerVNC: скомпилировать TigerVNC. по умолчанию включено
  • TigerVNC_DIR: [путь установки TigerVNC]/lib/cmake/tigervnc
  • BUILD_LibVNCServer: скомпилировать LibVNCServer. по умолчанию включено
  • LibVNCServer_DIR: [путь установки libvncserver]/lib/cmake/LibVNCServer
  • libdatachannel_DIR: [путь установки libdatachannel]/lib/cmake/LibDataChannel
  • QXmpp_DIR=[путь установки QXmpp]/lib/cmake/qxmpp
  • QTermWidget5_DIR: [путь установки QTermWidget]/lib/cmake/qtermwidget5
  • libssh_DIR: [путь установки libssh]/lib/cmake/libssh
  • QtService_DIR: [путь установки QtService]/lib/cmake/QtService

• Если используется vcpkg, пожалуйста, установите параметры CMake:

  • Поскольку используется режим манифеста vcpkg, то зависимые библиотеки находятся в vcpkg.json
  • CMAKE_TOOLCHAIN_FILE: [путь установки vcpkg]/scripts/buildsystems/vcpkg.cmake
  • X_VCPKG_APPLOCAL_DEPS_INSTALL: ON При установке скопируйте зависимые библиотеки в каталог установки.

• VCPKG_MANIFEST_FEATURES: эта переменная может быть установлена в список функций для активации при установке из вашего манифеста. Примечание: все переменные, влияющие на vcpkg, должны быть определены перед первой директивой project(), например, в карте «cacheVariables» файла CMakePresets.json, через командную строку или операторы set(). Поэтому не размещайте его в файле CMakeLists.txt проекта. См.: https://learn.microsoft.com/vcpkg/users/buildsystems/cmake-integration#settings-reference

Компиляция

• Компиляция из командной строки:

  • Перейдите в папку RabbitRemoteControl.
  • Создайте папку build.
  • Выполните команду cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=%CD%/install -DBUILD_FREERDP=ON [options libraries] -DCMAKE_TOOLCHAIN_FILE=[путь установки vcpkg]/scripts/buildsystems/vcpkg.cmake -DX_VCPKG_APPLOCAL_DEPS_INSTALL=ON.
  • Затем выполните команду cmake --build . --config Release --target install.

  ; Упаковка:

  • cmake --install . --config Release --component Runtime --strip.
  • cmake --install . --config Release --component Application --strip.
  • cmake --install . --config Release --component Plugin --strip.
  • cmake --install . --config Release --component DependLibraries --strip.
  • makensis Install.nsi.

• Использование IDE (Qt Creator):

  • Установите vcpkg: Меню → Редактировать → Настройки → Наборы → Конфигурация Cmake:
    • Добавьте CMAKE_TOOLCHAIN_FILE = [путь установки vcpkg]/scripts/buildsystems/vcpkg.cmake.
    • Установите X_VCPKG_APPLOCAL_DEPS_INSTALL = ON.
  • Откройте проект: Меню → Файл → Открыть файл или проект, выберите файл CMakeLists.txt проекта.
  • Настройте: нажмите Проект → «Сборка и запуск» на панели инструментов слева, чтобы настроить параметры CMake. Если необходимо установить, выберите установку в цели.
  • Скомпилируйте и запустите: нажмите «Начать отладку запускаемого проекта» на левой панели инструментов или нажмите клавишу быстрого доступа (F5).

Примечание: если плагин не загружается, возможно, зависимости плагина не установлены в системе. Вы можете скопировать зависимую библиотеку в каталог bin приложения.

См.: Интеграция компиляции