rpcs3/rpcs3-ci-jammy-aarch64

RPCS3 CI构建环境Docker镜像

镜像概述

本镜像为RPCS3项目的持续集成（CI）构建系统专用Docker镜像，基于Aarch64架构的Ubuntu Jammy（LTS版本）。其核心用途是提供稳定、一致的构建环境，用于构建RPCS3项目，不用于运行RPCS3应用程序，仅专注于构建流程支持。

核心功能与特性

• 架构与基础系统：基于Aarch64（ARM64）架构，底层为Ubuntu Jammy LTS，确保系统稳定性和长期支持。
• 构建依赖集成：包含构建RPCS3所需的关键依赖库，如：
  • 最新版本Clang编译器
  • Qt6开发库
  • FFMPEG多媒体处理库
  • SDL3跨平台开发库
  • Vulkan图形API相关库
• CI流程优化：专为RPCS3项目的CI/CD流程设计，可直接集成到自动化构建管道中，减少环境配置时间。

使用场景与适用范围

• 主要场景：RPCS3项目的持续集成/持续部署（CI/CD）流程，用于自动化构建、测试和部署环节。
• 适用对象：RPCS3项目开发者、维护者，或需要在本地复现RPCS3构建环境的技术人员。
• 注意事项：本镜像不提供RPCS3的运行环境，仅用于构建阶段，请勿尝试通过此镜像运行RPCS3应用。

相关资源

• RPCS3主仓库：https://github.com/RPCS3/rpcs3
• RPCS3 Docker仓库：https://github.com/RPCS3/rpcs3-docker

使用方法

基本使用（本地构建环境）

如需在本地使用此镜像构建RPCS3，可通过以下步骤拉取并运行镜像：

bash
# 拉取镜像（假设镜像已上传至Docker Hub或私有仓库，实际需替换镜像名称）
docker pull docker.xuanyuan.run/rpcs3/rpcs3-ci:aarch64-ubuntu-jammy

# 运行容器并挂载项目目录（示例）
docker run -it -v /path/to/rpcs3/source:/rpcs3 docker.xuanyuan.run/rpcs3/rpcs3-ci:aarch64-ubuntu-jammy /bin/bash

# 在容器内执行构建命令（具体命令参考RPCS3项目构建文档）
cd /rpcs3
mkdir build && cd build
cmake ..
make -j$(nproc)

CI流程集成示例（GitHub Actions）

在GitHub Actions工作流中集成此镜像，可在.github/workflows/build.yml中添加如下配置片段：

yaml
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout RPCS3 source
        uses: actions/checkout@v4
        with:
          repository: RPCS3/rpcs3
          
      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v3
          
      - name: Run build in RPCS3 CI image
        run: |
          docker run --rm -v ${{ docker.xuanyuan.run/github.workspace }}:/rpcs3 rpcs3/rpcs3-ci:aarch64-ubuntu-jammy \
            bash -c "cd /rpcs3 && mkdir build && cd build && cmake .. && make -j$(nproc)"

注意事项

• 本镜像仅支持Aarch64架构，x86_64架构环境需使用其他版本（如有）。
• 依赖库版本可能随RPCS3项目需求更新，建议通过官方仓库获取最新镜像信息。
• 构建过程中若需调整依赖或配置，可参考RPCS3 Docker仓库中的Dockerfile进行自定义修改。