游戏引擎 / 系统课时
怎样拆分不同平台的配置
怎样拆分不同平台的配置
把所有平台的地址、调试开关和渠道标识塞进一份配置,会让发布时的手工修改逐渐失控。本节把公共约定、平台构建配置和运行环境参数分开管理,再用一个可执行的合并例子验证覆盖范围,避免测试参数进入正式产物。
学习目标
- 区分构建期、运行期和敏感凭据的配置边界。
- 为不同平台保留独立导出配置,并控制公共项的覆盖方式。
- 检查嵌套配置合并和环境串用问题。
三类输入放在三个位置
以 Creator 3.8 LTS 为例,构建面板导出的 JSON 用于描述平台、场景和构建选项;游戏运行时读取的服务地址属于应用配置;签名私钥、密码和渠道密钥由受控凭据系统提供。三者的保存方式和使用时机不同,不能因为格式都是 JSON 就随意混用。

| 输入 | 示例 | 管理方法 |
|---|---|---|
| 公共约定 | 版本、验收场景、日志策略 | 可审查的源码或发布文件 |
| 平台构建配置 | Web 压缩、Android 构建、小游戏配置 | 各平台分别从面板导出 |
| 运行环境 | 测试服务与正式服务地址 | 明确选择环境并写入公开参数 |
| 敏感凭据 | 签名密码、服务端密钥 | 独立注入,禁止打进客户端资源 |
客户端内的字符串最终可能被提取,因此运行配置只能包含允许公开的信息。小游戏 AppID、包标识与服务端密钥的含义不同,不能把密钥当作普通标识保存。
合并时明确字段归属
下面的完整 Node.js 示例演示团队自定义配置的合并规则,不是 Creator 导出格式。保存为 merge-config.cjs,使用 Node.js 18 或更高版本运行 node merge-config.cjs。每个平台覆盖明确列出的字段,嵌套对象也显式合并,避免把公共日志策略意外丢掉。
const base = {
version: '1.2.0',
runtime: { environment: 'production', logLevel: 'warn' }
};
const android = { runtime: { environment: 'staging' } };
// 顶层字段显式选择;runtime 只接收已审查的配置。
const resolved = {
version: base.version,
runtime: { ...base.runtime, ...android.runtime }
};
if (!['staging', 'production'].includes(resolved.runtime.environment)) {
throw new Error('Unknown environment');
}
// 正式发布还需在入口处强制 environment === production。
console.log(JSON.stringify(resolved));预期输出:
{"version":"1.2.0","runtime":{"environment":"staging","logLevel":"warn"}}直接写 { ...base, ...android } 只进行浅合并,整个 runtime 会被替换,logLevel 随之消失。也不要无限递归合并所有导出字段:场景列表、Bundle 列表和平台插件配置可能需要整体替换,应按照实际格式确定规则。
平台导出文件保留完整性
分别在 Web、Android 和目标小游戏的构建面板完成设置,再导出相应配置。公共值可由发布脚本检查一致性;平台专属项保留在各自文件。Creator 的命令行 configPath 可以读取配置文件,但它不会自动理解团队自定义的继承关系。命令行构建说明
升级 Creator 后重新导出并比较差异,尤其核对平台专属字段。版本库中保留非敏感模板;包含凭据的完整文件存入受控位置。运行日志只打印平台、环境和配置摘要,不打印密钥或整个签名对象。
发布前检查解析后的配置
配置源文件正确,不代表最终解析结果正确。进入构建前打印允许公开的解析结果,确认平台、环境、版本、首场景和输出目录;正式路线出现 staging 或调试开关时应立即停止。
练习把示例的 Android 环境覆盖改为 production,再故意改成未允许的值,分别确认输出变化与失败结果。随后在实际项目做一次 Web 与 Android 配置比较:公共版本一致,平台专属项保留差异,签名秘密未进入任何游戏资源文件。