auterion/app-cross-buildenv

AuterionOS应用交叉编译环境镜像

概述

该Docker镜像为AuterionOS应用开发提供专用交叉编译环境，集成针对AuterionOS目标平台的预配置工具链、依赖库及构建工具，旨在简化开发流程，解决跨架构/系统编译难题，确保编译环境一致性和可重复性。

核心功能与特性

• 预配置交叉工具链：内置针对AuterionOS目标架构（如arm64）的编译器、链接器及调试工具，无需手动配置工具链路径
• 集成Auterion依赖：包含Auterion SDK核心组件、系统库及运行时依赖，满足应用编译链路需求
• 多构建系统支持：兼容Make、CMake、Meson等主流构建系统，适配各类项目管理方式
• 环境隔离保护：通过容器化环境隔离编译过程，避免主机环境依赖冲突及版本干扰
• 灵活参数配置：支持通过环境变量自定义目标架构、SDK版本、输出路径等编译参数

使用场景与适用范围

• 本地应用开发：开发人员在x86/x86_64主机上编译AuterionOS目标应用，验证功能兼容性
• CI/CD流程集成：嵌入自动化构建 pipeline，实现代码提交后的自动编译与打包
• 多版本兼容性测试：通过指定不同SDK版本，在统一环境中测试应用对多版本AuterionOS的兼容性
• 团队协作开发：统一团队编译环境，消除"本地可编译，他人不可编译"的环境差异问题

使用方法与配置说明

1. 获取镜像

通过Docker命令拉取最新版本镜像（具体镜像名称以官方发布为准）：

bash
docker pull docker.xuanyuan.run/auterion/cross-compile-env:latest

2. 基础编译命令

基本使用格式：挂载项目目录至容器 workspace，指定编译参数并执行构建命令

bash
docker run -it --rm \
  -v /本地项目路径:/workspace \
  -e TARGET_ARCH=arm64 \
  -e AUTERION_SDK_VERSION=1.2.0 \
  docker.xuanyuan.run/auterion/cross-compile-env:latest \
  /bin/bash -c "cd /workspace && [构建命令]"

3. 环境变量配置

4. 典型使用示例

示例1：使用Make构建项目

bash
docker run -it --rm \
  -v $(pwd):/workspace \
  -e TARGET_ARCH=arm64 \
  -e AUTERION_SDK_VERSION=1.2.0 \
  -e OUTPUT_DIR=/workspace/output \
  docker.xuanyuan.run/auterion/cross-compile-env:latest \
  /bin/bash -c "cd /workspace && make -j$(nproc) && make install DESTDIR=\$OUTPUT_DIR"

示例2：使用CMake构建项目

bash
docker run -it --rm \
  -v $(pwd):/workspace \
  -e TARGET_ARCH=arm64 \
  -e BUILD_TYPE=Debug \
  docker.xuanyuan.run/auterion/cross-compile-env:latest \
  /bin/bash -c "mkdir -p /workspace/build && cd /workspace/build && cmake .. && make"

示例3：Docker Compose配置

创建docker-compose.yml简化重复构建：

yaml
version: '3.8'
services:
  auterion-build:
    image: docker.xuanyuan.run/auterion/cross-compile-env:latest
    volumes:
      - ./:/workspace
    environment:
      - TARGET_ARCH=arm64
      - AUTERION_SDK_VERSION=1.2.0
      - OUTPUT_DIR=/workspace/build
    command: >
      /bin/bash -c "cd /workspace && 
                   mkdir -p \$OUTPUT_DIR && 
                   cd \$OUTPUT_DIR && 
                   cmake .. && 
                   make -j$(nproc)"

执行构建：

bash
docker-compose up

注意事项

• 本地项目路径需具备读写权限，避免容器内编译文件写入失败
• 复杂项目可能需要额外挂载私有依赖库，通过-v /本地依赖路径:/容器内路径实现
• 生产环境建议指定具体镜像标签（如:1.2.0）而非latest，确保构建稳定性
• 编译产物位于OUTPUT_DIR指定路径，对应本地项目中的挂载目录子路径（如./build）