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

# Device Farm 入门
<a name="getting-started"></a>

本演练展示了如何使用 Device Farm 来测试 Android 或 iOS 原生应用程序。您可以使用 Device Farm 控制台创建项目，上传 .apk 或 .ipa 文件，运行一系列标准测试，然后查看结果。

**注意**  
Device Farm 仅在 `us-west-2`（俄勒冈） AWS 区域中提供。

**Topics**
+ [先决条件](#getting-started-prepare)
+ [步骤 1：登录到 控制台](#getting-started-console)
+ [步骤 2：创建项目](#getting-started-create-project)
+ [步骤 3：创建和启动运行](#getting-started-create-run)
+ [步骤 4：查看运行结果](#getting-started-view-run-results)
+ [后续步骤](#getting-started-next-steps)

## 先决条件
<a name="getting-started-prepare"></a>

在开始之前，请确保您已满足以下要求：
+ 完成[设置](setting-up.md)中的步骤。您需要一个 AWS 账户和一个有权访问 Device Farm 的 AWS Identity and Access Management (IAM) 用户。
+ 对于 Android，您可以提交 .apk（Android 应用程序包）文件，或者使用我们提供的示例应用程序。对于 iOS，您需要 .ipa 文件（iOS 应用程序存档）文件。您可在此演练的稍后步骤中将文件上传到 Device Farm。
**注意**  
确保为 iOS 设备 (而不是模拟器) 构建您的 .ipa 文件。
+ （可选）您需要从 Device Farm 支持的某个测试框架中进行测试。您要将此测试包上传到 Device Farm，然后在本演练的稍后步骤中运行测试。(如果没有可用的测试包，则可以指定并运行标准的内置测试套件。) 有关更多信息，请参阅 [AWS Device Farm 中的测试框架和内置测试](test-types.md)。

## 步骤 1：登录到 控制台
<a name="getting-started-console"></a>

您可以使用 Device Farm 控制台创建和管理测试项目及运行。您将在本演练的稍后步骤中了解项目和运行。
+ 登录 DeviceFarm 控制台，网址为 [https://console.aws.amazon.com/devicef](https://console.aws.amazon.com/devicefarm) arm。

## 步骤 2：创建项目
<a name="getting-started-create-project"></a>

要在 Device Farm 中测试应用程序，您必须首先创建一个项目。

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

1. 在**移动设备测试项目**下，选择**创建项目**。

1. 在**创建项目**下，输入**项目名称**（例如，**MyDemoProject**）。

1. 选择**创建**。

   控制台将打开您新创建的项目的**自动测试**页面。

## 步骤 3：创建和启动运行
<a name="getting-started-create-run"></a>

现在您已经有了一个项目，下面就可以创建并启动运行。有关更多信息，请参阅 [运行](test-runs.md)。

1. 在**自动化测试**选项卡上，选择**创建运行**。或者，您可以通过选择**使用教程创建运行**来按照控制台中的教程进行操作。

1. （可选）在**运行设置**下的**运行名称**部分中，输入您的运行名称。如果未提供名称，则默认情况下，Device Farm 控制台会将您的运行命名为“My Device Farm run”。

1. 在**运行设置**下的**运行类型**部分中，选择您的运行类型。如果您没有可供测试的应用程序，或者您测试的是 Android（.apk）应用程序，请选择 **Android 应用程序**。如果您测试的是 iOS（.ipa）应用程序，请选择 **iOS 应用程序**。

1. 如果您没有可供测试的应用程序，请在**选择应用程序**下的**应用程序选择选项**部分中，选择**选择 Device Farm 提供的示例应用程序**。如果您自带应用程序，请选择**上传自己的应用程序**，然后选择您的应用程序文件。如果您要上传 iOS 应用程序，请确保选择 **iOS device (iOS 设备)**，而不是模拟器。

1. 在**配置测试**下的**选择测试框架**部分中，选择一个测试框架或内置测试套件。有关各选项的信息，请参阅 [AWS Device Farm 中的测试框架和内置测试](test-types.md)。
   + 如果您尚未为 Device Farm 打包测试，请选择**内置：模糊**来运行标准的内置测试套件。您可以保留**事件计数**、**事件限制**和**随机发生器种子**的默认值。有关更多信息，请参阅 [运行 Device Farm 的内置模糊测试（Android 和 iOS）](test-types-built-in-fuzz.md)。
   + 如果您有来自支持的测试框架之一的测试包，请选择相应的测试框架，然后上传包含您的测试的文件。

1. 在**选择设备**下，选择**使用设备池**和**主要设备**。

1. （可选）要添加其他配置，请打开**其他配置**下拉列表。在此部分，您可以执行以下任意操作：
   + 要为 Device Farm 提供其他将在运行期间使用的数据，请在**添加额外数据**旁边选择**选择文件**，然后浏览到并选择包含这些数据的 .zip 文件。
   + 要安装 Device Farm 将在运行期间使用的其他应用程序，请在**安装其他应用程序**旁边选择**选择文件**，然后浏览到并选择包含该应用程序的 .apk 或 .ipa 文件。为您要安装的其他应用程序重复此操作。在上传应用程序之后，您可以拖放应用程序来更改应用程序的安装顺序。
   + 要指定是否将在运行期间启用 Wi-Fi、蓝牙、GPS 或 NFC，请在 **Set radio states (设置电台)** 旁边选中相应框。
   + 要为运行预设设备纬度和经度，请在 **Device location (设备位置)** 旁边输入坐标。
   + 要为运行预设设备区域设置，请在**设备区域设置**中选择区域设置。
   + 选择**启用视频记录**以在测试期间启用视频记录。
   + 选择**启用应用程序性能数据捕获**以启用从设备捕获性能数据。
**注意**  
目前，设置设备无线电状态和区域设置选项仅适用于 Android 本地测试。
**注意**  
如果您有私有设备，还将显示特定于私有设备的配置。

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)。每次测试完成后，控制台会在设备名称旁边显示一个测试结果图标。所有测试完成后，运行旁边的待处理图标将变为测试结果图标。

## 步骤 4：查看运行结果
<a name="getting-started-view-run-results"></a>

要查看运行的测试结果，请在项目的**自动测试**页面上，选择运行的名称。此时将显示摘要页面：
+ 按结果列出的测试总数。
+ 具有唯一的警告或故障的测试列表。
+ 设备和每个设备的测试结果的列表。
+ 在运行期间捕获的任何屏幕截图，按设备分组。
+ 用于下载解析结果的部分。

有关更多信息，请参阅 [在 Device Farm 中查看测试报告](how-to-use-reports.md)。

## 后续步骤
<a name="getting-started-next-steps"></a>

有关 Device Farm 的更多信息，请参阅[概念](concepts.md)。