这里收 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 硬件块与各级性能计数器解读

用 UE 出 Android 包的实战笔记:打包参数与纹理压缩、两条环境搭建路线、各类报错。

• UE 打包 Android 概览:命令行参数与纹理压缩 — BuildCookRun 常用参数、ASTC/DXT/ETC2 对比
• Android 开发环境搭建:Android Studio 与 AGDE 两条路 — SDK/NDK/Build-tools 版本对应、两条配置路线、模拟器跑 pak
• Android 打包踩坑 — Gradle/NDK/License 报错、UE4.24 NDK 版本、maven 阿里云换源

这篇是 UE 出 Android 包的入口:打包命令的常用参数,以及 ASTC/DXT/ETC2 三种纹理压缩格式的取舍。环境搭建见 Android 开发环境搭建,报错见 Android 打包踩坑。

打包命令

最精简的打包命令,参数按需加:

SteamDeck 不分开发机和零售机,零售机开了开发者模式同样能连 Devkit Client。整个开发循环就是:Devkit Client 连上 Deck → Title Upload 把游戏推上去 → 跑起来 → VS attach 调试 → scp/FileZilla 把日志和 dump 拿回来。

参考:https://partner.steamgames.com/doc/steamdeck/loadgames

Turnkey 是 UE 自带的平台 SDK 管理工具,把各平台 SDK 的安装和管理自动化了。配好之后,团队成员不用手动到处找 SDK 安装包,Turnkey 会按 Manifest 描述去指定存储位置拉对应版本装上。

官方文档:https://dev.epicgames.com/documentation/zh-cn/unreal-engine/setting-up-turnkey-for-your-organization-in-unreal-engine

UE 打 Android 包时各种 Gradle/NDK/License 报错的解法,以及 UE4.24 特有的 NDK 问题和 maven 换源。

常见报错

rungradle.bat: app:assembleDebug 卡 download:这些下载指向 GitHub,找 IT 开网络权限。一台机器只需下一次。

Could not determine the dependencies of task ':app:compileDebugJavaWithJavac' / Java:122: error: cannot find symbol:更新 Build-Tools,装 Build-Tools 29.0.2,License 问题见下文。

这篇是把一个 Windows 游戏移植上 SteamDeck、拿到兼容性认证全过程的总结。环境搭建和工具用法见 Devkit Client 用法,这里重点在兼容性认证要求和 Proton 这层撞过的坑——音视频解码器那块是整个项目最大的坑。

准备开发环境

有 SteamDeck 直接开发就行。没有的话用 Linux 设备代替:

• 手柄(确保游戏完全支持手柄)
• 720p 显示设备(模拟 Deck 默认分辨率 1280x800 / 1280x720)
• Linux 机器(Manjaro、Arch 发行版和 Deck OS 环境很接近)
• SteamOS Dev Kit Service(测试机)+ Client(开发机)