build one lvgl_micropython #4
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| # 定义工作流名称 | |
| name: build lvgl_micropython | |
| # 触发条件：仅手动触发 | |
| on: | |
| workflow_dispatch: # 仅手动触发 | |
| jobs: | |
| build_esp32: | |
| # 条件判断：确保不是通过 pull request 触发的构建，或者当前仓库不是 pull request 的源仓库 | |
| if: ${{ github.event_name != 'pull_request' || github.repository != github.event.pull_request.head.repo.full_name }} | |
| # 指定运行环境为最新版的 Ubuntu | |
| runs-on: ubuntu-latest | |
| steps: | |
| # 第一步：检出代码 | |
| - uses: actions/checkout@v4 | |
| # 使用 GitHub 官方的 checkout 动作，版本为 v4，用于将代码仓库克隆到工作区 | |
| # 第二步：安装系统依赖 | |
| - name: Install system dependencies | |
| run: | | |
| sudo apt-get update | |
| sudo apt-get install -y build-essential pkg-config cmake ninja-build ccache | |
| # 使用 apt-get 安装编译所需的系统级依赖工具，包括编译工具链、包配置工具、CMake 构建工具等 | |
| # 第三步：设置 Python 环境 | |
| - uses: actions/setup-python@v5 | |
| with: | |
| python-version: '3.11' | |
| # 使用 GitHub 官方的 setup-python 动作，版本为 v5，设置 Python 环境为 3.11 | |
| # 第四步：安装项目依赖 | |
| - name: Install Deps | |
| run: | | |
| git submodule update --init --depth 1 -- lib/pycparser | |
| git submodule update --init --depth 1 --jobs 4 -- lib/micropython | |
| git submodule update --init --depth 1 --jobs 4 -- lib/lvgl | |
| # 初始化并更新 Git 子模块，深度为 1，用于获取项目依赖的子模块（如 pycparser、micropython 和 lvgl） | |
| # 第五步：缓存依赖 | |
| - name: Cached Deps | |
| id: cache-deps | |
| uses: actions/cache@v4 | |
| with: | |
| path: | | |
| lib/esp-idf | |
| ~/.espressif | |
| key: ${{ runner.os }}-v4-deps | |
| # 使用 GitHub 官方的 cache 动作，版本为 v4，缓存 ESP-IDF 和 espressif 相关目录，以加速后续构建 | |
| # 第六步：获取构建依赖（如果缓存未命中） | |
| - name: Get Build Deps | |
| if: steps.cache-deps.outputs.cache-hit != 'true' | |
| run: | | |
| git submodule update --init --depth 1 --jobs 4 -- lib/esp-idf | |
| cd lib/esp-idf | |
| git submodule update --init --depth 1 --jobs 4 -- components/bt/host/nimble/nimble components/esp_wifi components/esptool_py/esptool components/lwip/lwip components/mbedtls/mbedtls components/bt/controller/lib_esp32 components/bt/controller/lib_esp32c3_family | |
| cd ../.. | |
| export "IDF_PATH=${GITHUB_WORKSPACE}/lib/esp-idf" | |
| ./lib/esp-idf/install.sh all | |
| # 如果缓存未命中，则重新初始化 ESP-IDF 子模块，并安装 ESP-IDF 的所有依赖 | |
| # 第七步：设置 ESP-IDF 环境 | |
| - name: Setup ESP-IDF | |
| run: | | |
| export "IDF_PATH=${GITHUB_WORKSPACE}/lib/esp-idf" | |
| . ./lib/esp-idf/export.sh | |
| env: | |
| IDF_PATH: ${{ github.workspace }}/lib/esp-idf | |
| # 设置 ESP-IDF 的环境变量，并加载其导出脚本，以便在后续步骤中使用 ESP-IDF | |
| # 第八步：构建 ESP32 项目 | |
| - name: Build ESP32_GENERIC_S3 SPIRAM_OCT 16 | |
| run: python3 make.py esp32 BOARD=ESP32_GENERIC_S3 BOARD_VARIANT=SPIRAM_OCT --flash-size=16 DISPLAY=st7789 INDEV=xpt2046 | |
| # 使用 Python 脚本 make.py 构建 ESP32 项目，指定目标板为 ESP32_GENERIC_S3，变体为 SPIRAM_OCT，闪存大小为 16MB，显示设备为 st7789，输入设备为 xpt2046 | |
| # 第九步：上传构建产物 | |
| - uses: actions/upload-artifact@v4 | |
| with: | |
| name: lvgl_micropy_ESP32 | |
| path: ${{ github.workspace }}/build/**/*.bin | |
| if-no-files-found: ignore | |
| # 使用 GitHub 官方的 upload-artifact 动作，版本为 v4，将构建生成的 .bin 文件上传为工作流的产物，名称为 lvgl_micropy_ESP32 |