ESP-IDF v5.2.2中第三方依赖无法导入driver组件的问题求助

问题描述 #

将项目依赖迁移至ESP-IDF组件管理器时，编译报错：GitHub依赖项esp32-rotary-encoder的头文件中导入driver/gpio.h，提示该文件不存在（No such file or directory）。

已尝试的操作：

• 在项目CMakeLists.txt中添加REQUIRES driver
• 在项目idf_component.yml中配置driver依赖：

  driver:
      version: '*'
  

本地代码可正常导入driver/gpio.h，但即使在导入esp32-rotary-encoder头文件前先导入driver/gpio.h，问题仍未解决。完整编译错误如下：

[1/12] Performing build step for 'bootloader'
[1/1] cd <project_path>/build/bootloader/esp-idf/esptool_py && <pypath>/python <esp_path>/esp-idf/components/partition_table/check_sizes.py --offset 0x8000 bootloader 0x1000 <project_path>/build/bootloader/bootloader.bin
Bootloader binary size 0x6840 bytes. 0x7c0 bytes (7%) free.
[4/12] Building C object esp-idf/esp32-rotary-encoder/CMakeFiles/__idf_esp32-rotary-encoder.dir/rotary_encoder.c.obj
FAILED: esp-idf/esp32-rotary-encoder/CMakeFiles/__idf_esp32-rotary-encoder.dir/rotary_encoder.c.obj 
~/.espressif/tools/xtensa-esp-elf/esp-13.2.0_20230928/xtensa-esp-elf/bin/xtensa-esp32-elf-gcc -DESP_PLATFORM -DIDF_VER="v5.2.2" -DSOC_MMU_PAGE_SIZE=CONFIG_MMU_PAGE_SIZE -DSOC_XTAL_FREQ_MHZ=CONFIG_XTAL_FREQ -D_GLIBCXX_HAVE_POSIX_SEMAPHORE -D_GLIBCXX_USE_POSIX_SEMAPHORE -D_GNU_SOURCE -D_POSIX_READER_WRITER_LOCKS -I<project_path>/build/config -I<project_path>/managed_components/esp32-rotary-encoder/include -I<esp_path>/esp-idf/components/newlib/platform_include -I<esp_path>/esp-idf/components/freertos/config/include -I<esp_path>/esp-idf/components/freertos/config/include/freertos -I<esp_path>/esp-idf/components/freertos/config/xtensa/include -I<esp_path>/esp-idf/components/freertos/FreeRTOS-Kernel/include -I<esp_path>/esp-idf/components/freertos/FreeRTOS-Kernel/portable/xtensa/include -I<esp_path>/esp-idf/components/freertos/FreeRTOS-Kernel/portable/xtensa/include/freertos -I<esp_path>/esp-idf/components/freertos/esp_additions/include -I<esp_path>/esp-idf/components/esp_hw_support/include -I<esp_path>/esp-idf/components/esp_hw_support/include/soc -I<esp_path>/esp-idf/components/esp_hw_support/include/soc/esp32 -I<esp_path>/esp-idf/components/esp_hw_support/port/esp32/. -I<esp_path>/esp-idf/components/heap/include -I<esp_path>/esp-idf/components/log/include -I<esp_path>/esp-idf/components/soc/include -I<esp_path>/esp-idf/components/soc/esp32 -I<esp_path>/esp-idf/components/soc/esp32/include -I<esp_path>/esp-idf/components/hal/platform_port/include -I<esp_path>/esp-idf/components/hal/esp32/include -I<esp_path>/esp-idf/components/hal/include -I<esp_path>/esp-idf/components/esp_rom/include -I<esp_path>/esp-idf/components/esp_rom/include/esp32 -I<esp_path>/esp-idf/components/esp_rom/esp32 -I<esp_path>/esp-idf/components/esp_common/include -I<esp_path>/esp-idf/components/esp_system/include -I<esp_path>/esp-idf/components/esp_system/port/soc -I<esp_path>/esp-idf/components/esp_system/port/include/private -I<esp_path>/esp-idf/components/xtensa/esp32/include -I<esp_path>/esp-idf/components/xtensa/include -I<esp_path>/esp-idf/components/xtensa/deprecated_include -I<esp_path>/esp-idf/components/lwip/include -I<esp_path>/esp-idf/components/lwip/include/apps -I<esp_path>/esp-idf/components/lwip/include/apps/sntp -I<esp_path>/esp-idf/components/lwip/lwip/src/include -I<esp_path>/esp-idf/components/lwip/port/include -I<esp_path>/esp-idf/components/lwip/port/freertos/include -I<esp_path>/esp-idf/components/lwip/port/esp32xx/include -I<esp_path>/esp-idf/components/lwip/port/esp32xx/include/arch -I<esp_path>/esp-idf/components/lwip/port/esp32xx/include/sys -mlongcalls -Wno-frame-address  -fno-builtin-memcpy -fno-builtin-memset -fno-builtin-bzero -fno-builtin-stpcpy -fno-builtin-strncpy -fdiagnostics-color=always -fdiagnostics-color=always -ffunction-sections -fdata-sections -Wall -Werror=all -Wno-error=unused-function -Wno-error=unused-variable -Wno-error=unused-but-set-variable -Wno-error=deprecated-declarations -Wextra -Wno-unused-parameter -Wno-sign-compare -Wno-enum-conversion -gdwarf-4 -ggdb -Og -fno-shrink-wrap -fmacro-prefix-map=<project_path>=. -fmacro-prefix-map=<esp_path>/esp-idf=/IDF -fstrict-volatile-bitfields -fno-jump-tables -fno-tree-switch-conversion -std=gnu17 -Wno-old-style-declaration -MD -MT esp-idf/esp32-rotary-encoder/CMakeFiles/__idf_esp32-rotary-encoder.dir/rotary_encoder.c.obj -MF esp-idf/esp32-rotary-encoder/CMakeFiles/__idf_esp32-rotary-encoder.dir/rotary_encoder.c.obj.d -o esp-idf/esp32-rotary-encoder/CMakeFiles/__idf_esp32-rotary-encoder.dir/rotary_encoder.c.obj -c <project_path>/managed_components/esp32-rotary-encoder/rotary_encoder.c
In file included from <project_path>/managed_components/esp32-rotary-encoder/rotary_encoder.c:90:
<project_path>/managed_components/esp32-rotary-encoder/include/rotary_encoder.h:47:10: fatal error: driver/gpio.h: No such file or directory
   47 | #include "driver/gpio.h"
      |          ^~~~~~~~~~~~~~~
compilation terminated.
[5/12] Building C object esp-idf/main/CMakeFiles/__idf_main.dir/controls/controls.c.obj
ninja: build stopped: subcommand failed.

解决方法 #

问题根源是esp32-rotary-encoder组件自身未声明对driver组件的依赖，项目层面添加的依赖不会传递给第三方组件。可通过两种方式解决：

方式一：修改第三方组件的依赖配置 #

1. 进入项目下managed_components/esp32-rotary-encoder目录
2. 找到或创建idf_component.yml文件，添加driver依赖：

   dependencies:
     idf:
       version: ">=4.0"
     driver:
       version: "*"
   

3. 删除项目的build目录，重新执行idf.py build

方式二：在项目配置中强制传递依赖 #

修改项目根目录的idf_component.yml，在esp32-rotary-encoder的依赖声明中添加requires字段：

dependencies:
  esp32-rotary-encoder:
    git: https://github.com/your-repo/esp32-rotary-encoder.git  # 替换为实际的仓库地址
    requires:
      - driver
  driver:
    version: "*"

之后同样清理build目录并重新编译。

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