如何将RtAudio作为CMake依赖项使用及编译报错解决

问题根源 #

你遇到的问题是因为现代CMake包配置更推荐使用导入目标（Imported Target），而非传统的_INCLUDE_DIRS/_LIBS变量。RtAudio的RtAudioConfig.cmake大概率是基于现代CMake规范编写的，没有定义你使用的RtAudio_INCLUDE_DIRS和RtAudio_LIBS变量，导致这些变量为空。

解决方案1：使用RtAudio的导入目标（推荐） #

修改你的CMakeLists.txt，直接使用RtAudio提供的导入目标RtAudio::RtAudio，该目标已经封装了头文件路径、链接库和编译选项，无需手动处理include_directories：

project(test_rtaudio)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_FIND_DEBUG_MODE ON)

add_executable(${PROJECT_NAME} main.cpp)

# 查找RtAudio包
find_package(RtAudio REQUIRED)

# 直接链接导入目标，自动处理头文件和库依赖
target_link_libraries(${PROJECT_NAME} PRIVATE RtAudio::RtAudio)

解决方案2：通过pkg-config导入（备选，当方案1失效时） #

既然你的pkg-config能正常识别RtAudio，可以直接让CMake通过pkg-config来导入依赖：

project(test_rtaudio)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_FIND_DEBUG_MODE ON)

add_executable(${PROJECT_NAME} main.cpp)

# 启用pkg-config支持
find_package(PkgConfig REQUIRED)
# 通过pkg-config查找RtAudio，并生成导入目标
pkg_check_modules(RtAudio REQUIRED IMPORTED_TARGET rtaudio)

# 链接pkg-config生成的目标
target_link_libraries(${PROJECT_NAME} PRIVATE PkgConfig::RtAudio)

验证与排查 #

1. 执行CMake配置时，观察输出是否有Found RtAudio相关的成功提示，确认包已被正确找到。
2. 如果方案1无效，可以查看你安装的RtAudioConfig.cmake文件（路径通常是$HOME/.local/lib/cmake/RtAudio/RtAudioConfig.cmake），检查其中是否定义了RtAudio::RtAudio目标，或者是否有其他命名的变量（比如单数形式的RtAudio_INCLUDE_DIR）。
3. 确保你的main.cpp中#include <RtAudio.h>的路径逻辑正确——头文件实际安装在$HOME/.local/include/rtaudio/下，若导入目标未自动处理路径，你可能需要写成#include <rtaudio/RtAudio.h>，但优先推荐用导入目标的方式自动处理。

内容的提问来源于stack exchange，提问作者Marsevil