安装 C++

C++ 的 Flexiv RDK 打包到名为 flexiv_rdk 的现代 CMake 项目中,可以在所有支持的平台上使用 CMake 配置和安装该项目。

准备构建工具

Linux

  1. 使用包管理器安装 GCC 编译器套件:

    sudo apt install build-essential
    
  2. 使用包管理器安装 CMake:

    sudo apt install cmake
    

macOS

  1. 使用 xcode 工具安装 Clang 编译器套件:

    xcode-select
    

    这将调用 Xcode Command Line Tools 的安装,然后按照提示窗口完成安装。

  2. 使用包管理器安装 CMake:

    brew install cmake
    

Windows

  1. 安装编译器工具包:下载并安装 Microsoft Visual Studio 2019 (MSVC v14.2) 或更高版本。安装过程中,在“工作负载”选项卡下选择“使用 C++ 进行桌面开发”。您只需为所选工作负载保留以下组件:

    • MSVC ... C++ x64/x86 构建工具(最新)

    • 适用于 Windows 的 C++ CMake 工具

    • Windows 10 SDK 或 Windows 11 SDK,具体取决于您的实际 Windows 版本

  2. 安装 CMake(使用 GUI):从 CMake 下载页面 下载 cmake-3.x.x-windows-x86_64.msi 并安装 msi 文件。所需的最低版本是 3.22.1。 出现提示时将 CMake 添加到系统路径,以便可以从命令提示符或 bash 模拟器使用 cmakecmake-gui 命令。

  3. 安装bash模拟器:下载并安装 Git for Windows,它附带了bash模拟器Git Bash。以下步骤将在此 bash 模拟器中执行。

安装依赖项

  1. 按照 下载 Flexiv RDK 中的说明克隆或下载 flexiv_rdk 存储库。

  2. 选择RDK的C++库及其依赖的安装目录。该目录可以位于系统路径下,也可以不位于系统路径下,具体取决于您是否希望 CMake 全局可发现 RDK。例如,在主目录下新建一个名为 rdk_install 的文件夹。

  3. 在新终端中,运行提供的脚本来编译所有依赖项并将其安装到步骤 2 中选择的安装目录:

    cd flexiv_rdk/thirdparty
    bash build_and_install_dependencies.sh ~/rdk_install
    

备注

此步骤需要互联网连接。

安装RDK库

  1. 安装所有依赖项后,打开一个新终端并配置 flexiv_rdk CMake 项目:

    cd flexiv_rdk
    mkdir build && cd build
    cmake .. -DCMAKE_INSTALL_PREFIX=~/rdk_install
    

备注

-D 后跟 CMAKE_INSTALL_PREFIX 设置安装目录的绝对路径,该路径应该是上面步骤 2 中选择的路径。

  1. flexiv_rdk C++ 库安装到 CMAKE_INSTALL_PREFIX 路径,该路径可能会也可能不会被 CMake 全局发现,具体取决于位置:

    cd flexiv_rdk/build
    cmake --build . --target install --config Release
    
  2. 如果安装成功,rdk_install 文件夹中应出现以下目录:

  • include/flexiv/rdk/

  • lib/cmake/flexiv_rdk/

使用已安装的库

将库安装为 flexiv_rdk CMake 目标后,可以从任何其他 CMake 项目链接它。例如使用提供的 flexiv_rdk-examples 项目:

cd flexiv_rdk/example
mkdir build && cd build
cmake .. -DCMAKE_PREFIX_PATH=~/rdk_install
cmake --build . --config Release -j 4

备注

-D 后跟 CMAKE_PREFIX_PATH 告诉用户项目的 CMake 在哪里可以找到已安装的 C++ 库。如果 RDK 库及其依赖项安装到全局可发现的位置,则可以跳过此参数。