翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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) の各ステップを完了します。Device Farm へのアクセス許可を持つ AWS アカウントと AWS Identity and Access Management (IAM) ユーザーが必要です。
+ Android の場合は、.apk (Android アプリパッケージ) ファイルを持ち込むか、提供されているサンプルアプリケーションを使用できます。iOS の場合は、.ipa (iOS アプリアーカイブ) ファイルが必要です。ここでは、後で同ファイルを Device Farm にアップロードします。
**注記**  
.ipa ファイルがシミュレーター用ではなく iOS デバイス用に作成されていることを確認します。
+ (オプション) Device Farm がサポートするいずれかのテストフレームワークからの 1 つのテストが必要です。そのテストパッケージを Device Farm にアップロードし、後でテストを実行します。使用可能なテストパッケージがない場合、標準ビルトインテストスイートを指定し、実行できます。詳細については、「[AWS Device Farm のテストフレームワークと組み込みテスト](test-types.md)」を参照してください。

## ステップ 1: コンソールにサインインする
<a name="getting-started-console"></a>

Device Farm コンソールを使用して、テスト用のプロジェクトや実行を作成および管理できます。プロジェクトや実行については、この後半で説明します。
+ [https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm) で Device Farm コンソールにサインインします。

## ステップ 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 アプリをテストする準備が整っていない場合、または Android (.apk) アプリをテストする場合は、**[Android アプリ]** を選択します。iOS (.ipa) アプリをテストする場合は、**[iOS アプリ]** を選択します。

1. **[アプリを選択]** の **[アプリの選択オプション]** セクションで、テストに使用できるアプリがない場合は、**[Device Farm が提供するサンプルアプリを選択]** を選択します。独自のアプリを持ち込む場合は、**[独自のアプリをアップロード]** を選択し、アプリケーションファイルを選択します。iOS アプリをアップロードする場合は、シミュレーターではなく、必ず **[iOS デバイス]** を選択してください。

1. **[テストの構成]** ページの **[テストフレームワークを選択]** でテストフレームワークか組込みテストスイートのいずれかを選択します。各オプションの詳細については、「[AWS Device Farm のテストフレームワークと組み込みテスト](test-types.md)」を参照してください。
   + Device Farm のテストをまだパッケージしていない場合は、**[ビルトイン: Fuzz]** を選択して、標準ビルトインテストスイートを実行します。**[イベント数]**、**[イベントスロットル]**、および **[乱数シード]** にはデフォルト値をそのまま使用できます。詳細については、「[Device Farm のビルトイン Fuzz テストの実行 (Android と iOS)](test-types-built-in-fuzz.md)」を参照してください。
   + サポートされているテストフレームワークのいずれかのテストパッケージがある場合は、対応するテストフレームワークを選択し、テストを含むファイルをアップロードします。

1. **[デバイスを選択]** で、**[デバイスプールを使用]** と **[上位デバイス]** を選択します。

1. (オプション) 設定を追加するには、**[追加設定]** ドロップダウンを開きます。このセクションで、次のいずれかの方法を実行できます。
   + 実行中に Device Farm が使用する他のデータを提供するには、**[別途データを追加]** の横の **[ファイルを選択** を選択後、データが含まれる .zip ファイルを参照して選択します。
   + 実行中に Device Farm が使用する追加のアプリケーションをインストールするには、**[他のアプリをインストール]** の横の **[ファイルを選択]** を選択し、アプリを含む .apk または .ipa ファイルを参照して選択します。インストールする他のアプリケーションにもこの手順を繰り返します。インストール順序を変更するには、アップロードした後にアプリケーションをドラッグアンドドロップします。
   + 実行中に Wi-Fi、Bluetooth、GPS、または NFC を有効にするかどうか指定するには、**[無線状態を設定]** の横にある適切なボックスを選択します。
   + 実行用のデバイスの緯度と経度をプリセットするには、**[デバイスの場所]** の横に座標を入力します。
   + 実行用のデバイスロケールをプリセットするには、**[デバイスロケール]** でロケールを選択します。
   + テスト中に動画を記録にするには、**[録画を有効化]** を選択します。
   + デバイスのパフォーマンスデータをキャプチャするには、**[アプリケーションのパフォーマンスデータキャプチャを有効化]** を選びます。
**注記**  
デバイスの無線状態とロケールの設定は、現時点では Android ネイティブテストでのみ使用できます。
**注記**  
プライベートデバイスがある場合は、[プライベートデバイス専用の構成] も表示されます。

1. ページの下部で、**[実行を作成]** を選択して実行をスケジュールします。

Device Farm は、デバイスが利用可能になると、通常数分以内に実行を開始します。実行ステータスを表示するには、プロジェクトの「**自動テスト**」ページで、実行の名前を選択します。「実行する」ページで、**[デバイス]** のデバイステーブルでは、最初に保留中アイコン ![\[Device Farm scheduled a job.\]](http://docs.aws.amazon.com/ja_jp/devicefarm/latest/developerguide/images/df-run-calendar.png) が表示され、テストが始まると実行中アイコン ![\[Device Farm progress indicator.\]](http://docs.aws.amazon.com/ja_jp/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)」を参照してください。