使用Xcode调试iOS项目

介绍如何使用Xcode在设备上启动项目,以及如何使用断点何LLDB命令来调试项目。

Choose your operating system:

Windows

macOS

Linux

如需在iOS上调试 虚幻引擎 游戏,你需要先烘焙并打包你的项目,然后使用 Xcode 添加调试支持并重新编译代码。本文将介绍调试新项目时所需的步骤。

1. 所需步骤

要为iOS或tvOS设备生成项目,你必须先为你的应用设置代码签名证书和配置文件,否则在后面的步骤中,你的iOS设备将无法构建和部署内容。请参阅iOS配置,了解该过程的详情。

如果你创建了一个C++项目,你就必须为你的应用创建一个XCode项目。找到项目的 .uproject 文件,按住Control键并点击它,然后点击 生成Xcode项目(如果还未生成的话)。

2. 为iPhone烘焙内容

在你在iPhone上进行调试之前,你需要使用 虚幻 编辑器 来烘焙和打包游戏内容。原因是XCode可以编译游戏源代码,但无法烘焙内容。因此,每当游戏内容出现大量更新时,切记在使用XCode进行调试前重新打包所有内容。

你可以在虚幻编辑器中点击 文件 > 打包项目 > iOS 来打包你的游戏。有关打包iOS项目所需的先决条件,请参阅打包iOS项目

3. 在Xcode中编译并启动项目

打包完游戏后,你需要在Xcode中重新构建它并启用调试支持。这将取代虚幻引擎打包期间生成的二进制文件和可执行文件。

  1. 打开应用程序的Xcode项目。在Xcode中,在主菜单中选择 产品(Product) > 方案(Scheme) > 编辑方案(Edit Scheme)

    编辑方案按钮位于产品/方案下

  2. 点击 运行 分类,然后将 构建配置(Build Configuration) 改为 调试游戏(DebugGame)

    在"产品/方案/编辑方案"菜单中把构建配置设置为DebugGame

如果你用的虚幻引擎是通过源码构建的,你可以使用Debug配置来调试引擎代码。

  1. 将目标设备从 我的Mac 改为你所连接的 iPhone

    使用Xcode窗口右上角按钮将目标设备改为iPhone

  2. 点击 构建和运行 按钮,让Xcode构建项目并在设备上启动项目。

    点击左上角的Play按钮来构建和运行项目

完成这些步骤后,该项目将在你的设备上创建并启动。之后,你就可以使用断点、日志和LLDB命令来调试项目,并在运行时检查信息。

4. 其他信息

有关如何使用Xcode调试功能的更多信息,请参考Apple的开发者文档Debugging With Xcode

有关LLDB的更多信息,请参考Apple文档中的Getting Started with LLDB页面。

本文基于此前的虚幻引擎版本编写,未针对当前的虚幻引擎5.0版本更新过。