devkitpro/devkitarm

掌上游戏机多平台开发环境镜像

镜像概述和主要用途

本Docker镜像集成了针对GBA（Game Boy Advance）、DS（Nintendo DS）、3DS（Nintendo 3DS）、GP32（GamePark 32）、GP2X（GamePark 2X）等经典掌上游戏机平台的开发工具链。旨在为开发者提供统一、可复现的开发环境，简化跨平台配置流程，支持相关平台应用程序（含homebrew软件）的开发、编译与测试。

核心功能和特性

支持平台

• GBA：Game Boy Advance掌上游戏机
• DS：Nintendo DS双屏掌上游戏机
• 3DS：Nintendo 3DS立体显示掌上游戏机
• GP32：GamePark 32开源掌上游戏机
• GP2X：GamePark 2X多媒体掌上游戏机

集成工具链与组件

• 各平台专用GCC交叉编译器（支持C/C++语言）
• 平台原生SDK及库文件（如libnds、devkitARM、ctrulib等）
• 调试工具（GDB交叉调试器、平台模拟器连接接口）
• 构建工具（Make、CMake、Ninja等）
• 代码辅助工具（代码格式化、静态分析工具）

核心特性

• 环境一致性：容器化封装确保不同开发环境（Windows/macOS/Linux）下编译结果一致
• 开箱即用：预装所有依赖组件，无需手动配置工具链路径及库文件
• 轻量级部署：基于精简基础镜像构建，降低资源占用
• 灵活扩展：支持挂载自定义工具链或项目文件，满足个性化开发需求

使用场景和适用范围

适用场景

• 独立开发者开发掌上游戏机homebrew应用程序
• 教育机构开展复古游戏开发教学实践
• 开源项目团队协作开发，统一编译环境
• 复古游戏爱好者制作自定义游戏或工具软件

适用范围

• 个人开发者、学生、教育工作者及开源项目团队
• 需针对GBA/DS/3DS/GP32/GP2X平台开发软件的场景
• 对开发环境一致性、可移植性有较高要求的项目

使用方法和配置说明

前提条件

• 已安装Docker Engine（推荐版本20.10.0及以上）
• 网络环境可访问Docker镜像仓库（用于拉取镜像）

镜像拉取

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/gba-dev-env:latest

注：请将[镜像仓库地址]替换为实际镜像仓库路径（如Docker Hub、私有仓库等）

基本使用示例

1. 交互式开发环境

启动容器并进入交互式终端，直接在容器内进行开发操作：

bash
docker run -it --rm \
  -v $(pwd):/project \  # 挂载本地项目目录到容器内/project
  --name gba-dev-session \
  [镜像仓库地址]/gba-dev-env:latest \
  /bin/bash

• -it：启用交互式终端
• --rm：容器退出后自动清理
• -v $(pwd):/project：本地当前目录与容器内/project目录共享
• --name：指定容器名称（可选）

2. 非交互式编译项目

直接执行编译命令，无需进入容器终端：

bash
docker run --rm \
  -v $(pwd):/project \
  -w /project \  # 设置工作目录为/project
  [镜像仓库地址]/gba-dev-env:latest \
  make  # 执行项目编译命令（根据项目Makefile配置）

环境变量配置

通过环境变量自定义开发环境参数，常用配置如下：

示例：指定目标平台为Nintendo DS

bash
docker run -it --rm \
  -v $(pwd):/project \
  -e TARGET_PLATFORM=ds \
  docker.xuanyuan.run/[镜像仓库地址]/gba-dev-env:latest \
  /bin/bash

项目编译示例（GBA平台）

1. 创建示例项目文件

本地创建main.c（GBA屏幕绘制示例）：

c
#include <gba.h>

int main(void) {
  irqInit();                  // 初始化中断系统
  irqEnable(IRQ_VBLANK);      // 启用垂直空白中断
  
  REG_DISPCNT = MODE_3 | BG2_ON;  // 设置屏幕模式为Mode 3（240x160 16位色）
  
  // 在屏幕中央绘制红色像素
  ((u16*)VRAM)[120*240 + 160] = RGB5(31, 0, 0);  // RGB5格式：(红,绿,蓝)，范围0-31
  
  while(1) {
    VBlankIntrWait();  // 等待垂直空白中断，防止屏幕撕裂
  }
  return 0;
}

2. 创建Makefile

makefile
# 编译器配置
CC = arm-none-eabi-gcc
LD = arm-none-eabi-ld
OBJCOPY = arm-none-eabi-objcopy

# 编译选项（GBA平台专用）
CFLAGS = -mthumb -mthumb-interwork -O2 -Wall -mcpu=arm7tdmi -mtune=arm7tdmi
LDFLAGS = -Tgba.ld -L/opt/sdks/gba/lib  # 使用GBA链接脚本

# 目标文件
TARGET = gba_demo.gba
OBJ = main.o

all: $(TARGET)

$(TARGET): $(OBJ)
  $(LD) $(LDFLAGS) $(OBJ) -o $(TARGET).elf
  $(OBJCOPY) -O binary $(TARGET).elf $(TARGET)  # 转换为GBA可执行格式

%.o: %.c
  $(CC) $(CFLAGS) -c $< -o $@

clean:
  rm -f *.o *.elf *.gba

3. 执行编译

bash
docker run --rm \
  -v $(pwd):/project \
  -w /project \
  docker.xuanyuan.run/[镜像仓库地址]/gba-dev-env:latest \
  make

编译完成后，本地目录生成gba_demo.gba文件，可通过GBA模拟器（如VisualBoyAdvance）运行测试。

高级配置

自定义工具链版本

挂载本地工具链目录覆盖默认配置：

bash
docker run -it --rm \
  -v $(pwd):/project \
  -v /path/to/custom-toolchains:/opt/toolchains \  # 挂载自定义工具链
  [镜像仓库地址]/gba-dev-env:latest \
  /bin/bash

持久化开发环境

通过docker commit保存自定义配置：

bash
# 1. 启动基础容器并修改配置
docker run -it --name custom-dev docker.xuanyuan.run/[镜像仓库地址]/gba-dev-env:latest /bin/bash
# 2. 在容器内完成配置后，另开终端执行提交
docker commit custom-dev my-custom-gba-dev:latest
# 3. 使用自定义镜像
docker run -it --rm docker.xuanyuan.run/my-custom-gba-dev:latest /bin/bash