SuperAPI AI 工具集

ue5-macos-apple-silicon

编程与开发

查看项目

更新于 10-22 20:40

技能介绍

该技能包用于在 macOS 与 Apple Silicon 上开发 Unreal Engine 5 项目,重点解决官方资料默认面向 Windows 所导致的一系列问题。其定位是:在构建之前先完成环境发现与审计,并据此翻译所有 Windows 形态的指令,避免在 Mac 上执行 Build.bat、Visual Studio、DirectX 或 PIX 相关步骤。

用途:帮助开发者在 Mac 上正确建立 UE5 项目的构建、测试、性能分析与打包流程,尤其适用于 Launcher 安装、源码构建或多版本并存的环境。

主要能力包括:

  1. 环境审计:提供发现序列(references/environment-audit.md),要求确认引擎版本与路径、Xcode 版本、命令行工具是否被选中、Xcode 许可是否已接受,并把结果写入项目上下文文件。资料强调许可问题常表现为无提示的编译器错误,因此必须先排查。
  2. 构建与打包:说明编辑器构建、游戏构建、Cook、打包的流程,并强调必须尽早决定架构目标——仅 arm64 或通用二进制,因为该选择影响构建时间、包体大小以及后续所有命令的标志(references/build-and-package.md)。
  3. Metal 特性核实:要求在设计渲染功能之前,先确认在当前芯片代际与 macOS 版本上 Metal 实际提供哪些能力,并说明失败模式通常是静默回退而非报错(references/metal-feature-reality.md)。
  4. 性能分析:列出 macOS 上可用与不可用的分析工具,并给出最低可行的性能证据要求,强调应在打包构建中测量,而非在编辑器内比较(references/profiling-on-mac.md)。
  5. Windows 指令翻译:提供翻译表,将 Windows 形态的指令转换为 macOS 对应做法(references/windows-to-mac.md)。

使用方式:按需加载上述参考文件,遵循规定的回答格式输出:机器事实(芯片、内存、macOS 版本、磁盘空间及对应命令)、工具链事实(引擎版本与路径、Xcode 版本、CLT 选择、许可状态及命令)、架构决策及理由、已验证命令(构建编辑器、构建游戏、Cook、打包、运行测试的绝对路径与最近成功日期)、Metal 特性结论(可用、不可用或未验证及检查方式)、性能分析计划、以及需要人工处理的缺口清单。硬性规则包括:不得把 Windows 相关指令写入 macOS 项目文档;未在 Windows 机器上构建就不得声称存在 Windows 构建;所有路径必须加引号;不得围绕未在目标硬件打包构建中验证的渲染特性做设计;不得在编辑器内做性能比较;不得给开发构建添加签名或公证步骤。验证流程要求执行干净构建、打包启动并从 Finder 与命令行分别启动、记录包路径大小与 SHA-256、用 lipo -archs 或 file 检查架构、在打包构建中采集 RHI 与特性级别日志、建立帧率基线。

适用场景:macOS 与 Apple Silicon 上的 UE5 项目开发、构建、打包与性能优化;尤其适合需要跨平台一致性、曾被 Windows 默认资料误导的团队。

限制:不覆盖 iOS/tvOS/visionOS 目标、代码签名、公证、App Store 提交、Windows 交叉编译(资料明确说明不可行,需要 Windows 机器)以及针对仅 Intel 依赖的 Rosetta 工作流。