Windows下Zephyr测试项目文件结构配置及头文件缺失问题求助

问题现象 #

执行测试构建命令：

west build -t run -b qemu_cortex_m3 -p

出现编译错误：

C:/Users/bhupi/Git_Projects/nrf9160-feather-examples-and-drivers/tests/adc_control/src/test_adc_control.c:2:10: fatal error: adc_control.h: No such file or directory
    2 | #include "adc_control.h"

排查与解决步骤 #

• 确认CMake包含目录的作用范围
  如果测试目录有独立的CMakeLists.txt，主目录的zephyr_include_directories设置不会自动继承到子目录。需要在测试目录的CMake文件中显式添加库的头文件路径，例如：

  zephyr_include_directories(${CMAKE_CURRENT_SOURCE_DIR}/../../include/lib)
  

• 验证头文件路径正确性
  检查adc_control.h实际位置是否与指定路径匹配，确保文件存在于nrf9160-feather-examples-and-drivers/include/lib/目录下。可以在测试目录的CMake中添加临时打印语句验证路径：

  message(STATUS "Target include path: ${CMAKE_CURRENT_SOURCE_DIR}/../../include/lib")
  

  执行west build时查看输出，确认路径指向的目录确实包含目标头文件。

• 检查测试目标的CMake结构
  Zephyr单元测试需要确保库源码被正确关联到测试目标。在测试目录的CMakeLists.txt中，需使用zephyr_test()宏，并添加库的源文件：

  zephyr_test()
  
  zephyr_include_directories(${CMAKE_CURRENT_SOURCE_DIR}/../../include/lib)
  zephyr_library_sources(${CMAKE_CURRENT_SOURCE_DIR}/../../src/adc_control.c)
  

• 清理构建缓存重试
  缓存可能导致路径配置不生效，执行以下命令清理后重新构建：

  west build -t clean
  west build -t run -b qemu_cortex_m3 -p
  

• 检查Windows路径格式
  确保CMake中的路径使用正斜杠/或转义反斜杠\\，避免路径解析错误。

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