Xcode的 iOS模拟器(iOS Simulator) 可以让你在Apple的过往iOS设备型号上测试应用程序,无需囤积实体测试设备。本页面详细介绍了如何设置iOS模拟器并将其用于虚幻引擎项目。
先决条件
要使用iOS模拟器,你需要先完成以下步骤:
-
一台运行MacOS Ventura或更高版本的Apple Silicon Mac(M1 Mac或更高版本)。
- 兼容你的当前UE版本的Xcode安装包。如需更多信息,请参阅iOS开发要求。
-
一台用于初始设置的实体iOS测试设备。
-
带有C++源代码的UE项目
-
iOS目标平台
-
你还需要安装你想使用的iOS模拟器。如需关于iOS模拟器的说明,请参阅Apple的文档。
截至UE 5.3,tvOS模拟器支持暂不可用。此外,只有第一和第三人称项目经过了测试,并且确认适用于iOS模拟器。其他项目可以使用尚未更新到支持iOS模拟器的其他插件库。
为你的UE项目启用iOS模拟器支持
要在你的项目中启用对iOS模拟器的支持,请执行以下操作:
-
打开虚幻编辑器,然后打开你的项目设置。
-
在 项目设置(Project Settings)> 平台(Platforms)> iOS > 构建(Build) 中,勾选 启用iOS模拟器支持(Enable iOS Simulator Support) 。
-
在 iOS > 渲染(Rendering) 分段下,勾选 支持Apple A8(Support Apple A8) 。
-
重新运行
GenerateProjectFiles.command,以重新生成你的Xcode项目。这会更新Xcode.xconfig文件以支持iOS模拟器。 -
重启虚幻编辑器。
-
点击 平台(Platforms) 下拉菜单并对iOS设备执行至少一次 快速启动(Quick Launch) 。这会为iOS创建一个包含烘焙内容的版本。
-
在Xcode中打开你的iOS项目。点击 编辑方案(Edit Scheme) ,然后选择 运行(Run) 并找到 诊断(diagnostics) 分段。禁用 金属API验证(Metal API Validation) 。
如果你不禁用金属API验证,当你尝试从Xcode启动iOS模拟器时,你的项目将弹出错误警告。
现在,你的iOS版Xcode项目就为使用iOS模拟器做好了准备。
升级现有项目以使用iOS模拟器
如果你要向已经编译并烘焙的项目添加iOS模拟器支持,那么在启用iOS模拟器支持的情况下尝试编译时,你可能会由于着色器库的问题而遇到错误。要修复这些错误,请在启用“启用iOS模拟器支持(Enable iOS Simulator Support)”设置后删除你的项目中所有的烘焙内容,然后重新将你的项目启动到你的iOS设备。
相较于实体设备,iOS模拟器需要的着色器库不同,因此UE项目会创建两个金属库:一个是标准库,一个是模拟器的金属模拟(Metal-Sim)。
从Xcode启动iOS模拟器
-
在Xcode中打开项目的
UE5 (IOS).xcworkspace文件。 -
点击 目标设备(Target Device) 下拉菜单,然后点击 iOS模拟器(iOS Simulator) 打开下拉菜单,查看你可以模拟的iOS设备。
-
选择与你当前虚幻引擎版本兼容的iOS设备。请参阅iOS开发要求查看支持的设备列表。
-
点击 运行(Play) 按钮,编译并运行你的项目。
当你的项目完成编译时,iOS模拟器会在模拟你的目标设备的窗口中启动。如果你的应用程序已经构建,且没有代码变更,那么相较于安装到实体iPhone而言,编译的时间应该会非常短。
运行多个实例
你最多可以同时为你的应用程序运行六个iOS模拟器。运行多个模拟器适合用于比较不同iOS版本之间的渲染问题。要查看你当前正在使用哪些模拟器,请点击工具栏中的 窗口(Window) 按钮。
在同时运行iOS模拟器的三个或更多实例时,你的系统速度会大幅减慢。