升级指南
2026-10-28 正式交付适用范围
本指南适用于 FlexCore Engine 1.0.0,当前交付修订为 2026-10-28 的 r2。下载及版本记录;首次使用请看完整操作手册。本文修订于 2026-10-28。
| 内容 | 当前版本与用途 |
|---|---|
| Windows 开发包 | Server、Auth、Tools 1.0.0+build.1;编辑器及 Windows/Android 模板 1.0.0+build.540。用于开发与导出游戏。 |
| Linux 部署包 | Server、Auth、Tools 1.0.0+build.1。用于部署已有服务,不提供编辑器。 |
| SDK | 客户端 1.3.0、服务端 1.1.0-rc.0;其他 SDK 保留各自版本,按交付说明选择。 |
Auth 服务与 Auth SDK 为候选组件,工具和内容 SDK 为预览组件,正式使用前按自身场景确认。发行清单有签名;Windows 程序没有系统代码签名。
升级前保存什么
- 确认要更新的组件和目标平台。备份游戏源码、配置、运行数据,以及实际使用的证书、私钥和资源授权材料。数据库使用自身支持的备份方式。
- 保留当前程序、SDK、模板和原始发行包,便于恢复。保存所选配置旁的授权缓存、会话及已有验证状态,不回退已经见过的撤销状态。
- 正常停止要替换的进程。替换编辑器前退出编辑器及其运行的客户端;其他无关服务无需因此停止。
路径、配置和组件可以自主选择;升级不要求重新初始化项目、重领仍有效的授权或更换现有密钥。
下载、解压和检查
从版本记录取得对应程序包、同名 .sha256 校验文件和验证公钥。公钥需从官方可信渠道独立确认。Windows 校验文件 · Linux 校验文件。完整合规资料单独下载,必要第三方许可已随程序保留。
将新包解压到新位置,避免覆盖正在使用的配置。在 Windows PowerShell 中先核对压缩包 SHA-256:
Get-FileHash -Algorithm SHA256 -LiteralPath '.\FlexCore-1.0.0-20261028-r2-windows-x64-android-arm64.tar.gz'
结果应与同名 .sha256 文件一致。随后在新解压的包根目录执行,把公钥路径改为实际下载位置:
.\tools\fc-tools.exe engine verify-release --path . --trusted-public-key '..\FlexCore-release-public-key-20261028.pem'
if ($LASTEXITCODE -ne 0) { throw '交付文件检查失败,请按上方提示处理' }
.\tools\fc-tools.exe engine doctor --path . --trusted-public-key '..\FlexCore-release-public-key-20261028.pem'
if ($LASTEXITCODE -ne 0) { throw '交付依赖检查失败,请按上方提示处理' }
这两项退出码均为 0 才表示相应检查通过,成功时可能没有额外文字。Linux 使用 sha256sum 核对压缩包,检查目录时把工具换成 ./tools/fc-tools,每次执行后确认退出码为 0。此处公钥用于检查交付文件,与程序领取使用授权分别处理。
替换实际使用的组件
从新包取出本次需要的程序和配套文件,按交付目录保留它们需要的运行库;不要只复制一个 EXE 后漏掉依赖。开发包可以直接作为新的工具目录,不必与游戏工程或部署服务放在一起。
保留现有 server.toml、auth.toml 和项目配置,用新示例逐项对照需要修改的字段。不要整目录覆盖游戏项目,尤其不要覆盖源码、资源、数据、现有密钥和授权文件。Server/Auth 可用 --config 继续指向原配置;配置中的普通相对文件路径以该配置所在目录为准。
更新 SDK 时恢复所选交付内的依赖。例如,从新 Windows 包根目录为现有服务端项目执行:
.\tools\fc-tools.exe server init --project '..\我的游戏\server' --install --engine-root .
.\tools\fc-tools.exe server check --project '..\我的游戏\server'
.\tools\fc-tools.exe server build --project '..\我的游戏\server'
第一条用于补齐模板并离线恢复配套依赖,会保留已有配置;后两项分别检查项目和编译脚本。每项退出码应为 0。不要仅靠普通 npm install 就认定已恢复随包的预发布 SDK。其他 SDK 的安装及示例以各自随包说明为准,核对真实兼容性,按各 SDK 的兼容说明选择配套组件。
重新生成游戏客户端
r2 修正了客户端导出时授权材料的排除范围。授权材料仍放原配置目录,无需搬动;使用新工具重新生成开发输出或发布成品即可。不要手动改旧成品来模拟修正。
以下命令从新 Windows 包根目录执行,项目路径改为自己的客户端工程,输出目录选择尚不存在的新目录:
.\tools\fc-tools.exe client check --project '..\我的游戏\editor' --engine-root .
.\tools\fc-tools.exe client publish --project '..\我的游戏\editor' --platform windows-x64 --engine-root . --release-root '..\客户端成品-r2'
Android 改用 --platform android-arm64 并填写 --android-package-name,还需配置 Android SDK、JDK 和应用签名;详见手册的客户端发布步骤。导出成功不等于目标设备已经验收。
旧项目需要留意的变化
- 编辑器、Server、Auth 和开发工具可分别使用;按实际用途选择程序和配置。
- 客户端资源、场景、声音等调用使用所选 SDK 规定的标识。发现旧调用不匹配时按 SDK 声明修改并重新构建,不手改生成配置和校验文件。
- 使用服务端热重载保存状态的项目,应将保存、恢复函数明确赋给
globalThis.__on_hot_reload_save__和globalThis.__on_hot_reload_restore__;仅声明同名全局let或const不会形成入口。 - Auth 默认本地初始化已经生成开发密钥,不要再次执行
key generate。正式部署另行准备正式证书和凭据;只更新文档或程序不需要重建现有密钥。 - 从旧玩家会话领钥方式切换私有资源发布时,需更新相容的 Auth、工具、SDK 和客户端;旧客户端不能直接使用新领钥接口。保留仍需支持的旧资源及对应材料,按发布输出的说明安排切换。
使用前请阅读并遵守随包的许可协议。
升级后怎样确认成功
- 检查并编译服务端项目后,用原配置启动服务器。日志出现
网络服务已启动,表示网络服务已启动;继续核对本项目的连接、进入场景和读写数据。 - 打开编辑器并检查授权;现有有效材料可继续使用,需要本人确认时程序会引导论坛确认。Linux 在终端给出链接,可用另一台设备确认。
- 如使用 Auth,完成配置检查、数据库迁移和依赖检查,再验证真实玩家登录;浏览器确认引擎授权不代表玩家认证已经通过。
- 检查新客户端的启动、输入、资源和声音;Android 在目标设备安装检查。最后再切换正式入口,保留原成品用于恢复。
只进行文档检查或构建检查,不能代替这些实际游戏操作。
恢复旧版本
停止受影响进程,恢复已保存的程序、配套依赖和配置;游戏数据是否可回退须按项目自身的数据兼容方案确认。不要回退已见撤销状态、删除授权缓存来绕过授权,或默认认为换回旧程序就会恢复数据库。客户端可切回原成品;涉及远程内容时也要保留对应资源。
r2 包内说明勘误
r2 的入门说明误写可使用“随包 systemd 材料或 Manager”。本次程序包没有附带 Manager、systemd 单元或服务管理脚本。普通程序可直接运行;需要托管时自行选择适用工具,不影响现有启动方式。
本文引用的发行资源尚未配置本站下载入口,目前仅显示资源名称;请从原发行渠道获取交付物并核对摘要。