Ubuntu系统版本信息：

lsb_release -a

Distributor ID: Ubuntu
Description:    Ubuntu 24.04.3 LTS
Release:        24.04

1. 安装依赖

sudo apt install git python3.12-venv cmake make gcc
sudo apt-get install -y libusb-1.0-0 libusb-1.0-0-dev

2. 安装 Micropython
(1) 下载micropython

git clone https://github.com/micropython/micropython.git -b v1.25.0 --single-branch --recursive && cd micropython && git checkout -b x1.25.0
#以安装v1.25.0版本micropython为例

(2) 构建micropython交叉编译器

#构建交叉编译器
make -C mpy-cross

3. 安装 ESP-ADF（已包含 ESP-IDF 5.3.1）
(1) 下载esp-adf

git clone https://github.com/espressif/esp-adf.git -b v2.7 --single-branch --recursive && cd esp-adf && git checkout -b x2.7

(2) 安装 ESP-IDF 和镜像工具（先设置 bash 代理再安装）

cd esp-idf && ./install.sh && source export.sh && pip install mp-image-tool-esp32==0.1.1

(3) 安装应用补丁

git apply ../idf_patches/idf_v5.3_freertos.patch && mv components/fatfs/CMakeLists.txt components/fatfs/CMakeLists.txt.bak

(4)设置ADF、IDF的路径

export ADF_PATH=/homecodespace/esp-adf/

export IDF_PATH=/homecodespace/esp-adf/esp-idf

4. 编译 ESP32
(1) 加载 IDF 编译环境
(2) 复制需要冻结的 Python 代码到 ports/esp32/modules 文件夹（如有），然后编译

cd ~/home/codespace/micropython/ports/esp32/

(3)  ADF 编译

3.1 应用补丁 

cd /home/codespace/esp-adf/micropython-adf
git apply mp.diff

3.2打开对应的路径

cd /home/codespace/micropython/ports/esp32

3.3使用 -D MICROPY_BOARD_DIR= 选择对应的开发板编译固件，下面以lyrat43开发板为例: 

idf.py build -D MICROPY_BOARD_DIR=${ADF_PATH}/micropython_adf/boards/lyrat43 -D USER_C_MODULES=${ADF_PATH}/micropython_adf/mod/micropython.cmake

3.4 编译成功

至此，你已经完成了micropython-adf固件的编译，希望能够帮助你在micropython嵌入式开发的路上减少踩坑。