AWS Device Farm

パイプラインでは、AWS Device Farm を使用してデバイス上でアプリケーションを実行およびテストするテストアクションを設定できます。Device Farm は、デバイスのテストプールとテストフレームワークを使用して、特定のデバイス上でアプリケーションをテストします。Device Farm のアクションでサポートされているテストフレームワークのタイプついては、[AWS Device Farm でのテストタイプの操作] を参照してください。

注記

アクションタイプ

• カテゴリ:Test

• 所有者: AWS

• プロバイダー: DeviceFarm

• バージョン: 1

設定パラメータ

AppType

: 必須 はい

テストする OS とアプリケーションのタイプ。有効な値のリストを次に示します。

• iOS

• Android

• Web

ProjectId

: 必須 はい

Device Farm プロジェクト ID。

プロジェクト ID を見つけるには、Device Farm コンソールでプロジェクトを選択します。ブラウザで、新しいプロジェクトの URL をコピーします。URL には、プロジェクト ID が含まれます。プロジェクト ID は、projects/ 以降の URL の値です。次の例で、プロジェクト ID は eec4905f-98f8-40aa-9afc-4c1cfexample です。

https://<region-URL>/devicefarm/home?region=us-west-2#/projects/eec4905f-98f8-40aa-9afc-4c1cfexample/runs

アプリケーション

: 必須 はい

入力アーティファクト内のアプリケーションファイルの名前と場所。例: s3-ios-test-1.ipa

AppiumVersion

: 必須 はい

このテストに使用する Appium テストフレームワークのバージョン。

注記

- AppiumVersion フィールドの値は処理されません。代わりにデフォルト値が処理されます。

DevicePoolArn

: 必須 はい

Device Farm デバイスプールの ARN。

プロジェクトで使用可能なデバイスプール ARN (上位デバイスの ARN を含む) を取得するには、AWS CLI を使用して次のコマンドを入力します。

aws devicefarm list-device-pools --arn arn:aws:devicefarm:us-west-2:account_ID:project:project_ID

TestType

: 必須 はい

テストでサポートされるテストフレームワークを指定します。TestType の有効な値のリストを次に示します。

• [APPIUM_JAVA_JUNIT]

• APPIUM_JAVA_TESTNG

• APPIUM_PYTHON

• APPIUM_WEB_JAVA_JUNIT

• APPIUM_WEB_JAVA_TESTNG

• APPIUM_WEB_PYTHON

• BUILTIN_EXPLORER

• BUILTIN_FUZZZ

• CALABASH

• INSTRUMENTATION

• UIAUTOMATION

• UIAUTOMATOR

• PERFORMANCE_PROFILE

• XCTEST

• XCTEST_UI

注記

以下のテストタイプは、CodePipeline のアクション ではサポートされていません: WEB_PERFORMANCE_PROFILE、APPIUM_NODE、APPIUM_RUBY、APPIUM_WEB_NODE、APPIUM_WEB_RUBY、REMOTE_ACCESS_RECORD および REMOTE_ACCESS_REPLAY。

Device Farm のテストタイプついては、[AWS Device Farm でのテストタイプの操作] を参照してください。

RadioBluetoothEnabled

: 必須 いいえ

テストの開始時に Bluetooth を有効にするかどうかを示すブール値。

RecordAppPerformanceData

: 必須 いいえ

テスト中に CPU、FPS、メモリパフォーマンスなどのデバイスパフォーマンスデータを記録するかどうかを示すブール値。

RecordVideo

: 必須 いいえ

テスト中にビデオを記録するかどうかを示すブール値。

RadioWifiEnabled

: 必須 いいえ

テストの開始時に Wi-Fi を有効にするかどうかを示すブール値。

RadionFCenabled

: 必須 いいえ

テストの開始時に NFC を有効にするかどうかを示すブール値。

RadioGpsEnabled

: 必須 いいえ

テストの開始時に GPS を有効にするかどうかを示すブール値。

Test

: 必須 いいえ

ソースの場所にあるテスト定義ファイルの名前とパス。パスは、テストの入力アーティファクトのルートを基準とする相対パスです。

FuzzEventCount

: 必須 いいえ

ファズテストが実行するユーザーインターフェイスイベントの数で、1 から 10000 の間で指定します。

FuzzEventThrottle

: 必須 いいえ

ファズテストが次のユーザーインターフェースイベントを実行する前に待機するミリ秒数で、1 から 1000 の間で指定します。

FuzzRandomizerSeed

: 必須 いいえ

ユーザインタフェースイベントをランダム化するために使用するファズテストのシード。後続のファズテストに同じ番号を使用すると、同じイベントシーケンスになります。

CustomHostMachineArtifacts

: 必須 いいえ

ホストマシン上でカスタムアーティファクトが格納される場所。

CustomDeviceArtifacts

: 必須 いいえ

カスタムアーティファクトが保存されるデバイス上の場所。

UnmeteredDevicesOnly

: 必須 いいえ

この手順でテストを実行するときに、測定されていないデバイスのみを使用するかどうかを示すブール値。

JobTimeoutMinutes

: 必須 いいえ

テスト実行がタイムアウトになるまでにデバイスごとに実行される分数。

緯度

: 必須 いいえ

デバイスの緯度は、地理座標系の度数で表されます。

経度

: 必須 いいえ

地理座標系の度数で表されたデバイスの経度。

入力アーティファクト

• アーティファクトの数: 1

• 説明: テストアクションで使用可能にするアーティファクトのセット。Device Farm は、ビルドされたアプリケーションとテスト定義を使用するために検索します。

出力アーティファクト

• アーティファクトの数: 0

• 説明: 出力アーティファクトは、このアクションタイプには適用されません。

アクションの宣言

YAML

Name: Test
Actions:
  - Name: TestDeviceFarm
    ActionTypeId:
      category: Test
      owner: AWS
      provider: DeviceFarm
      version: '1'
    RunOrder: 1
    Configuration:
      App: s3-ios-test-1.ipa
      AppType: iOS
      DevicePoolArn: >-
        arn:aws:devicefarm:us-west-2::devicepool:0EXAMPLE-d7d7-48a5-ba5c-b33d66efa1f5
      FuzzEventCount: '6000'
      FuzzEventThrottle: '50'
      ProjectId: eec4905f-98f8-40aa-9afc-4c1cfEXAMPLE
      TestType: BUILTIN_FUZZ
    OutputArtifacts: []
    InputArtifacts:
      - Name: SourceArtifact
    Region: us-west-2

JSON

{
    "Name": "Test",
    "Actions": [
        {
            "Name": "TestDeviceFarm",
            "ActionTypeId": {
                "category": "Test",
                "owner": "AWS",
                "provider": "DeviceFarm",
                "version": "1"
            },
            "RunOrder": 1,
            "Configuration": {
                "App": "s3-ios-test-1.ipa",
                "AppType": "iOS",
                "DevicePoolArn": "arn:aws:devicefarm:us-west-2::devicepool:0EXAMPLE-d7d7-48a5-ba5c-b33d66efa1f5",
                "FuzzEventCount": "6000",
                "FuzzEventThrottle": "50",
                "ProjectId": "eec4905f-98f8-40aa-9afc-4c1cfEXAMPLE",
                "TestType": "BUILTIN_FUZZ"
            },
            "OutputArtifacts": [],
            "InputArtifacts": [
                {
                    "Name": "SourceArtifact"
                }
            ],
            "Region": "us-west-2"
        }
    ]
},

以下の資料も参照してください。

このアクションを利用する際に役立つ関連リソースは以下の通りです。

• [Device Farm でのテストタイプの実行] - [Device Farm 開発者ガイド] のこのリファレンス章では、Device Farm でサポートされる Android、iOS、および Web アプリケーションのテストフレームワークについて詳しく説明します。

• [Device Farm のアクション] - [Device Farm API リファレンス] の API 呼び出しとパラメータは、Device Farm プロジェクトの操作に役立ちます。

• チュートリアル: を使用して Android アプリケーションをビルドしてテストするパイプラインを作成するAWS Device Farmこのチュートリアルでは、 GitHub を使用して Android アプリを構築し、テストするソース CodeBuild およびDevice Farm。

• チュートリアル: iOS アプリをテストするパイプラインを作成するAWS Device Farm — このチュートリアルでは、Device Farm でビルドされた iOS アプリケーションをテストする Amazon S3 ソースでパイプラインを作成するためのサンプルアプリケーションを提供します。