Skip to content

Latest commit

 

History

History
296 lines (241 loc) · 13.4 KB

Windows_zh_CN.md

File metadata and controls

296 lines (241 loc) · 13.4 KB

为 Windows 编译

作者：康林 [email protected]

环境

操作系统

Windows 10 版本 20H2 (19042.985)

Qt Creator

版本：v11.0.0 。建议使用 v5.0.2 及以后版本，以前版本对 CMake 支持不够。

工具

编译

参见：编译集成

依赖库

玉兔公共库

此库默认放在与本项目同级目录下，如果没有在同级目录下，则必须指定 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 参数：-DCMAKE_TOOLCHAIN_FILE=[vcpkg 安装目录]/scripts/buildsystems/vcpkg.cmake

    • 使用 vcpk ， FreeRDP 服务不是默认功能，所以需要你手动指定。

  • 从源码编译

    • 源码位置：https://github.com/FreeRDP/FreeRDP

    • 编译详见：https://github.com/FreeRDP/FreeRDP/wiki/Compilation

        git clone https://github.com/FreeRDP/FreeRDP.git
  cd FreeRDP
  mkdir build
  cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=%CD%/install -DWITH_SERVER=ON
  cmake --build . --config Release --target install

    • 指定 CMake 参数：

      • -DBUILD_FREERDP=ON
      • -DWinPR_DIR=[freerdp 安装目录]/lib/cmake/WinPR2
      • -DFreeRDP_DIR=[freerdp 安装目录]/lib/cmake/FreeRDP2
      • -DFreeRDP-Client_DIR=[freerdp 安装目录]/lib/cmake/FreeRDP-Client2

LibVNCServer

  • 从源码编译

    • 源码位置：https://github.com/LibVNC/libvncserver
      建议使用补丁: https://github.com/KangLin/libvncserver

      cd vcpkg
vcpkg install zlib openssl libjpeg-turbo 
git clone https://github.com/KangLin/libvncserver.git
cd libvncserver
mkdir build
cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=%CD%/install -DCMAKE_TOOLCHAIN_FILE=[vcpkg 安装目录]/scripts/buildsystems/vcpkg.cmake
cmake --build . --config Release --target install

    • 指定 CMake 参数：-DLibVNCServer_DIR=[LibVNCServer 安装目录]/lib/cmake/LibVNCServer

RabbitVNC

  • 从源码编译 源码位置: https://github.com/KangLin/RabbitVNC

    cd vcpkg
vcpkg install zlib openssl libjpeg-turbo pixman
git clone https://github.com/KangLin/RabbitVNC.git
cd RabbitVNC
mkdir build
cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=%CD%/install -DCMAKE_TOOLCHAIN_FILE=[vcpkg 安装目录]/scripts/buildsystems/vcpkg.cmake
cmake --build . --config Release --target install

  • 指定 CMake 参数：-DRabbitVNC_DIR=[RabbitVNC 安装目录]/lib/cmake/RabbitVNC

TigerVNC

  • 从源码编译

官方只是个应用程序，不支持库。详见：TigerVNC/tigervnc#1123
所以本人在官方基础上做了修改。源码位置：https://github.com/KangLin/tigervnc

cd vcpkg
vcpkg install zlib openssl pixman libjpeg-turbo
git clone https://github.com/KangLin/tigervnc.git
cd tigervnc
mkdir build
cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=%CD%/install -DCMAKE_TOOLCHAIN_FILE=[vcpkg 安装目录]/scripts/buildsystems/vcpkg.cmake
cmake --build . --config Release --target install
  • 指定 CMake 参数：-Dtigervnc_DIR=[TigerVNC 安装目录]/lib/cmake/tigervnc

libdatachannel

QXmpp

  • 从源码编译

    • 源码位置： https://github.com/qxmpp-project/qxmpp

      git clone https://github.com/qxmpp-project/qxmpp.git
cd qxmpp
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=%CD%/install -DQt5_DIR=[Qt 安装目录]/lib/cmake/Qt5
cmake --build . --config Release --target install

    • 指定 CMake 参数: -DQXmpp_DIR=[QXmpp 安装目录]/lib/cmake/qxmpp

QTermWidget (暂不支持 Windows）

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/KangLin/RabbitRemoteControl

  • 下载源码

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

  • CMake 参数

    • RabbitCommon_ROOT：RabbitCommon 源码位置
    • BUILD_CLIENT: 编译客户端。默认为 ON
    • BUILD_SERVICE: 编译服务器端。默认依赖是否有 QtService
    • BUILD_PLUGINS: 编译插件。默认为 ON
    • BUILD_APP: 编译应用程序。默认为 ON
    • BUILD_DOCS: 编译文档。默认为 OFF
    • BUILD_SHARED_LIBS: 编译动态库。默认为 ON
    • BUILD_FREERDP：是否编译 FreeRDP。 默认为 OFF
    • WinPR_DIR:PATH: [FreeRDP 安装目录]/lib/cmake/WinPR2
    • FreeRDP_DIR: [FreeRDP 安装目录]/lib/cmake/FreeRDP2
    • FreeRDP-Client_DIR: [FreeRDP 安装目录]/lib/cmake/FreeRDP-Client2
    • BUILD_RABBITVNC: 编译 RabbitVNC 插件。默认为 ON
    • RabbitVNC_DIR: [RabbitVNC 安装目录]/lib/cmake/RabbitVNC
    • BUILD_TigerVNC: 编译 TigerVNC。默认为 ON
    • tigervnc_DIR: [TigerVNC 安装目录]/lib/cmake/tigervnc
    • BUILD_LibVNCServer: 编译 LibVNCServer。默认为 ON
    • 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，增加下面参数

    • 因为使用了 vcpkg 清单模式，所以依赖库在 vcpkg.json 中。
    • CMAKE_TOOLCHAIN_FILE: [vcpkg 安装目录]/scripts/buildsystems/vcpkg.cmake
    • X_VCPKG_APPLOCAL_DEPS_INSTALL: ON #安装时，把把依赖库的复制到安装目录中
    • VCPKG_MANIFEST_FEATURES: vcpkg 中的清单功能。 如果它要放到CMakeLists.txt文件中，则必须入在最顶端 project 之前才能生效。 所以本项目中从环境变量或 CMake 参数传入。 参见： https://learn.microsoft.com/vcpkg/users/buildsystems/cmake-integration#settings-reference

  • 编译

    • 命令行编译

        cd RabbitRemoteControl
  mkdir build
  cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=%CD%/install -DBUILD_FREERDP=ON [可选依赖库] -DCMAKE_TOOLCHAIN_FILE=[vcpkg 安装目录]/scripts/buildsystems/vcpkg.cmake -DX_VCPKG_APPLOCAL_DEPS_INSTALL=ON
  cmake --build . --config Release --target

  ; 打包
  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: 编辑→Preferences(Options)→构建套件(Kits)→Cmake Configureration:
        • 增加 CMAKE_TOOLCHAIN_FILE=[vcpkg installation path]/scripts/buildsystems/vcpkg.cmake
        • 设置 X_VCPKG_APPLOCAL_DEPS_INSTALL=ON
      • 打开项目: “菜单→文件→打开文件或项目”，选择项目根目录中的 CMakeLists.txt
      • 配置：点左侧工具栏上的 “项目→构建与运行”，配置 CMake 参数
        • 如果要安装，还需要　“项目→构建与运行→构建步骤→目标”　中，选中　install
      • 编译与运行： 点左侧工具栏上的 “开始调试” 或者按快捷键 “F5”

注意： 如果插件没有加载。则可能是插件的依赖库没有安装到系统。你可以把依赖库复制到程序的 bin 中。

参见：编译集成