midwan/amiberry-debian-aarch64

Amiberry Debian AARCH64 编译环境镜像

镜像概述

Amiberry Debian AARCH64 镜像基于 Debian 系统构建，集成了为 AARCH64（64位 ARM）架构编译 Amiberry 所需的全部依赖组件。该镜像提供标准化编译环境，简化 Amiberry 在 ARM64 设备上的构建流程，支持最近 3 个 Debian 发行版本（通过标签区分），latest 标签始终指向最新稳定版本。

核心功能与特性

• 完整依赖集成：预安装构建 Amiberry 所需的全部工具和库，无需手动配置编译依赖。
• 多版本支持：通过标签对应最近 3 个 Debian 发行版本，满足不同环境兼容性需求。
• 自动版本更新：latest 标签自动关联最新 Debian 版本，确保编译环境与时俱进。
• 轻量级设计：基于最小化 Debian 环境，减少资源占用，专注编译功能。

使用场景与适用范围

• Amiberry 开发者：需为 ARM64 设备（如 Raspberry Pi 4、ARM64 开发板）编译自定义版本 Amiberry 的开发人员。
• ARM64 设备用户：希望通过标准化环境避免本地配置问题，在 CI/CD 流程或本地自动化构建 Amiberry 的用户。
• 跨平台编译：在 x86_64 主机上为 ARM64 目标架构交叉编译 Amiberry（需 Docker 支持 ARM64 模拟或原生运行）。

使用方法与配置说明

前提条件

• 已安装 Docker 引擎（支持 ARM64 或启用 x86_64 到 ARM64 的模拟）。
• 已克隆 Amiberry 源代码到本地目录（如 ~/amiberry）。

基本使用步骤

1. 拉取镜像

通过标签拉取特定 Debian 版本或使用 latest 获取最新版：

bash
# 拉取最新版本
docker pull midwan/amiberry-debian-aarch64:latest

# 拉取特定 Debian 版本（示例，具体标签参考镜像仓库）
# docker pull midwan/amiberry-debian-aarch64:debian-12

2. 启动容器并挂载源代码

使用 docker run 命令启动容器，挂载本地 Amiberry 目录到容器内 /build 路径：

bash
docker run --rm -it -v <本地Amiberry目录>:/build midwan/amiberry-debian-aarch64:latest

• 参数说明：
  • --rm：容器退出后自动删除，避免残留。
  • -it：分配交互式终端，支持命令行操作。
  • -v <本地Amiberry目录>:/build：挂载本地源代码目录到容器内 /build，实现文件共享。

3. 执行编译命令

容器启动后，进入 /build 目录执行编译命令（示例）：

bash
# 进入源代码目录
cd /build

# 编译适用于 Raspberry Pi 4 64位 SDL2 的版本
make -j8 PLATFORM=rpi4-64-sdl2

编译产物将保存在本地挂载目录中，可直接在宿主机访问。

标签说明

镜像通过标签区分 Debian 版本，支持最近 3 个发行版，具体标签可参考镜像仓库。latest 标签默认指向最新支持的 Debian 版本，确保获取当前最新编译环境。

注意事项

• 确保本地挂载目录具备读写权限，避免因权限问题导致编译失败。
• 编译命令中的 PLATFORM 参数需根据目标设备调整，具体值参考 Amiberry 官方文档。
• x86_64 主机运行时需启用 Docker QEMU 模拟（可通过 docker run --rm --privileged tonistiigi/binfmt --install all 配置）。