敘述

今天就不進行外設驅動教學了，我們來學一下如何利用idf.py創建組件。創建組件有什么好處呢，好處有如下2點：

• 可以使得工程變得整潔
• 可以免去我們重復編寫某一個功能點，當我們在某一個工程寫完之后，可以通過組件引用，直接在其他工程中使用

0、前期準備

1、參考上一篇文章搭建好esp32環境

2、準備好一塊esp32開發開發板（本作者使用了esp32c3作為開發平臺）

1、基礎知識補充：

組件的創建命令為：idf.py create-component

引用的兩個關鍵字：REQUIRES 和 PRIV_REQUIRES，

這兩個關鍵字區別如下：

• 若組件的頭文件是放在源文件（.c文件）就是使用 PRIV_REQUIRES，
• 若組件的頭文件是在放在要引入的頭文件（.h文件）中用使用REQUIRES

idf.py -C components create-component test #test為組件名

2、使用例子

# 1、新建工程
idf.py create-project project_test # 新建工程
cd project_test 
idf.py set-target esp32c3 # 設置工程使用的芯片
idf.py -C components create-component test #test為組件名
#2、引入組件
#在要引用的文件中，找到CMakeList.txt文件，在文件中添加如下內容：
idf_component_register(SRCS "main.c"
                    INCLUDE_DIRS "."
                    PRIV_REQUIRES test #引用組件
                    )
# 如果要引用其他項目的組件需要在最頂層的CMakeLists.txt配置組件路徑，然后再按照2的方式
# 進行引用，設置的路徑的語句為： set(EXTRA_COMPONENT_DIRS  組件路徑)

注意：組件的搜索目錄，默認為 IDF_PATH/components、PROJECT_DIR/components和EXTRA_COMPONENT_DIRS

審核編輯：湯梓紅