atsigncompany/buildimage

at-buildimage

镜像概述和主要用途

at-buildimage是基于https://github.com/dart-lang/dart_docker%E7%9A%84%E8%87%AA%E6%9C%89%E7%89%88%E6%9C%ACDart SDK构建镜像，支持x86_64、armv7、arm64及RISC-V64多种架构运行。其核心价值在于不依赖apt包管理器安装Dart，解决了Arm和RISC-V架构下官方Dart包不可用的问题，为跨架构Dart应用开发与构建提供可靠环境。

核心功能和特性

• 多架构兼容：支持x86_64、armv7、arm64及RISC-V64架构，满足不同硬件平台的构建需求
• 独立安装机制：不依赖apt包管理器，避免因特定架构（如Arm、RISC-V）缺乏官方包导致的安装障碍
• 官方兼容性：基于google/dart镜像开发，保持与官方Dart环境的兼容性，确保开发体验一致

使用场景和适用范围

• 需在多架构环境（尤其是Arm和RISC-V）中开发、构建或测试Dart应用的场景
• 解决跨架构开发中Dart SDK安装困难问题，适用于需要统一构建环境的团队或项目
• CI/CD流水线中需在不同架构节点执行Dart应用构建的场景

使用方法和配置说明

基础使用

拉取并验证镜像（请根据实际镜像标签调整）：

bash
docker run --rm -it docker.xuanyuan.run/at-buildimage dart --version

该命令将启动容器并输出Dart SDK版本，验证镜像是否正常工作。

项目集成

可作为基础镜像用于Dart项目构建，示例Dockerfile：

dockerfile
FROM docker.xuanyuan.run/at-buildimage
WORKDIR /app
COPY pubspec.yaml .
RUN dart pub get
COPY . .
RUN dart compile exe bin/main.dart -o app
CMD ["./app"]

挂载项目目录

如需在容器中直接运行本地项目代码，可通过-v参数挂载目录：

bash
docker run --rm -it -v $(pwd):/app docker.xuanyuan.run/at-buildimage dart run /app/bin/main.dart

注意事项

• 根据目标架构选择对应版本的镜像（如有架构特定标签）
• 确保宿主机已启用对应架构的Docker支持（如使用多架构构建或QEMU模拟）