Unreal 平台专题

这里收 UE 在各平台上的工程实践笔记：主机（PlayStation / Xbox / Switch）的 GPU 调试、性能 profiling、平台生命周期，以及新平台移植。

主机 GPU 调试与性能

PlayStation

• PS5 GPU Crash 调试工作流 — dump 生成、Razor GPU、Shader Debugger / GPU Capture / Replay 三路定位
• PS5 GPU 缓存层级与 Cache Sync 标志（概念） — RDNA2 的 GL0/GL1/GL2 与 cache sync 的等级权衡
• PS4 底层 GPU Profiling（Razor 计数器） — GCN 硬件块与各级性能计数器解读

Xbox

• Xbox Suspend 超时排查 — 1s 回调约束、dump/VS 两种调试、UE 里用 Insights 提前排查
• 用 Overlay Folder 调试已安装的包 — loose 目录覆盖原包，改完只重建即可调
• GDK 工具:版本号格式与 SubmissionValidator 维护 — GDK 版本号 YYMMNN 解读、单独升级校验工具、dlassets-ssl.xboxlive.com 网络白名单
• Xbox 年龄分级与试玩模式 — 各地区分级机构对照、AppXManifest <mx:Ratings> 写法、时限/用量/策划三种 trial

Switch

• Switch 上 Compute Shader 的优化与坑 — Draw↔Dispatch 的 WFI 停顿，全屏处理为何宜用 pixel shader

移动与掌机

• SteamDeck 开发 — Windows/UE 游戏移植上 SteamDeck:Devkit Client 用法、兼容性认证、Proton 音视频解码踩坑
• UE Android 开发 — Android 打包参数与纹理压缩、Android Studio/AGDE 两条环境路线、各类报错

跨平台

• 主机硬件规格对比 — 各家用机/VR 一体机的 CPU/GPU/内存/带宽对照表
• 主机增量 Patch 工作流与 -deterministic Cook — Release/Patch 出包命令、累积 vs 链式 base、cook 二进制不确定性导致 patch 从 417MB 膨胀到 3.9GB 的根因排查

SDK 与工具链

• Turnkey：SDK 管理工具 — 安装、三种存储后端（P4/本地/Google Drive）配置、多平台 TurnkeyManifest.xml 语法
• 查看各平台 SDK 版本要求的方法 — 通过 UBT 的 *PlatformSDK.Versions.cs 反查引擎对各平台 SDK 的版本约束

新平台移植

• 在 UE5.6 中支持 OpenHarmony 新平台 — 从 UBT/UAT 各扩展点到 HarmonyOS 宿主应用与工具链的完整移植实践（12 篇系列）