devkitpro/devkitppc Docker 镜像 - 轩辕镜像

Cube/Wii/WiiU开发环境Docker镜像文档

镜像概述和主要用途

本Docker镜像专为Cube、Wii及WiiU平台开发者设计，集成了开发所需的全套工具链、SDK及环境依赖。旨在提供标准化、可移植的开发环境，避免开发者手动配置复杂依赖，降低环境搭建门槛，提高开发效率，适用于相关平台应用程序的开发、编译与调试。

核心功能和特性

• 完整工具链集成：预安装适用于Cube、Wii、WiiU平台的编译器（如GCC、DevKitPPC）、链接器、调试器及构建工具（Make、CMake）。
• SDK支持：包含Cube、Wii及WiiU平台的官方/社区SDK，支持应用程序开发全流程（代码编写、编译、打包）。
• 环境隔离：通过Docker容器实现开发环境与本地系统隔离，避免工具版本冲突及系统环境干扰。
• 即开即用：无需手动配置依赖，拉取镜像后即可启动开发，减少环境搭建时间。
• 灵活定制：支持通过环境变量或卷挂载调整编译参数、项目路径及输出目录。

使用场景和适用范围

• 独立开发者：个人开发Cube、Wii或WiiU平台的小游戏、工具应用，快速搭建开发环境。
• 团队开发：统一团队开发环境，确保成员使用一致的工具版本和配置，减少协作中的环境相关问题。
• 学习与研究：供初学者学习Cube、Wii、WiiU平台开发，无需深入了解底层环境配置。
• CI/CD集成：作为持续集成/部署流程的一部分，用于自动化编译、测试相关平台应用程序。

使用方法和配置说明

基本使用步骤

1. 拉取镜像

从Docker仓库拉取镜像（实际镜像名称需根据仓库调整）：

bash
docker pull cube-wii-dev-env:latest

2. 启动容器并挂载项目目录

将本地项目目录挂载到容器内，启动交互式终端：

bash
docker run -it --rm -v /path/to/local/project:/workspace cube-wii-dev-env:latest /bin/bash

• /path/to/local/project：本地项目目录的绝对路径
• /workspace：容器内默认工作目录

3. 编译项目

进入容器后，在项目目录执行编译命令（根据项目构建系统调整）：

bash
cd /workspace
make  # 或 cmake . && make

配置参数说明

环境变量

卷挂载建议

• 项目目录：挂载本地项目目录至/workspace，实现代码实时同步。
• 输出目录：可选挂载本地目录至/output，避免容器销毁后丢失编译结果：

  bash
  docker run -it --rm \
    -v /path/to/local/project:/workspace \
    -v /path/to/local/output:/output \
    -e OUTPUT_DIR=/output \
    cube-wii-dev-env:latest /bin/bash
  

示例：完整开发流程

1. 准备本地项目
   本地创建项目目录~/cube-wii-project，存放源代码文件（如main.c、Makefile）。

2. 启动容器
   挂载项目目录和输出目录，设置输出路径环境变量：

   bash
   docker run -it --rm \
     -v ~/cube-wii-project:/workspace \
     -v ~/cube-wii-output:/output \
     -e OUTPUT_DIR=/output \
     cube-wii-dev-env:latest /bin/bash
   

3. 编译与输出
   在容器内编译项目，输出文件自动保存至本地~/cube-wii-output：

   bash
   cd /workspace
   make OUTPUT=$OUTPUT_DIR  # 假设Makefile支持OUTPUT参数
   

4. 验证结果
   退出容器后，检查本地~/cube-wii-output目录，获取编译生成的可执行文件或安装包。