文档

支持

检查构建结果

Review build results and monitor build performance in Unity Build Automation.
阅读时间5 分钟最后更新于 19 天前

Build Automation 会提供有关每个构建的状态、指标和进度的详细信息。这有助于监控构建性能、排除问题并跟踪正在运行的构建。

查看构建结果

要在 Unity Dashboard 中访问关于所有构建尝试的详细信息,请导航到 DevOps > Build Automation > Build history(构建历史记录) 构建历史记录表会列出所有构建尝试,以及它们的状态、构建目标、平台、构建时间和完成时间。

构建状态

Build Automation 使用状态图标标记每个构建以指示其结果:
构建成功
构建成功
构建失败
构建失败
构建已取消
构建已取消
构建已排队
构建已排队如果目前没有可用的构建器来分配给构建尝试,或者您已达到并发限制,则构建可能会排队。如果您已达到并发限制,页面顶部会显示一条警告消息通知您。
构建已发送到构建器
构建已发送到构建器由于正在配置构建器或正在准备环境,构建过程尚未开始。
构建当前正在进行
构建当前正在进行您可以监控运行中构建的进度,直到完成。

详细的构建信息

您可以查看特定构建(包括正在进行的构建)的更多详细信息。 Build History(构建历史记录 表中,选择构建条目旁边的箭头可显示详细信息面板并展开所选构建的指标,包括:

指标

描述

构建结果当前状态,比如正在进行、成功、失败或已取消。
开始时间和结束时间正在进行的构建会显示开始时间。已完成的构建会显示完成时间。
构建时间构建所花费或经过的总时间。
等待时间构建开始前在队列中等待的时间。
签出时间签出代码仓库所用的时间。
计费构建时间构建开始后计入计费的时间。
工作空间大小构建期间使用的存储空间量。

下载构建 Artifact

要访问和下载成功构建的构建 Artifact,请执行以下操作:
  1. Build History(构建历史记录) 表中,找到需要 Artifact 的构建条目。
  2. 在构建条目的右侧,单击三个点以打开选项菜单。
  3. 从下拉菜单中选择 Download .ZIP file(下载 .ZIP 文件),将构建 Artifact 作为压缩文件下载。
此下载的文件包含构建期间生成的构建输出和资源,可用于进一步测试、分发或存档目的。
"Unity Build Automation - 下载构建 Artifact"

Unity Build Automation - 下载构建 Artifact

外部共享构建 Artifact

您可以和帐户没有与项目关联的个人共享构建 Artifact。Build Automation 可以自动生成可共享的链接,让您能够通过电子邮件或通过 Slack 等集成工具发送构建。此外,您也可以从给定构建的下拉菜单中手动生成这些链接。 要共享构建,请执行以下操作:
  1. Build History(构建历史记录) 表中找到构建条目。
  2. 选择条目右侧的三个点以打开快捷菜单。
  3. 从下拉菜单中选择 Share Link(共享链接) 以生成可共享的链接。
请注意,共享链接默认在两周后过期。如果需要,您可以在要共享的构建的共享链接选项中调整过期期限。
"Unity Build Automation - 外部共享构建 Artifact"

Unity Build Automation - 外部共享构建 Artifact

要在 Unity Dashboard 中启用构建 Artifact 的自动共享,请转到 Build Automation > Settings(设置)> General(常规) 并切换 Automatic build sharing(自动构建共享) 选项。此设置会在构建成功完成时自动创建共享链接。它还会在通知中填入共享链接。

其他操作

查看构建结果后,您可以直接从构建历史记录表中执行一些操作,以管理构建并与之交互。在 Unity Dashboard 中访问以下选项:
  1. Build History(构建历史记录) 表中找到构建条目。
  2. 选择条目右侧的三个点以打开快捷菜单,查看其他操作的完整列表。
构建历史记录表的上下文菜单,其中显示了下表中列出的选项。

构建历史记录表的上下文菜单,其中显示了下表中列出的选项。

运算

描述

重新运行构建使用相同的配置重新运行构建。想要验证问题是否为临时问题,或者需要在不更改任何参数的情况下生成新构建时,此操作非常有用。
编辑构建目标修改构建目标配置设置。
添加标签将自定义标签附加到构建。标签可帮助您对构建进行分类,并在构建历史记录中快速查找特定版本。
播放(仅限 WebGL)直接在浏览器中启动并测试 WebGL 构建。此选项让您无需下载构建即可立即进行测试。
删除从构建历史记录中移除对应构建。此操作会永久删除构建 Artifact,并且无法撤消。使用此选项移除旧的或不必要的构建。

查看日志

如果构建遇到导致构建失败的问题,可以查看日志来诊断问题:
  1. 在 Build History(构建历史记录)表中,找到构建条目。
  2. 选择条目右侧的 Logs(日志) 以打开日志文件。
  3. 查看日志以识别可能导致构建失败的任何错误或警告。