游戏引擎 / 系统课时

区分开发与发布构建配置

区分开发与发布构建配置

同一个 Unity 项目需要产出供开发定位问题、供测试验收和供用户安装的不同包。若只在构建前临时勾选选项,容易把 Profiler、脚本调试能力或测试环境配置带进正式包。本课建立可复用的构建配置,并在成品中检查实际构建类型。

学习目标

  • 区分 Development Build、脚本调试和业务环境配置各自的职责。
  • 在 Unity 6 的 Build Profiles 中维护开发、测试和发布入口。
  • 用可运行脚本验证构建类型,完成发布前反向检查。

先分清构建类型与业务环境

Development Build 是 Unity 的构建选项,不等于连接测试服务器。它用于开发诊断;Script Debugging 允许连接脚本调试器,Autoconnect Profiler 让 Profiler 尝试连接正在运行的 Player。后两者仅在相关开发构建选项可用时才启用。深度性能分析还可能改变执行开销,不适合充当正式性能基线。

使用目的 Development Build 调试附加项 业务环境
开发定位 开 按需启用 Script Debugging、Profiler 开发或本地
QA 测试 依测试任务决定 排障时开启;发布仿真测试关闭 测试
正式发布 关 关闭 生产

测试环境与构建类型是两条独立轴。 QA 可以用非 Development Build 测发布行为,但仍访问测试后端。服务器地址、功能开关和资源版本应由经过审核的配置资产或受控构建流程提供,不要把 API 密钥、生产密钥写进客户端,更不能以“关了 Development Build”替代环境校验。

在 Build Profiles 创建明确的入口

以 Unity 6 为例,打开 File > Build Profiles,选择已安装的目标平台,为同一平台建立如 Windows-Dev、Windows-QA、Windows-Release 三个命名清楚的构建配置。老版本 Unity 可能使用 File > Build Settings,应按项目实际版本核对界面。

Unity 6 构建配置入口与开发调试开关示意图位置

  1. 确认目标平台模块已安装;创建或复制配置,并通过 Switch Profile 激活要构建的项。
  2. Dev 配置启用 Development Build,只在需要时开启 Script Debugging 或 Autoconnect Profiler;QA 分别准备诊断包或接近正式行为的验收包。
  3. Release 配置关闭 Development Build,并检查所有诊断附加项均未启用。统一检查场景列表、包标识、版本号及各平台签名设置。
  4. 对于需要按配置编译的业务开关,可以使用构建配置里的自定义 Scripting Defines;但构建符号仅决定编译内容,不能自动保证服务器环境选对。

让成品报告自己的构建类型

在启动场景 Boot 新建一个空对象,挂上 BuildModeReporter.cs。脚本使用 Unity 提供的 Debug.isDebugBuild 检查构建标志,并单独识别 Editor:因为在编辑器 Play 模式中,这个属性也会返回 true。

csharp
using UnityEngine;
using UnityEngine.SceneManagement;

public sealed class BuildModeReporter : MonoBehaviour
{
    private void Start()
    {
        // Editor 的 isDebugBuild 同样为 true,先排除编辑器。
        string mode = Application.isEditor
            ? "Editor"
            : (Debug.isDebugBuild ? "Development" : "Release");

        string scene = SceneManager.GetActiveScene().name;
        Debug.Log($"BUILD_MODE={mode}; SCENE={scene}");
    }
}

预期输出(启动场景确实命名为 Boot;分别在编辑器、开发包和发布包运行,每次只对应其中一行):

text
BUILD_MODE=Editor; SCENE=Boot
BUILD_MODE=Development; SCENE=Boot
BUILD_MODE=Release; SCENE=Boot

这段代码用于构建验收,不能证明连接的是哪个后端。发布包中的日志可通过目标平台的 Player 日志渠道查看;若项目禁用了日志输出,应使用构建流水线记录和可检查的版本信息替代。验收后移除临时探针或避免向正式日志输出敏感信息。

用发布清单阻断配置串包

正式交付前,先把 Release 设为活动配置,再执行构建。仅看编译成功并不足够,还应在真实目标设备上安装并启动产物,核对以下事项:

  • Debug.isDebugBuild 为 false,不存在意外开放的调试或自动连接 Profiler 能力。
  • 启动场景、目标平台、版本号、包标识及签名与待发布渠道一致。
  • 实际请求指向正确的生产环境;测试账号、测试资源和仅供内部使用的功能没有混入。
  • 关键玩法、存档读写与首帧性能在非 Development Build 下完成一次回归。

如果发现包运行正常却连接了测试服务器,根因在业务环境配置;如果服务器正确但允许调试,根因在构建选项。分别设置校验点,才能避免把两类问题混在同一个“发布模式”开关中。

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

目录与阅读设置

阅读设置

17

记录一个想法

区分开发与发布构建配置

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

登录哪都通