ADF

ADF 暂未集成，无法使用新建项目，但可以使用任务树，和调试。

可以参考ADF的向导从步骤1 开始

本篇采用的adf 在递归clone内置的idf，以避免 adf和 idf版本不兼容。

1.clone adf源码

因为idf是不兼容有空格路径，请在一个无空格路径下操作。

git clone --recursive https://github.com/espressif/esp-adf.git

无法克隆时使用代理

需要替换代理服务器地址为实际代理程序真实监听地址

:: 设置 HTTP 代理
set http_proxy=http://127.0.0.1:7890
:: 设置 HTTPS 代理
set https_proxy=http://127.0.0.1:7890
git clone --recursive https://github.com/espressif/esp-adf.git

# linux可以使用局域网其他主机提供代理服务
# 设置 HTTP 代理
export http_proxy=http://192.168.137.1:7890
# 设置 HTTPS 代理
export https_proxy=http://192.168.137.1:7890
git clone --recursive https://github.com/espressif/esp-idf.git
          

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
git clone --recursive https://github.com/espressif/esp-idf.git
          

2.安装

这里暂时仅仅使用windows测试。

2.1 为ADF安装IDF

进入 esp-adf目录下的 esp-idf目录

运行命令行终端执行

install.bat

./install.sh

或者使用乐鑫中国下载站

set IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets"
install.bat

export IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets"
./install.sh
          

继续执行 export.bat

执行完毕保留cmd窗口。此时当前命令行会话的已经含有IDF的环境变量。

2.2 安装ADF

是在上一步操作中的cmd窗口退回到 esp-adf目录或者说是 clone 下来ADF的根目录。 cd ..
安装ADF 运行命令行终端执行

install.bat

./install.sh

或者使用乐鑫中国下载站

set IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets"
install.bat

export IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets"
./install.sh
          

执行 export.bat 导出ADF的环境变量。

配置Clion Toolchain

在ADF例子中项目的根CMakeLists.txt里面一般会包含ADF和IDF所在目录的cmake文件

include($ENV{ADF_PATH}/CMakeLists.txt)
include($ENV{IDF_PATH}/tools/cmake/project.cmake)

这里需要两者的环境变量。一般新建一个System类型的Toolchain，选择ADF源码路径下的export脚本作为环境变量文件即可。如果失败，可以考虑下一步操作。

新建导出ADF需要的环境变量的脚本

保留之前 2.2安装的完成的命令行，此命令行已经包含了ADF和IDF所有环境变量。

这个时候可以自己制作一个最简单环境变量导出脚本，也就是只导出环境变量不含任何逻辑的脚本。

windows下使用 SET 命令可以打印当前命令行所有环境变量。则使用 SET >export_adf.bat 制作一个脚本，然后编辑该脚本给行首加上 set这样得到一个脚本大致内容是

set ADF_PATH=D:\ESP_ADF\esp-adf
set HOMEDRIVE=C:
set HOMEPATH=\Users\immor
set IDF_CCACHE_ENABLE=1
xxxxx

linux和mac暂未尝试理论上使用env >export_adf.sh得到脚本后给行首加上export便可类似以下内容:

export ADF_PATH=/home/xxx/esp_adf/esp-adf
export IDF_CCACHE_ENABLE=1
xxxxx

配置ToolChain

新建一个System类型的Toolchain，选择上一步新建的脚本即可。

打开ADF项目

打开ADF项目时选择刚才新建的Toolchain 然后将cmake输出路径改成 build文件夹。

可使用命令树大部分节点，但IDF Export Console 不可使用。

01 八月 2025