本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 Device Farm 中查看测试报告
<a name="how-to-use-reports"></a>

使用 Device Farm 控制台查看测试报告。有关更多信息，请参阅 [AWS Device Farm 中的报告Reports](reports.md)。

**Topics**
+ [先决条件](#how-to-use-reports-prerequisites)
+ [查看报告](#how-to-use-reports-viewing-reports)
+ [Device Farm 测试结果状态](how-to-use-reports-displaying-results.md)

## 先决条件
<a name="how-to-use-reports-prerequisites"></a>

设置测试运行并验证它是否已完成。

1.  要创建运行，请按照[在 Device Farm 中创建测试运行](how-to-create-test-run.md)中的说明操作，然后返回到此页面。

1. 验证运行是否已完成。在测试运行期间，Device Farm 控制台会显示正在进行的运行的待处理图标 ![\[Device Farm scheduled a job.\]](http://docs.aws.amazon.com/zh_cn/devicefarm/latest/developerguide/images/df-run-calendar.png)。运行中的每台设备也将以待处理图标开始，然后在测试开始时切换到正在运行的 ![\[Device Farm progress indicator.\]](http://docs.aws.amazon.com/zh_cn/devicefarm/latest/developerguide/images/df-run-progress.png) 图标。每次测试完成后，设备名称旁边都会显示一个测试结果图标。完成所有测试后，运行旁边的待处理图标将变为测试结果图标。有关更多信息，请参阅 [Device Farm 测试结果状态](how-to-use-reports-displaying-results.md)。

## 查看报告
<a name="how-to-use-reports-viewing-reports"></a>

您可以在 Device Farm 控制台中查看测试结果。

**Topics**
+ [查看测试运行摘要页面](#how-to-use-reports-console-summary)
+ [查看唯一问题报告](#how-to-use-reports-console-unique-problems)
+ [查看设备报告。](#how-to-use-reports-console-by-device)
+ [查看测试套件报告](#how-to-use-reports-console-by-suite)
+ [查看测试报告](#how-to-use-reports-console-by-test)
+ [查看报告中的问题、设备、套件或测试的日志信息](#how-to-use-reports-console-log)

### 查看测试运行摘要页面
<a name="how-to-use-reports-console-summary"></a>

1. 登录 DeviceFarm 控制台，网址为 [https://console.aws.amazon.com/devicef](https://console.aws.amazon.com/devicefarm) arm。

1. 在导航窗格中，选择**移动设备测试**，然后选择**项目**。

1. 从项目列表中选择用于运行的项目。
**提示**  
使用搜索栏按名称筛选项目列表。

1. 选择已完成的运行以查看其摘要报告页面。

1. 测试运行摘要页面会显示测试结果的概览。
   + **Unique problems (唯一问题)** 部分列出唯一的警告和故障。要查看具有唯一性的问题，请按照[查看唯一问题报告](#how-to-use-reports-console-unique-problems)中的说明操作。
   + **Devices (设备)** 部分按结果显示每个设备的测试总数。

     ![\[Device Farm device summary results.\]](http://docs.aws.amazon.com/zh_cn/devicefarm/latest/developerguide/images/df-run-device-summary-results-bar.png)

     在此示例中，有多个设备。在第一个表格条目中，运行 Android 版本 10 的 Google Pixel 4 XL 设备报告了三次成功的测试，运行时间为 02:36 分钟。

     要按设备查看结果，请按照[查看设备报告。](#how-to-use-reports-console-by-device)中的说明操作。
   + **屏幕截图**部分显示 Device Farm 在运行期间捕获的任何屏幕截图的列表（按设备分组）。
   + 在**解析结果**部分，您可以下载解析结果。

### 查看唯一问题报告
<a name="how-to-use-reports-console-unique-problems"></a>

1. 在 **Unique problems (唯一问题)** 中，选择要查看的问题。

1. 选择设备。报告显示有关该问题的信息。

   **Video (视频)** 部分显示该测试的可下载视频记录。

   **结果**部分显示测试结果。状态以结果图标表示。有关更多信息，请参阅 [单个测试的状态](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-individual)。

   **日志**部分显示 Device Farm 在测试期间记录的任何信息。要查看此信息，请按照[查看报告中的问题、设备、套件或测试的日志信息](#how-to-use-reports-console-log)中的说明操作。

   **文件**选项卡显示该测试的任何可下载关联文件（如日志文件）的列表。要下载文件，请在列表中选择该文件的链接。

   **屏幕截图**选项卡显示 Device Farm 在测试期间捕获的任何屏幕截图的列表。

### 查看设备报告。
<a name="how-to-use-reports-console-by-device"></a>
+ 在 **Devices (设备)** 部分，选择设备。

  **Video (视频)** 部分显示该测试的可下载视频记录。

  **套件**部分显示一个表，其中包含有关设备套件的信息。

  在此表中，**测试结果**列按设备上运行的每个测试套件的结果汇总了测试数。这些数据还有一个图形组件。有关更多信息，请参阅 [多个测试的状态](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-summary)。

  要按套件查看完整结果，请按照 [查看测试套件报告](#how-to-use-reports-console-by-suite) 中的说明操作。

  **日志**部分显示 Device Farm 在运行期间为该设备记录的任何信息。要查看此信息，请按照[查看报告中的问题、设备、套件或测试的日志信息](#how-to-use-reports-console-log)中的说明操作。

  **文件**部分显示该设备的套件以及任何可下载关联文件（如日志文件）的列表。要下载文件，请在列表中选择该文件的链接。

  **截图**部分显示 Device Farm 在运行期间为该设备捕获的任何屏幕截图的列表（按套件分组）。

### 查看测试套件报告
<a name="how-to-use-reports-console-by-suite"></a>

1. 在 **Devices (设备)** 部分，选择设备。

1. 在**套件**部分，从表中选择套件。

   **Video (视频)** 部分显示该测试的可下载视频记录。

   **测试**部分显示一个表格，其中包含有关套件中测试的信息。

   在表中，**测试结果**列显示结果。这些数据还有一个图形组件。有关更多信息，请参阅 [多个测试的状态](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-summary)。

   要按测试查看完整结果，请按照 [查看测试报告](#how-to-use-reports-console-by-test) 中的说明操作。

   **日志**部分显示 Device Farm 在运行期间为该套件记录的任何信息。要查看此信息，请按照[查看报告中的问题、设备、套件或测试的日志信息](#how-to-use-reports-console-log)中的说明操作。

   **文件**部分显示该套件的测试以及任何可下载关联文件（如日志文件）的列表。要下载文件，请在列表中选择该文件的链接。

   **屏幕截图**部分显示 Device Farm 在运行期间为该套件捕获的任何屏幕截图的列表（按测试分组）。

### 查看测试报告
<a name="how-to-use-reports-console-by-test"></a>

1. 在 **Devices (设备)** 部分，选择设备。

1. 在 **Suites (套件)** 部分中选择套件。

1. 在**测试**部分中，选择测试。

1. **Video (视频)** 部分显示该测试的可下载视频记录。

   **结果**部分显示测试结果。状态以结果图标表示。有关更多信息，请参阅 [单个测试的状态](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-individual)。

   **日志**部分显示 Device Farm 在测试期间记录的任何信息。要查看此信息，请按照[查看报告中的问题、设备、套件或测试的日志信息](#how-to-use-reports-console-log)中的说明操作。

   **文件**选项卡显示该测试的任何可下载关联文件（如日志文件）的列表。要下载文件，请在列表中选择该文件的链接。

   **屏幕截图**选项卡显示 Device Farm 在测试期间捕获的任何屏幕截图的列表。

### 查看报告中的问题、设备、套件或测试的日志信息
<a name="how-to-use-reports-console-log"></a>

**日志**部分显示以下信息：
+ **Source (来源)** 表示日志条目的来源。可能的值包括：
  + **Harness** 表示 Device Farm 创建的日志条目。这些日志条目通常在启动和停止事件期间创建。
  + **设备**表示设备创建的日志条目。对于 Android，这些日志条目与 Logcat 兼容。对于 iOS，这些日志条目与 syslog 兼容。
  + **Test (测试)** 表示某测试或其测试框架创建的一个日志条目。
+ **Time (时间)** 表示第一个日志条目与此日志条目之间相隔的时间。时间以*MM:SS.SSS*格式表示，其中*M*表示分钟，*S*代表秒。
+ **PID** 表示创建了日志条目的进程标识符 (PID)。设备上的应用程序创建的所有日志条目具有相同的 PID。
+ **Level (级别)** 表示日志条目的日志记录级别。例如，`Logger.debug("This is a message!")` 会记录 `Debug` 的**级别**。可能的值有：
  + **提醒**
  + **重大**
  + **Debug**
  + **Emergency**
  + **错误**
  + **Errored**
  + **已失败**
  + **信息**
  + **Internal**
  + **Notice**
  + **Passed**
  + **Skipped**
  + **Stopped**
  + **详细**
  + **Warned**
  + **警告**
+ **Tag (标签)** 表示日志条目的任意元数据。例如，Android Logcat 可用它来描述系统的哪个部分创建了该日志条目 (例如，`ActivityManager`)。
+ **Message (消息)** 表示日志条目的消息或数据。例如，`Logger.debug("Hello, World!")` 会记录 `"Hello, World!"` 的**消息**。

仅显示信息的一部分：
+ 要显示与特定列中的某个值匹配的所有日志条目，请在搜索栏中输入该值。例如，要显示**源**值为 `Harness` 的所有日志条目，请在搜索栏中输入 **Harness**。
+ 要从列标题框中删除所有字符，请选择该列标题框中的 **X**。从列标题框中删除所有字符与在该列标题框中键入 **\$1** 的作用相同。

要下载设备的所有日志信息，包括曾运行的所有套件和测试，请选择**下载日志**。

# Device Farm 测试结果状态
<a name="how-to-use-reports-displaying-results"></a>

Device Farm 控制台中显示的图标可帮助您快速评估已完成的测试运行的状态。有关 Device Farm 的更多信息，请参阅 [AWS Device Farm 中的报告Reports](reports.md)。

**Topics**
+ [单个测试的状态](#how-to-use-reports-displaying-results-individual)
+ [多个测试的状态](#how-to-use-reports-displaying-results-summary)

## 单个测试的状态
<a name="how-to-use-reports-displaying-results-individual"></a>

对于描述单个测试的报告，Device Farm 会显示表示测试结果状态的图标：


| 说明 | 图标 | 
| --- | --- | 
| 测试成功。 | ![\[The test succeeded.\]](http://docs.aws.amazon.com/zh_cn/devicefarm/latest/developerguide/images/df-run-success.png) | 
| 测试失败。 | ![\[The test failed.\]](http://docs.aws.amazon.com/zh_cn/devicefarm/latest/developerguide/images/df-run-failure.png) | 
| Device Farm 跳过了测试。 | ![\[The test was skipped.\]](http://docs.aws.amazon.com/zh_cn/devicefarm/latest/developerguide/images/df-run-skipped.png) | 
| 已停止测试。 | ![\[The test was stopped.\]](http://docs.aws.amazon.com/zh_cn/devicefarm/latest/developerguide/images/df-run-stopped.png) | 
| Device Farm 返回了警告。 | ![\[Device Farm returned a warning.\]](http://docs.aws.amazon.com/zh_cn/devicefarm/latest/developerguide/images/df-run-warning.png) | 
| Device Farm 返回了错误。 | ![\[Device Farm returned an error.\]](http://docs.aws.amazon.com/zh_cn/devicefarm/latest/developerguide/images/df-run-error.png) | 

## 多个测试的状态
<a name="how-to-use-reports-displaying-results-summary"></a>

如果您选择已完成的运行，Device Farm 会显示一个汇总图表，其中显示不同状态下的测试所占百分比。

![\[Device Farm test results summary graph.\]](http://docs.aws.amazon.com/zh_cn/devicefarm/latest/developerguide/images/df-summary-results-graph.png)

例如，此测试运行结果栏显示运行中有 4 个测试已停止、有 1 个测试失败以及有 10 个测试成功。

图表始终采用颜色编码和标记。