游戏引擎 / 系统课时

处理配置与环境差异

处理配置与环境差异

同一套 UE5 工程在开发机、测试环境和正式发布时,常常需要不同的后端地址、调试能力与构建约束。本节把“构建配置”和“运行环境”拆开管理,并建立可验证的覆盖规则,避免测试值混入 Shipping 包或环境切换只靠人工记忆。

学习目标

  • 区分 Development、Test、Shipping 构建配置与业务运行环境。
  • 用集中配置和显式命令行覆盖管理环境差异。
  • 在启动阶段打印并校验最终配置,尽早发现错误环境或残留参数。

先分清构建配置与运行环境

UE5 的 Development、Test、Shipping 首先决定编译与运行特性,它们不应该直接等同于“开发服务器、测试服务器、生产服务器”。例如,Development 包可以连接测试后端,Shipping 包则应被策略限制为只能连接生产环境。

构建配置 适合用途 典型约束
Development 日常开发、联调 保留较完整的调试能力,迭代速度优先
Test 发布前验证、性能或自动化测试 更接近发布构建,同时保留部分测试能力
Shipping 面向最终用户发布 关闭面向开发者的能力,配置必须最严格

把两类概念分开后,可以让 CI 决定构建配置,让应用启动参数决定本次运行环境。这样同一份代码不会因为“测试=某个编译宏”而到处出现条件分支。

建立单一配置入口

下面的示例使用 Config/DefaultGame.ini 提供仓库内默认值,再允许启动参数覆盖。这样本地开发直接可用,测试或 CI 又能显式指定环境。

ini
[/Script/EngineSettings.GameMapsSettings]
GameInstanceClass=/Script/MyGame.MyGameInstance

[Environment]
Name=Development
BackendUrl=http://127.0.0.1:8080

这份配置的生效行为是:没有额外参数时,游戏以 Development 环境启动并使用本机后端。验证时应检查启动日志,确认最终环境名和地址与预期一致。

片段示例:以下代码依赖已有 UE5 C++ 项目与引擎模块,需分别保存为项目源文件;MYGAME_API 需要替换为项目模块实际导出宏。

cpp
// MyGameInstance.h
#pragma once

#include "CoreMinimal.h"
#include "Engine/GameInstance.h"
#include "MyGameInstance.generated.h"

UCLASS()
class MYGAME_API UMyGameInstance : public UGameInstance
{
    GENERATED_BODY()

public:
    virtual void Init() override;
};
cpp
// MyGameInstance.cpp
#include "MyGameInstance.h"

#include "Misc/CommandLine.h"
#include "Misc/ConfigCacheIni.h"
#include "Misc/Parse.h"

void UMyGameInstance::Init()
{
    Super::Init();

    FString Environment;
    FString BackendUrl;

    GConfig->GetString(TEXT("Environment"), TEXT("Name"), Environment, GGameIni);
    GConfig->GetString(TEXT("Environment"), TEXT("BackendUrl"), BackendUrl, GGameIni);

    FString OverrideEnvironment;
    if (FParse::Value(FCommandLine::Get(), TEXT("-Environment="), OverrideEnvironment))
    {
        Environment = OverrideEnvironment;
    }

    FString OverrideBackendUrl;
    if (FParse::Value(FCommandLine::Get(), TEXT("-BackendUrl="), OverrideBackendUrl))
    {
        BackendUrl = OverrideBackendUrl;
    }

#if UE_BUILD_SHIPPING
    if (!Environment.Equals(TEXT("Production"), ESearchCase::IgnoreCase))
    {
        UE_LOG(LogTemp, Fatal, TEXT("Shipping build requires Environment=Production"));
    }
#endif

    UE_LOG(
        LogTemp,
        Display,
        TEXT("Environment=%s BackendUrl=%s"),
        *Environment,
        *BackendUrl
    );
}

这里的优先级由代码明确规定:DefaultGame.ini 是基础值,命令行参数只覆盖本次进程。Shipping 构建再增加一道硬校验,避免误把测试环境打进正式发布流程。

启动并验证实际环境

在 Windows 上可以直接用 Unreal Editor 的游戏模式验证覆盖逻辑。<PATH> 代表本机实际安装或项目路径。

powershell
& "<PATH>\UnrealEditor.exe" "<PATH>\MyGame.uproject" -game -log -Environment=Test -BackendUrl=https://test-api.example

预期输出

text
LogTemp: Display: Environment=Test BackendUrl=https://test-api.example

实际日志前后会包含更多引擎输出,但这一行必须同时出现 Environment=Test 和指定的测试地址。如果只改了配置文件却没有看到预期值,优先检查 GameInstanceClass 是否指向当前类,以及命令行中是否仍残留旧的覆盖参数。

把发布约束放进自动化流程

环境差异最容易在“临时手工改一下”时失控,因此发布流程应固定三件事:CI 明确选择 Development、Test 或 Shipping;环境名称和非敏感地址通过部署参数传入;启动后立刻记录最终解析结果并做合法性校验。

对于 Shipping,推荐使用白名单而不是“只要不是 Development 就算生产”。例如仅接受 Production,并拒绝 Test、空字符串或未知值。这样新增环境时不会因为默认分支而悄悄进入正式包。

当配置入口唯一、覆盖顺序明确、发布构建带硬校验后,环境切换就从“人工记忆”变成可审计规则。后续无论接入 CI、自动化测试还是多地域后端,都只需要扩展这一条配置链,而不必在 Gameplay 代码里散落环境判断。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理配置与环境差异

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通