【问题标题】:Cmake vcpkg and BulletCmake vcpkg 和 Bullet
【发布时间】:2021-07-27 14:55:01
【问题描述】:

我在这里非常迷茫,真的需要一些帮助。

我正在为明年的 Honors 项目工作,该项目涉及使用 Bullet 和 Vulkan 进行渲染的物理模拟。经过几个月的工作,我已经完成了大部分项目。它需要大量的重构和清理,这将是下一阶段。

我一直在使用 makefile,但出于一些原因希望迁移到 CMake。主要是因为它似乎是标准,并且因为我想在将来为不同的操作系统进行编译(我正在运行 Linux,但可能需要在 Windows 或 Mac 上部署)。最后,我重新编译了整个项目,即使是很小的改动,当我开始更多地进行单元测试时,这开始成为一个问题。

旧的makefile如下:

ROOT_DIR:=$(shell dirname $(realpath $(firstword $(MAKEFILE_LIST))))

OWN_INCLUDES = \
    -I$(ROOT_DIR)/src/Domain \
    -I$(ROOT_DIR)/src/Vk \
    -I$(ROOT_DIR)/src/Ui \
    -I$(ROOT_DIR)/src/Service

ADD_INCLUDES = \
    -I/opt/bullet3-master/src \
    -I/opt/vk_mem_alloc \
    -I/opt/stb_image \
    -I/opt/tiny_obj_loader/ \
    -I/opt/imgui-vulkan/ 

BULLET_INCLUDE_PATHS_LIBS = -L/opt/bullet3-master/src/BulletCollision/ \
                            -L/opt/bullet3-master/src/BulletDynamics/ \
                            -L/opt/bullet3-master/src/LinearMath/ \
                            -lBulletDynamics -lBulletCollision -lLinearMath

VULKAN_SDK_PATH = /opt/Vulkan_SDK/1.2.162.1/x86_64

CFLAGS = -std=c++17 -I$(VULKAN_SDK_PATH)/include $(OWN_INCLUDES) $(ADD_INCLUDES)
LDFLAGS = -L$(VULKAN_SDK_PATH)/lib `pkg-config --static --libs glfw3` -lvulkan $(BULLET_INCLUDE_PATHS_LIBS)

IMGUI_CPP_PATHS = /opt/imgui-vulkan/*.cpp

OWN_CPP_PATHS = src/*.cpp src/Domain/*.cpp src/Vk/*.cpp src/Ui/*.cpp src/Service/*.cpp

###### Unit Testing Paths
UNIT_TEST_INCLUDE = -I/opt/catch-header/
UNIT_TESTS_PATH = $(ROOT_DIR)/unit_tests/*.cpp


VulkanRun: $(OWN_CPP_PATHS) $(IMGUI_CPP_PATHS)
    g++ $(CFLAGS) -o VulkanRun $(OWN_CPP_PATHS) $(IMGUI_CPP_PATHS) $(LDFLAGS)

Unit_Test: $(UNIT_TESTS_PATH) src/Domain/*.cpp src/Vk/*.cpp src/Ui/*.cpp src/Service/*.cpp $(IMGUI_CPP_PATHS)
    g++ $(UNIT_TEST_INCLUDE) $(CFLAGS) -o Unit_Test $(UNIT_TESTS_PATH) src/Domain/*.cpp src/Vk/*.cpp src/Ui/*.cpp src/Service/*.cpp $(IMGUI_CPP_PATHS) $(LDFLAGS) 

VulkanDebug: $(OWN_CPP_PATHS) $(IMGUI_CPP_PATHS)
    g++ $(CFLAGS) -g -o VulkanDebug $(OWN_CPP_PATHS) $(IMGUI_CPP_PATHS) $(LDFLAGS)

VulkanOpt: $(OWN_CPP_PATHS) $(IMGUI_CPP_PATHS)
    g++ $(CFLAGS) -O3 -o VulkanOpt $(OWN_CPP_PATHS) $(IMGUI_CPP_PATHS) $(LDFLAGS)

.PHONY: test clean

run: VulkanRun
    LD_LIBRARY_PATH=$(VULKAN_SDK_PATH)/lib
    VK_LAYER_PATH=$(VULKAN_SDK_PATH)/etc/vulkan/explicit_layer.d 
    ./VulkanRun

test: Unit_Test
    LD_LIBRARY_PATH=$(VULKAN_SDK_PATH)/lib
    VK_LAYER_PATH=$(VULKAN_SDK_PATH)/etc/vulkan/explicit_layer.d 
    ./Unit_Test

debug: VulkanDebug
    LD_LIBRARY_PATH=$(VULKAN_SDK_PATH)/lib
    VK_LAYER_PATH=$(VULKAN_SDK_PATH)/etc/vulkan/explicit_layer.d 

optimise: VulkanOpt
    LD_LIBRARY_PATH=$(VULKAN_SDK_PATH)/lib
    VK_LAYER_PATH=$(VULKAN_SDK_PATH)/etc/vulkan/explicit_layer.d 
    ./VulkanOpt

7 clean:
    rm -f VulkanRun
    rm -f Unit_Test
    rm -f VulkanDebug
    rm -f VulkanOpt

我使用 3.21.0 的最新安装脚本安装了 cmake。

我在项目的根目录下创建了一个 CMakeLists.txt 如下:

cmake_minimum_required(VERSION 3.21.0)
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++17")

project(LanderSim)

file(GLOB_RECURSE SOURCES "src/**.cpp")

add_executable(main ${SOURCES})

find_package(Bullet CONFIG REQUIRED)

if (BULLET_FOUND)
  include_directories(${BULLET_INCLUDE_DIRS})
  target_link_libraries(main PRIVATE LinearMath Bullet3Common BulletDynamics BulletSoftBody)
endif (BULLET_FOUND)

经过几个小时的尝试,我决定尝试 vcpkg。按照项目符号的安装说明:

git clone https://github.com/Microsoft/vcpkg.git
cd vcpkg
./bootstrap-vcpkg.sh
./vcpkg integrate install
./vcpkg install bullet3

这导致了错误

CMakeLists.txt:11 (find_package) 处的 CMake 错误: 找不到“Bullet”提供的包配置文件 以下名称: BulletConfig.cmake bullet-config.cmake

查看 CMakeCache.txt 我看到“Bullet_DIR:PATH=Bullet_DIR-NOTFOUND”

我在“/home/ash/vcpkg/installed/x64-linux/share/bullet3”和“/home/ash/vcpkg/packages/bullet3_x64-linux/share/bullet3”中找到了 BulletConfig.make 文件,并且将 MakeCache.txt var Bullet_DIR:PATH 设置为这些变量(一次测试一个)。

再次运行我得到 CMake set_and_check() 函数无法识别。或者类似的东西。查看 BulletConfig.make 文件,我发现 linter 无法识别这些 set_and_check() 函数。我无法找到任何关于它们在网上被弃用的信息,但我认为是这种情况。所以我改为 set() ,然后 CMake 成功并构建它的文件。

运行 make 然后我得到一个错误。

致命错误:btBulletDynamicsCommon.h:没有这样的文件或目录, #include

我尝试在包含路径前添加子弹/,因为其他人遇到了这个问题,但它会导致同样的错误。

所以我一定做错了,我显然不理解 CMake 用来添加包含和链接库的过程。我敢肯定,鉴于 CMake 的流行,肯定有一些显而易见的东西。但是几天来我花了大约 10 个小时来搜索和尝试不同的变体,我开始感到非常沮丧。

我之前已经摆脱了 CMake(这就是为什么我使用 makefile 几个月的原因),但我决心正确地做到这一点。如果有人知道如何让 CMake 生成一个可以看到使用 vcpkg 安装的包的 makefile,我真的可以使用一些帮助。

或者确实,如果 Bullet 的 vcpkg 已经过时,那么单独使用 CMake 链接和包含它的方法会很棒。我只是认为 vcpkg 会更容易,因为它默认提供更清晰的文件结构以及 CMake 配置文件。

谢谢。

编辑1

我用过“cmake”。和'cmake 。 -DCMAKE_TOOLCHAIN_FILE=/home/ash/vcpkg/scripts/buildsystems/vcpkg.cmake' 来构建makefile。调用 make 时,两者都会导致相同的缺少标头错误。

EDIT2

在每次调用 cmake 之前从项目中删除所有 CMake 文件(CMakeLists.txt 除外),以确保其中没有存储任何值。

EDIT3

多打听一下。这是 BulletConfig.cmake 文件:

#
#  BulletConfig.cmake(.in)
#

# Use the following variables to compile and link against Bullet:
#  BULLET_FOUND              - True if Bullet was found on your system
#  BULLET_USE_FILE           - The file making Bullet usable
#  BULLET_DEFINITIONS        - Definitions needed to build with Bullet
#  BULLET_INCLUDE_DIR        - Directory where Bullet-C-Api.h can be found
#  BULLET_INCLUDE_DIRS       - List of directories of Bullet and it's dependencies
#  BULLET_LIBRARIES          - List of libraries to link against Bullet library
#  BULLET_LIBRARY_DIRS       - List of directories containing Bullet' libraries
#  BULLET_ROOT_DIR           - The base directory of Bullet
#  BULLET_VERSION_STRING     - A human-readable string containing the version

set(PACKAGE_PREFIX_DIR /home/ash/installed/x64-linux)

set ( BULLET_FOUND 1 )
set ( BULLET_USE_FILE     "${PACKAGE_PREFIX_DIR}/share/bullet3/UseBullet.cmake" )
set ( BULLET_DEFINITIONS  "" )
set ( BULLET_INCLUDE_DIR  "${PACKAGE_PREFIX_DIR}/include/bullet" )
set ( BULLET_INCLUDE_DIRS "${PACKAGE_PREFIX_DIR}/include/bullet" )
set ( BULLET_LIBRARIES    "LinearMath;Bullet3Common;BulletInverseDynamics;BulletCollision;BulletDynamics;BulletSoftBody" )
set ( BULLET_LIBRARY_DIRS "${PACKAGE_PREFIX_DIR}/lib" )
set ( BULLET_ROOT_DIR     "${PACKAGE_PREFIX_DIR}" )
set ( BULLET_VERSION_STRING "3.17" )

# Load targets
if(NOT TARGET Bullet3Common)
  file(GLOB CONFIG_FILES "${PACKAGE_PREFIX_DIR}/share/bullet3/*Targets.cmake")
  foreach(f ${CONFIG_FILES})
    include(${f})
  endforeach()
  set(_DIR)
endif()

如前所述,一些集合函数是 set_and_check()。所以我改为 set() 因为显然 cmake 3.21 没有 set_and_check() 函数。通过打印 message() 进行一些测试后,我发现 PACKAGE_PREFIX_DIR 没有在任何地方设置。所以这就是我在这个文件中明确设置它的原因。现在,变量已正确设置,如 CMakeLists.txt 文件中的 message() 报告的那样。但它仍然找不到头文件。

EDIT4

我创建了一个空项目并遍历了我想要包含的每个库。除 Bullet3 外,一切正常。但是它现在确实看到了头文件。两个 CMakeFile 之间发生了什么变化?据我所知,什么都没有。我需要找出答案,因为我必须移植这个项目,但与此同时,这是包的另一个问题。

from /home/ash/projects/C++/CMakeImportTests/src/main.cpp:22:
/home/ash/vcpkg/installed/x64-linux/include/bullet/BulletCollision/CollisionDispatch/btCollisionWorld.h:77:10:

致命错误:LinearMath/btVector3.h:没有这样的文件或目录 77 | #include "LinearMath/btVector3.h"

我认为这与 #7877 描述的问题相同

如果我删除了 Bullet 的所有包含但保持 CMakeList.txt 不变,我们会收到此错误:

[ 50%] Building CXX object CMakeFiles/main.dir/src/main.cpp.o
[100%] Linking CXX executable main
/usr/bin/ld: cannot find -lLinearMath
/usr/bin/ld: cannot find -lBullet3Common
/usr/bin/ld: cannot find -lBulletDynamics
/usr/bin/ld: cannot find -lBulletSoftBody
collect2: error: ld returned 1 exit status
make[2]: *** [CMakeFiles/main.dir/build.make:104: main] Error 1
make[1]: *** [CMakeFiles/Makefile2:83: CMakeFiles/main.dir/all] Error 2
make: *** [Makefile:91: all] Error 2

这是没有设置某些环境变量的线索吗?

编辑5

target_link_library 调用似乎存在排序依赖关系。建议的用法是:

target_link_libraries(main PRIVATE LinearMath Bullet3Common BulletDynamics BulletSoftBody)

检查我找到的 libs/ 目录中的 bullet.pc

Libs: -L${libdir} -lBulletSoftBody -lBulletDynamics -lBulletCollision -lLinearMath

所以我尝试重新排列并遵循模式:

target_link_libraries(main PRIVATE BulletSoftBody BulletDynamics BulletCollision Bullet3Common LinearMath)

此外,还需要手动链接目录。

target_link_directories(main PRIVATE ${BULLET_LIBRARY_DIRS})

现在在我的测试项目中编译没有错误。似乎 LinearMath 必须在大多数其他库之后(尽管它似乎可以在 Bullet3Common 之前)。

由于某种原因,当我将完全相同的 CMake 命令复制到我的主项目时,它仍然找不到头文件。所以我还没有摆脱这个。

我应该说我能够删除我对 BulletConfig.cmake 所做的静态设置 PACKAGE_PREFIX_DIR 的更改。

所以只是回顾一下我的问题。一个小型测试项目有效,我可以使用项目符号和我在主项目中使用的许多其他库。但是如果我将这个工作的 CMakeLists.txt 复制到我的主项目中,它就无法再找到标题并抛出这个错误:

btBulletDynamicsCommon.h: No such file or directory
8 | #include <btBulletDynamicsCommon.h>

Bullet_DIR:PATH=/home/ash/vcpkg/installed/x64-linux/share/bullet3 在这两种情况下都是一样的。

【问题讨论】:

  • 您在使用 CMake 配置代码时是否使用了 vcpkg cmake 工具链文件?相关:https://vcpkg.readthedocs.io/en/latest/examples/installing-and-using-packages/#cmake
  • 是的,有没有我都试过了。我会将其添加到问题中。我用过'cmake'。和'cmake 。 -DCMAKE_TOOLCHAIN_FILE=/home/ash/vcpkg/scripts/buildsystems/vcpkg.cmake'
  • 工具链需要在first CMake 运行时指定。如果您稍后尝试添加它,它将被忽略。如果是这种情况,请删除构建目录并重试。
  • 另外:不要使用glob,尤其不要使用没有CONFIGURE_DEPENDS的glob。
  • 是的,我在每次尝试之前从项目中删除了所有 CMake 文件。包括 CMakeCache.txt 文件。剩下的就是 CMakeLists.txt,以确保它从头开始构建 makefile。

标签: linux cmake vcpkg bullet


【解决方案1】:

毕竟。

set_and_include() 错误是一个已知问题,vcpkg git 上的 mathisloge 表示需要更新 Bullet 包。解决方法是更改​​对 set() 的调用。

目标库的顺序很重要。 Bullet vcpkg 包中的建议方式是:

target_link_libraries(main PRIVATE LinearMath Bullet3Common BulletDynamics BulletSoftBody)

但这无法编译。应该是:

target_link_libraries(main PRIVATE BulletSoftBody BulletDynamics BulletCollision Bullet3Common LinearMath)

还必须使用 :

告诉 cmake 链接目录
target_link_directories(main PRIVATE ${BULLET_LIBRARY_DIRS})

然后我仍然有标题丢失错误。但重新启动后,事情又开始工作了。希望这里有足够的内容来帮助遇到类似问题的人。

【讨论】: