游戏引擎 / 系统课时

怎样拆分不同平台的配置

怎样拆分不同平台的配置

把所有平台的地址、调试开关和渠道标识塞进一份配置,会让发布时的手工修改逐渐失控。本节把公共约定、平台构建配置和运行环境参数分开管理,再用一个可执行的合并例子验证覆盖范围,避免测试参数进入正式产物。

学习目标

  • 区分构建期、运行期和敏感凭据的配置边界。
  • 为不同平台保留独立导出配置,并控制公共项的覆盖方式。
  • 检查嵌套配置合并和环境串用问题。

三类输入放在三个位置

以 Creator 3.8 LTS 为例,构建面板导出的 JSON 用于描述平台、场景和构建选项;游戏运行时读取的服务地址属于应用配置;签名私钥、密码和渠道密钥由受控凭据系统提供。三者的保存方式和使用时机不同,不能因为格式都是 JSON 就随意混用。

配置所有权与构建输入边界

输入 示例 管理方法
公共约定 版本、验收场景、日志策略 可审查的源码或发布文件
平台构建配置 Web 压缩、Android 构建、小游戏配置 各平台分别从面板导出
运行环境 测试服务与正式服务地址 明确选择环境并写入公开参数
敏感凭据 签名密码、服务端密钥 独立注入,禁止打进客户端资源

客户端内的字符串最终可能被提取,因此运行配置只能包含允许公开的信息。小游戏 AppID、包标识与服务端密钥的含义不同,不能把密钥当作普通标识保存。

合并时明确字段归属

下面的完整 Node.js 示例演示团队自定义配置的合并规则,不是 Creator 导出格式。保存为 merge-config.cjs,使用 Node.js 18 或更高版本运行 node merge-config.cjs。每个平台覆盖明确列出的字段,嵌套对象也显式合并,避免把公共日志策略意外丢掉。

js
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));

预期输出:

text
{"version":"1.2.0","runtime":{"environment":"staging","logLevel":"warn"}}

直接写 { ...base, ...android } 只进行浅合并,整个 runtime 会被替换,logLevel 随之消失。也不要无限递归合并所有导出字段:场景列表、Bundle 列表和平台插件配置可能需要整体替换,应按照实际格式确定规则。

平台导出文件保留完整性

分别在 Web、Android 和目标小游戏的构建面板完成设置,再导出相应配置。公共值可由发布脚本检查一致性;平台专属项保留在各自文件。Creator 的命令行 configPath 可以读取配置文件,但它不会自动理解团队自定义的继承关系。命令行构建说明

升级 Creator 后重新导出并比较差异,尤其核对平台专属字段。版本库中保留非敏感模板;包含凭据的完整文件存入受控位置。运行日志只打印平台、环境和配置摘要,不打印密钥或整个签名对象。

发布前检查解析后的配置

配置源文件正确,不代表最终解析结果正确。进入构建前打印允许公开的解析结果,确认平台、环境、版本、首场景和输出目录;正式路线出现 staging 或调试开关时应立即停止。

练习把示例的 Android 环境覆盖改为 production,再故意改成未允许的值,分别确认输出变化与失败结果。随后在实际项目做一次 Web 与 Android 配置比较:公共版本一致,平台专属项保留差异,签名秘密未进入任何游戏资源文件。

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

目录与阅读设置

阅读设置

17

记录一个想法

怎样拆分不同平台的配置

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

登录哪都通