Linux RT环境下VSCode+CMake交叉编译C代码链接NIDAQmx库报错

问题 #

在Linux RT系统中，通过VSCode使用CMake交叉编译调用NIDAQmx接口的C代码时，出现动态库链接错误：DAQmxCreateTask、DAQmxStopTask、DAQmxClearTask函数未定义引用，导致编译失败。移除NIDAQmx相关代码后编译可正常运行，修改CMakeLists.txt后问题仍未解决。

相关代码 #

C代码 #

#include<stdio.h>
#include"/home/admin/helloworld/src/NIDAQmx.h"

TaskHandle taskHandle=0;
int ret=0;

void main()
{
printf("Hello world");
ret=DAQmxCreateTask("task",&taskHandle);
printf("Return for creating task is %d\n",ret);
DAQmxStopTask (taskHandle);
DAQmxClearTask(taskHandle);
printf("Task closed ");
}

编译错误信息 #

[ 50%] Linking C executable bin/helloWorld   
CMakeFiles/helloWorld.dir/home/admin/helloworld/src/helloWorld.c.o: 
In function `main':/home/admin/helloworld/src/helloWorld.c:11: undefined reference to `DAQmxCreateTask'
/home/admin/helloworld/src/helloWorld.c:13: undefined reference to `DAQmxStopTask'
/home/admin/helloworld/src/helloWorld.c:14: undefined reference to `DAQmxClearTask'
collect2: error: ld returned 1 exit status
make[2]: *** [CMakeFiles/helloWorld.dir/build.make:95: bin/helloWorld] Error 1
make[1]: *** [CMakeFiles/Makefile2:68:CMakeFiles/helloWorld.dir/all] Error 2
*  The terminal process
"/bin/bash '-c', 'make'" failed to launch 
(exit code: 2). 
*  Terminal will be reused by tasks, press any key to close it.

修改后的CMakeLists.txt（未解决问题） #

cmake_minimum_required(VERSION 3.7.2)
# project settings
project(helloWorld VERSION 0.1.0)
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY bin)
set(CMAKE_GENERATOR "Unix Makefiles")
# executable settings
add_executable(helloWorld ../src/helloWorld.c)
set(CMAKE_BUILD_TYPE Debug)
LINK_LIBRARIES(NIDAQmx ../src/libnidaqmx.so)

解决方案 #

问题根源在于LINK_LIBRARIES的使用方式不规范，CMake推荐使用target_link_libraries针对特定可执行目标链接库，同时需确保头文件路径和库路径配置正确。以下是修正后的CMakeLists.txt：

cmake_minimum_required(VERSION 3.7.2)
project(helloWorld VERSION 0.1.0)

# 配置编译与输出参数
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY bin)
set(CMAKE_BUILD_TYPE Debug)
set(CMAKE_GENERATOR "Unix Makefiles")

# 添加NIDAQmx头文件搜索目录，替换代码中的硬编码路径
include_directories(/home/admin/helloworld/src)

# 生成可执行文件
add_executable(helloWorld ../src/helloWorld.c)

# 链接NIDAQmx动态库，使用绝对路径确保CMake能准确定位
target_link_libraries(helloWorld PRIVATE /home/admin/helloworld/src/libnidaqmx.so)

关键修改说明 #

1. 头文件路径规范化：使用include_directories添加头文件目录后，C代码可改为#include "NIDAQmx.h"，避免硬编码绝对路径，提升代码可移植性。
2. 库链接方式优化：target_link_libraries是CMake推荐的目标级链接方式，相比全局的LINK_LIBRARIES，能精准控制单个可执行文件的依赖库，避免全局配置冲突。
3. 绝对路径定位库文件：直接指定libnidaqmx.so的绝对路径，确保CMake在链接阶段能找到正确的动态库文件，避免因相对路径解析错误导致的链接失败。
4. 交叉编译额外检查：确认libnidaqmx.so是针对Linux RT目标架构编译的版本，而非主机架构的库，否则即使编译通过，运行时也会出现架构不匹配的错误。

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