在虚幻引擎中访问iOS和tvOS上的日志和崩溃报告 | 虚幻引擎 5.5 文档

使用虚幻引擎构建的iOS应用程序会生成崩溃日志，可供开发人员调试项目和修复代码问题。但是，出于安全原因，调试符号不可用于崩溃日志本身。你将看到键和编号，但要以人工可读格式看到函数名称或有关变量的信息，你需要将日志匹配到你的项目的符号数据库。

有几个过程可用于重新符号化你的日志并进行读取，具体取决于你是如何将调试版本交付到设备的。 TestFlight是Apple的应用程序，用于向大量可能的设备交付测试构建，并向开发者提供这些构建的日志。你还可以直接通过USB调试获取日志。

你需要Mac和Xcode，才能读取iOS项目的日志。其他操作系统和IDE不适用于此页面上的工作流程。

1. 直接从设备访问日志

如果你是通过USB或以太网直接调试，请执行以下步骤来查看符号化崩溃日志：

这将提供带有调试符号的人工可读格式日志。

通过TestFlight交付的应用程序崩溃时，会生成包含崩溃信息的XCrashPoint文件。要读取这些文件，你需要有.dSYM文件，其中包含你的项目的调试符号，然后你需要提取崩溃报告并将其重新符号化。

如需了解如何通过TestFlight部署应用程序并访问日志，请参阅Apple关于TestFlight的文档。本小节将提供有关如何在获取这些日志后将其符号化的信息。

要在打包项目时生成.dSYM文件，请执行以下步骤：

项目的.dSYM文件位于项目文件夹/Binaries/iOS之下。

.dSYM文件会用时间戳显示打包时间。请记录此信息，以便将.dSYM文件匹配到正确的构建。

要使用UAT生成.dSYM文件，请使用GenerateDYSM命令在命令行中执行RunUAT脚本。应指定以下参数：

参数	可选	有效值	说明
-Platform=[目标平台]	是（Yes）	IOS、TVOS、Mac	指定目标平台。如果未指定，则默认为当前平台。
-Target=[项目名称]	是（Yes）	项目的名称。	指定要使用的项目。如果未指定，则默认为当前项目。
-Config=[构建配置]	是（Yes）	Debug、DebugGame、Development、Test、Shipping	目标构建配置。如果未指定，则默认为Development。
-Architecture=[架构类型]	否（No）	x64、arm64、x64+arm64]	目标设备架构。
-flat	是（Yes）	不接受输入。	如果指定，.dSYM将是更易于在计算机或服务器之间复制的平面文件。

例如，以下命令将为使用arm64架构的iOS设备生成.dSYM文件：

C++

```RunUAT.command GenerateDYSM -project=MyProject -platform=Mac -target=EngineTestEditor -config=Test -architecutre=arm64```

```RunUAT.command GenerateDYSM -project=MyProject -platform=Mac -target=EngineTestEditor -config=Test -architecutre=arm64```

要获取崩溃报告并将其重新符号化，以便你可以进行读取，请执行以下步骤：

上述说明使用默认目录。运行这些命令行时，请使用你的.crash和.dSYM文件的位置。

然后，Xcode将提供显示了函数名称和变量的崩溃日志。