build-linux-app

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/

工具链选择

在编译之前，必须选择合适的工具链：

# i.MX6ULL ARM32 开发板
use_toolchain arm32-linux-hf6ull

# RK3562 ARM64 开发板
use_toolchain arm64-linux-75

执行步骤

1. 先阅读 references/usage.md，确认本次是环境探测、列出预设、执行构建，还是仅扫描产物。
2. 运行脚本 scripts/linux_builder.py 的 --detect 模式确认环境。
3. 根据目标架构选择编译模式：
   • ARM64 目标：使用交叉编译工具链，设置 PLATFORM=rk3562
   • ARM32 目标：使用交叉编译工具链，设置 PLATFORM=imx6ull
   • x86_64 目标：使用本地编译器，设置 PLATFORM=imx6ull（默认）
4. 执行 cmake configure + build 或直接 make。
5. 读取脚本输出的构建结果和产物扫描报告。
6. 将构建目录、产物路径和工具链信息写回 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。