vegastrike/vega-strike-build-env

Vega Strike 构建环境镜像

镜像概述

Vega Strike 构建环境镜像是专为开源太空模拟游戏Vega Strike设计的开发环境镜像，旨在提供编译和开发该游戏所需的完整依赖工具与配置。通过使用此镜像，开发者可避免手动安装和配置复杂的开发依赖，快速搭建一致的开发环境，专注于代码开发与游戏功能实现。

核心功能与特性

1. 预配置完整依赖

• 包含编译Vega Strike所需的全套开发工具，如C++编译器（GCC/Clang）、CMake、Make等构建工具
• 预安装游戏运行与开发依赖库，如SDL2、OpenGL开发库、OpenAL、Boost等
• 集成版本控制工具（Git），支持直接拉取和管理Vega Strike源码

2. 简化构建流程

• 内置标准化构建脚本，支持一键执行源码编译、测试及打包流程
• 预设构建参数，减少手动配置步骤，降低构建出错概率

3. 环境一致性

• 统一开发环境配置，避免因开发者本地环境差异导致的"在我这里能运行"问题
• 支持多版本Vega Strike源码构建，可通过环境变量指定目标版本

4. 灵活定制

• 支持挂载本地源码目录，实时同步代码修改至容器内环境
• 可通过环境变量调整构建类型（Debug/Release）、安装路径等参数

使用场景

1. 本地开发环境搭建

• 开发者快速搭建Vega Strike开发环境，无需手动安装依赖
• 新手开发者降低入门门槛，专注学习游戏源码与开发逻辑

2. 代码贡献与协作

• 开源贡献者在统一环境中开发，确保提交代码的可编译性
• 团队协作时保持开发环境一致，简化代码评审与合并流程

3. CI/CD流程集成

• 作为持续集成（CI）流程中的构建环境，自动执行源码编译与测试
• 配合GitLab CI、GitHub Actions等工具，实现自动化构建与版本发布

使用方法与配置说明

基本使用（Docker Run）

通过以下命令启动容器，挂载本地Vega Strike源码目录并进入交互终端：

bash
docker run -it --rm \
  -v /path/to/local/vega-strike-source:/src \
  docker.xuanyuan.run/vegastrike/build-env \
  bash

说明：

• /path/to/local/vega-strike-source 替换为本地Vega Strike源码目录路径
• --rm 表示容器退出后自动删除，避免残留容器文件

环境变量配置

可通过-e参数设置环境变量，调整构建行为：

示例：指定Debug模式构建并自定义安装路径

bash
docker run -it --rm \
  -v /path/to/source:/src \
  -e BUILD_TYPE=Debug \
  -e INSTALL_PREFIX=/app/vega-strike \
  docker.xuanyuan.run/vegastrike/build-env \
  bash

执行构建流程

在容器终端中，进入挂载的源码目录并执行构建命令：

bash
# 进入源码目录
cd /src

# 执行构建（使用内置脚本）
/build.sh

注：/build.sh为镜像内置的标准化构建脚本，默认执行cmake -DCMAKE_BUILD_TYPE=$BUILD_TYPE -DCMAKE_INSTALL_PREFIX=$INSTALL_PREFIX .. && make && make install流程

Docker Compose配置示例

创建docker-compose.yml文件，简化环境配置：

yaml
version: '3'
services:
  vegastrike-build:
    image: docker.xuanyuan.run/vegastrike/build-env
    volumes:
      - ./vega-strike-source:/src  # 挂载本地源码目录
    environment:
      - BUILD_TYPE=Debug
      - INSTALL_PREFIX=/app/vega-strike
    tty: true  # 保持终端交互

启动容器：

bash
docker-compose up -d
docker-compose exec vegastrike-build bash  # 进入容器终端

注意事项

• 确保本地源码目录权限正确，避免容器内无法读取/写入文件（可通过-u $(id -u):$(id -g)参数指定用户ID）
• 不同Vega Strike版本可能需要特定镜像版本，建议通过标签指定（如vegastrike/build-env:v0.8.x）
• 构建产物默认位于$INSTALL_PREFIX路径下，可通过挂载目录（如-v ./output:/app/vega-strike）将产物导出到本地