rpcs3/rpcs3-ci-focal

RPCS3 CI构建镜像 技术文档

一、镜像概述和主要用途

概述

本镜像为RPCS3项目（PlayStation 3模拟器）在持续集成（CI）流程中专用的Docker镜像，基于Ubuntu Focal (20.04 LTS) 系统构建。

主要用途

• 核心用途：提供标准化的构建环境，用于编译和构建RPCS3源代码。
• 注意：不用于运行RPCS3应用程序，仅作为构建环节的依赖环境。

二、核心功能和特性

基础系统

• 基于Ubuntu Focal LTS，确保系统稳定性和长期支持。

构建工具链

• 集成最新版本Clang编译器，满足C++项目的编译需求。

依赖库

• 包含构建RPCS3所需的关键库和框架：
  • Qt6：GUI框架依赖
  • FFMPEG：多媒体处理库
  • SDL2：跨平台输入/窗口管理库
  • Vulkan SDK及相关库：图形渲染依赖
  • 其他构建依赖（如CMake、Git等）

三、使用场景和适用范围

适用场景

• RPCS3项目开发人员本地构建源代码时使用。
• CI/CD系统（如GitHub Actions、Jenkins）自动化构建RPCS3时作为运行环境。

适用范围

• 仅限RPCS3项目的构建流程，不支持运行RPCS3模拟器。
• 需满足Docker环境运行条件（Linux/macOS/Windows，Docker Engine 19.03+）。

四、使用方法和配置说明

1. 镜像拉取

从项目Docker仓库拉取最新镜像（需先配置Docker访问权限，如GitHub Container Registry认证）：

bash
docker pull ***-ghcr.xuanyuan.run/rpcs3/rpcs3-docker:latest

2. 本地构建环境使用

开发人员可通过以下命令启动容器，并挂载本地RPCS3源代码目录进行构建：

bash
# 假设本地源代码路径为 ./rpcs3-source
docker run -it --rm \
  -v $(pwd)/rpcs3-source:/rpcs3 \  # 挂载本地代码到容器内/rpcs3目录
  ghcr.io/rpcs3/rpcs3-docker:latest \
  /bin/bash  # 进入容器终端

容器内执行构建命令（示例）：

bash
cd /rpcs3
mkdir build && cd build
cmake ..  # 生成Makefile（根据RPCS3构建文档调整参数）
make -j$(nproc)  # 多线程编译

3. CI流程集成示例（GitHub Actions）

在GitHub Actions workflow中引用本镜像作为构建环境（.github/workflows/build.yml）：

yaml
name: RPCS3 CI Build
on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-latest
    container:
      image: ***-ghcr.xuanyuan.run/rpcs3/rpcs3-docker:latest  # 直接使用本镜像作为运行环境
    steps:
      - name: Checkout RPCS3源码
        uses: actions/checkout@v4
        with:
          repository: RPCS3/rpcs3
          submodules: recursive  # 拉取子模块依赖

      - name: Build RPCS3
        run: |
          mkdir build && cd build
          cmake .. -DCMAKE_BUILD_TYPE=Release
          make -j$(nproc)

4. 配置说明

• 无特殊环境变量：镜像已预配置所有构建依赖，无需额外设置环境变量或配置文件。
• 构建参数调整：可通过cmake命令行参数（如-DCMAKE_BUILD_TYPE=Debug）自定义构建类型，具体参考RPCS3官方构建文档。

五、参考链接

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