| name | build-linux-app |
| description | 当需要配置或构建基于 CMake/Makefile 的 Linux 应用工程（如 i.MX6ULL/RK3562 开发板）时使用，支持交叉编译和本地编译。 |
构建 Linux 应用
适用场景
Project Profile 中标明 build_system: cmake 或 build_system: makefile，且目标平台为 Linux。- 用户希望对 Linux 应用工程执行配置、编译或确认产物。
- 需要为 ARM32/ARM64 开发板（如 i.MX6ULL、RK3562）进行交叉编译。
- 需要在构建前确认环境是否就绪（编译器、工具链）。
必要输入
- 工作区路径，或一份已有的
Project Profile。
- 可选的构建目录、目标架构（arm32/arm64/x86_64）、构建类型和工具链路径。
自动探测
- 若存在
CMakePresets.json，优先使用脚本的 --list-presets 列出并选择预设。
- 检查是否存在交叉编译工具链（如
aarch64-linux-gnu-gcc、arm-linux-gnueabihf-gcc）。
- 自动检测目标架构：通过环境变量、工具链文件或用户指定。
- 检查环境变量
CROSS_COMPILE 是否已设置（通过 use_toolchain 命令设置）。
- 对调试导向请求默认使用
Debug，否则默认使用 Release。
平台配置
i.MX6ULL (ARM32)
- 工具链：
arm-buildroot-linux-gnueabihf- 或 arm-linux-gnueabihf-
- 平台变量：
PLATFORM=imx6ull
- 第三方库路径：
third_lib/imx6ull/
RK3562 (ARM64)
- 工具链：
aarch64-linux-gnu- 或 aarch64-none-linux-gnu-
- 平台变量：
PLATFORM=rk3562
- 第三方库路径：
third_lib/aarch64/ 和 third_lib/rk3562/
工具链选择
在编译之前，必须选择合适的工具链：
use_toolchain arm32-linux-hf6ull
use_toolchain arm64-linux-75
执行步骤
- 先阅读 references/usage.md，确认本次是环境探测、列出预设、执行构建，还是仅扫描产物。
- 运行脚本 scripts/linux_builder.py 的
--detect 模式确认环境。
- 根据目标架构选择编译模式：
- ARM64 目标：使用交叉编译工具链，设置
PLATFORM=rk3562
- ARM32 目标：使用交叉编译工具链，设置
PLATFORM=imx6ull
- x86_64 目标：使用本地编译器，设置
PLATFORM=imx6ull（默认）
- 执行 cmake configure + build 或直接 make。
- 读取脚本输出的构建结果和产物扫描报告。
- 将构建目录、产物路径和工具链信息写回
Project Profile。
失败分流
- 当缺少编译器或所需工具时，返回
environment-missing。
- 当配置或构建因预设损坏、缺失工具链文件而失败时，返回
project-config-error。
- 当构建看似成功但未找到可执行文件时，返回
artifact-missing。
- 当存在多个同样合理的预设且任意选择都不安全时，返回
ambiguous-context。
平台说明
- 在 Linux 上优先使用系统编译器，支持交叉编译工具链。
- 在 Windows 上支持 WSL 环境或交叉编译工具链。
- 输出中的构建目录应保持为绝对路径。
- Makefile 项目支持通过环境变量
PLATFORM 和 CROSS_COMPILE 进行平台配置。
输出约定
- 输出配置命令、构建命令、构建目录和产物路径。
- 用
artifact_path、artifact_kind 和工具链细节更新 Project Profile。
- 成功后推荐
debug-linux-app 进行调试。
交接关系
- 当下一步需要调试会话时，将成功构建结果交给
debug-linux-app。
