本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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。
**注意**  
請確定您的 .ipa 檔案是針對 iOS 裝置所建置，而非模擬器。
+ （選用） 您需要從 Device Farm 支援的其中一個測試架構進行測試。您可以將此測試套件上傳到 Device Farm，然後在本演練稍後執行測試。如果您沒有可用的測試套件，您可以指定並執行標準內建測試套件。如需詳細資訊，請參閱[AWS Device Farm 中的測試架構和內建測試](test-types.md)。

## 步驟 1：登入 主控台
<a name="getting-started-console"></a>

您可以使用 Device Farm 主控台來建立和管理專案並執行以進行測試。您稍後會在此逐步教學中了解專案與執行。
+ 登入 Device Farm 主控台，網址為 https：//[https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm)。

## 步驟 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 的測試，請選擇**內建：模糊**以執行標準的內建測試套件。您可以保留**事件計數**、**事件調節**和 **Randomizer 種子**的預設值。如需詳細資訊，請參閱[執行 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_tw/devicefarm/latest/developerguide/images/df-run-calendar.png)中的待定圖示開始，然後在![\[Device Farm progress indicator.\]](http://docs.aws.amazon.com/zh_tw/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)。