如何为ESP-IDF项目的外部组件添加依赖的官方内置库

• 移除组件CMake中多余的项目引入语句
  你当前displaylibrary组件的CMakeLists.txt里多了一行include($ENV{IDF_PATH}/tools/cmake/project.cmake)，这行仅允许存在于项目根目录的顶层CMakeLists.txt中，放在组件配置里会破坏ESP-IDF的组件依赖扫描逻辑，导致依赖库无法被正确关联，首先删除这行。

• 统一组件命名的大小写与拼写
  你的报错日志中显示组件路径为Displaylibrarys，但你描述的文件夹名是displaylibrary，同时存在displaylibrarys（多了s）的拼写差异，ESP-IDF的组件名对大小写、拼写完全敏感，需确保：

  • 组件文件夹名、CMake配置中引用的组件名完全一致
  • 避免大小写混用、拼写缺漏

• 确认SPIFFS组件已在项目配置中开启
  运行idf.py menuconfig，进入Component config菜单，确认SPIFFS Support选项已勾选，未开启该选项的情况下esp_spiffs.h头文件不会被加入编译路径。

• 补全正确的组件依赖配置
  修正后的project/components/displaylibrary/CMakeLists.txt完整配置如下：

idf_component_register(
  SRCS
     "pngle.c"
     "decode_jpeg.c"
     "decode_png.c"
     "fontx.c"
     "ili9340.c"
  INCLUDE_DIRS
     "include"
  REQUIRES
     esp_spiffs
)

• 确认main组件对显示组件的依赖声明
  打开project/main/CMakeLists.txt，确保main组件的注册配置中声明了对显示组件的依赖，示例如下：

idf_component_register(
    SRCS "main.c" "displayfunctions.c" [你其他的.c文件名]
    INCLUDE_DIRS "."
    REQUIRES displaylibrary
)

配置完成后，先执行idf.py fullclean清空历史编译缓存，再重新编译即可解决头文件找不到的问题。

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