翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # カスタムテスト環境のホスト Device Farm は、テストホスト環境を使用して、ソフトウェアが事前設定された一連のオペレーティングシステムをサポートします。テストの実行中、Device Farm はテスト対象の選択したデバイスに動的に接続する Amazon マネージドインスタンス (ホスト) を使用します。このインスタンスは完全にクリーンアップされ、実行間で再利用されず、テスト実行の完了後に生成されたアーティファクトで終了します。 **Topics** + [カスタムテスト環境で使用できるテストホスト](#custom-test-environments-hosts-available) + [カスタムテスト環境のテストホストの選択](#test-host-selection) + [カスタムテスト環境内でサポートされているソフトウェア](custom-test-environments-hosts-software.md) + [Android デバイスのテスト環境](custom-test-environments-hosts-android.md) + [iOS デバイスのテスト環境](custom-test-environments-hosts-ios.md) ## カスタムテスト環境で使用できるテストホスト テストホストは Device Farm によって完全に管理されます。次の表に、カスタムテスト環境で現在利用可能でサポートされている Device Farm テストホストを示します。 | デバイスプラットフォーム | テストホスト | オペレーティングシステム | アーキテクチャ (複数可) | サポートされるデバイス | | --- | --- | --- | --- | --- | | Android | amazon\$1linux\$12 | Amazon Linux 2 | x86\$164 | Android 6 以降 | | iOS | macos\$1sequoia | macOS Sequoia (バージョン 15) | arm64 | iOS 15～26 | **注記** Device Farm は、新しいデバイス OS バージョンとその依存関係をサポートするために、デバイスプラットフォームの新しいテストホストを定期的に追加します。この場合、それぞれのデバイスプラットフォームの古いテストホストはサポート終了の対象となります。 ### オペレーティングシステムのバージョン 使用可能な各テストホストは、その時点で Device Farm でサポートされている特定のバージョンのオペレーティングシステムを使用します。最新の OS バージョンを使用しようとしますが、利用可能な最新のパブリック分散バージョンではない可能性があります。Device Farm は、マイナーバージョンの更新とセキュリティパッチを使用してオペレーティングシステムを定期的に更新します。 テストの実行中に使用されているオペレーティングシステムの特定のバージョン (マイナーバージョンを含む) を知るには、テスト仕様ファイルの任意のフェーズに次のコードスニペットを追加できます。 **Example** ``` phases: install: commands: # The following example prints the instance's operating system version details - |- if [[ "Darwin" == "$(uname)" ]]; then echo "$(sw_vers --productName) $(sw_vers --productVersion) ($(sw_vers --buildVersion))"; else echo "$(. /etc/os-release && echo $PRETTY_NAME) ($(uname -r))"; fi ``` ## カスタムテスト環境のテストホストの選択 Android および iOS テストホストは、[テスト仕様ファイルの](custom-test-environment-test-spec.md#custom-test-environment-test-spec-syntax)適切な 変数`android_test_host`と `ios_test_host`変数で指定できます。 特定のデバイスプラットフォームにテストホストの選択を指定しない場合、Device Farm が指定したデバイスとテスト設定のデフォルトとして設定したテストホストでテストが実行されます。 **重要** iOS 18 以前でテストする場合、ホストが選択されていない場合、レガシーテストホストが使用されます。詳細については、『』の「」トピックを参照してください[レガシー iOS テストホスト](custom-test-environments-hosts-ios.md#legacy-ios-host)。 例として、次のコードスニペットを確認します。 **Example** ``` version: 0.1 android_test_host: amazon_linux_2 ios_test_host: macos_sequoia phases: # ... ``` # カスタムテスト環境内でサポートされているソフトウェア Device Farm は、必要なソフトウェアライブラリの多くがプリインストールされたホストマシンを使用して、サービスでサポートされているテストフレームワークを実行し、起動時にすぐにテスト環境を提供します。Device Farm は、ソフトウェア選択メカニズムを使用して複数の言語をサポートし、環境に含まれる言語のバージョンを定期的に更新します。 その他の必要なソフトウェアについては、テスト仕様ファイルを変更して、テストパッケージからインストールしたり、インターネットからダウンロードしたり、VPC 内のプライベートソースにアクセスしたりできます (詳細については「[VPC ENI](https://docs.aws.amazon.com//devicefarm/latest/developerguide/vpc-eni.html) 」を参照)。詳細については、「[テスト仕様の例](custom-test-environment-test-spec.md#custom-test-environment-test-spec-example)」を参照してください。 ## 事前設定済みソフトウェア 各プラットフォームでのデバイステストを容易にするために、テストホストには次のツールが用意されています。 | ツール | デバイスプラットフォーム (複数可) | | --- | --- | | Android SDK Build-Tools | Android | | Android SDK Platform-Tools ( を含む`adb`) | Android | | Xcode | iOS | ## 選択可能なソフトウェア Device Farm は、ホストで事前設定されたソフトウェアに加えて、`devicefarm-cli`ツールを介してサポートされているソフトウェアの特定のバージョンを選択する方法を提供します。 次の表に、選択可能なソフトウェアと、それらを含むテストホストを示します。 | ソフトウェア/ツール | このソフトウェアをサポートするホスト | テスト仕様で使用するコマンド | | --- | --- | --- | | Java 17 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use java 17` | | Java 11 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use java 11` | | Java 8 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use java 8` | | Node.js 20 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use node 20` | | Node.js 18 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use node 18` | | Node.js 16 | amazon\$1linux\$12 | `devicefarm-cli use node 16` | | Python 3.11 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use python 3.11` | | Python 3.10 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use python 3.10` | | Python 3.9 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use python 3.9` | | Python 3.8 | amazon\$1linux\$12 | `devicefarm-cli use python 3.8` | | Ruby 3.2 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use ruby 3.2` | | Ruby 2.7 | amazon\$1linux\$12 | `devicefarm-cli use ruby 2.7` | | Appium 3 | amazon\$1linux\$12 | `devicefarm-cli use appium 3` | | Appium 2 | amazon\$1linux\$12 macos\$1sequoia | `devicefarm-cli use appium 2` | | Appium 1 | amazon\$1linux\$12 | `devicefarm-cli use appium 1` | | Xcode 26 | macos\$1sequoia | `devicefarm-cli use xcode 26` | | Xcode 16 | macos\$1sequoia | `devicefarm-cli use xcode 16` | テストホストには、`pip` や `npm` といったパッケージマネージャー (それぞれ Python と Node.js に付属)、Appium などのツール用の依存物 (Appium UIAutomator2 ドライバーなど) など、各ソフトウェアバージョンで一般的に使用されるサポートツールも含まれています。これにより、サポートされているテストフレームワークと連携するのに必要なツールが確実に入手できます。 # カスタムテスト環境での devicefarm-cli ツールの使用 テストホストは、 という標準化されたバージョン管理ツールを使用してソフトウェアバージョン` devicefarm-cli`を選択します。このツールは とは別に AWS CLI 、Device Farm テストホストでのみ使用できます。`devicefarm-cli` を使用すると、テストホストにプリインストールされている任意のソフトウェアバージョンに切り替えることができます。これにより、Device Farm のテスト仕様ファイルを長期にわたって簡単に管理でき、将来ソフトウェアバージョンをアップグレードするための予測可能なメカニズムも得られます。 **重要** このコマンドラインツールは、レガシー iOS ホストでは使用できません。詳細については、『』の「」トピックを参照してください[レガシー iOS テストホスト](custom-test-environments-hosts-ios.md#legacy-ios-host)。 以下のスニペットは `devicefarm-cli` の`help`ページを示しています: ``` $ devicefarm-cli help Usage: devicefarm-cli COMMAND [ARGS] Commands: help Prints this usage message. list Lists all versions of software configurable via this CLI. use Configures the software for usage within the current shell's environment. ``` `devicefarm-cli` を使った例をいくつか見てみましょう。このツールを使用して、テスト仕様ファイルの Python バージョンを *3.10* から *3.9* に変更するには、次のコマンドを実行します: ``` $ python --version Python 3.10.12 $ devicefarm-cli use python 3.9 $ python --version Python 3.9.17 ``` Appium のバージョンを *1* から *2* に変更するには: ``` $ appium --version 1.22.3 $ devicefarm-cli use appium 2 $ appium --version 2.1.2 ``` **ヒント** ソフトウェアバージョンを選択すると、`devicefarm-cli` は、Python 用の `pip` や NodeJS 用の `npm` など、その言語のサポートツールも切り替えることに注意してください。 テストホストにプリインストールされているソフトウェアの詳細については、「」を参照してください[カスタムテスト環境内でサポートされているソフトウェア](custom-test-environments-hosts-software.md)。 # Android デバイスのテスト環境 AWS Device Farm は、Amazon Linux 2 を実行している Amazon Elastic Compute Cloud (EC2) ホストマシンを利用して Android テストを遂行します。テスト実行をスケジュールすると、Device Farm は各デバイスが個別にテストを実行するよう専有ホストを割り当てます。ホストマシンは、生成されたアーティファクトとともにテスト実行後に終了します。 Amazon Linux 2 ホストにはいくつかの利点があります: + **より迅速で信頼性の高いテスト**: 新しいテストホストは、従来のホストと比べてテスト速度が大幅に向上し、特にテスト開始時間が短縮されます。Amazon Linux 2 ホストでは、テスト中の安定性と信頼性も向上しています。 + **手動テスト用のリモートアクセスの強化**: 最新のテストホストへのアップグレードと改善により、Android の手動テストにおけるレイテンシーの低下とビデオのパフォーマンスの向上がもたらされます。 + **標準ソフトウェアバージョン選択**: Device Farm は、Appium フレームワークのバージョンだけでなく、テストホストでの主要なプログラミング言語サポートも標準化するようになりました。サポートされている言語 (現在は Java、Python、Node.js、Ruby) と Appium について、新しいテストホストは発売後すぐに長期安定版リリースを提供します。`devicefarm-cli` ツールによる一元的なバージョン管理により、フレームワーク全体で一貫性のあるテスト仕様ファイル開発が可能になります。 **Topics** + [Device Farm の Amazon Linux 2 テスト環境でサポートされている IP 範囲](amazon-linux-2-ip-ranges.md) # Device Farm の Amazon Linux 2 テスト環境でサポートされている IP 範囲 多くの場合、Device Farm のトラフィックの発生元の IP 範囲を (特にファイアウォールとセキュリティ設定の設定する場合) 知っておく必要があります。Amazon EC2 テストホストの場合、IP 範囲は `us-west-2` リージョン全体を含みます。新しい Android 実行のデフォルトオプションである Amazon Linux 2 テストホストの場合、範囲は制限されています。トラフィックは特定の NAT ゲートウェイセットから発信されるようになり、IP 範囲は次のアドレスに制限されます。 **** | IP 範囲 | | --- | | **44.236.137.143** | | **52.13.151.244** | | **52.35.189.191** | | **54.201.250.26** | Device Farm の Android テスト環境の詳細については、「[Android デバイスのテスト環境](custom-test-environments-hosts-android.md)」を参照してください。 # iOS デバイスのテスト環境 Device Farm は、テスト実行中に iOS デバイスに動的に接続する Amazon マネージド macOS インスタンス (ホスト) を使用します。各ホストには、XCTestUI や Appium など、一般的なさまざまなテストプラットフォームでのデバイステストを可能にするソフトウェアが事前設定されています。 iOS テストホストの現在のイテレーションは、以前のバージョンと比較して、次のようなテストエクスペリエンスが向上しました。 + ** iOS 15 から iOS 26 のホスト OS とツールの一貫したエクスペリエンス ** 以前は、テストホストは使用中のデバイスによって決定され、複数の iOS バージョンで実行するときにソフトウェア環境が断片化されました。現在のエクスペリエンスでは、シンプルなホスト選択により、デバイス間で一貫した環境を実現できます。これにより、各 iOS デバイスで同じ macOS バージョンとツール (Xcode など) を使用できるようになります。 + ** iOS 15 および 16 テストのパフォーマンスの向上 ** 更新されたインフラストラクチャを使用すると、iOS 15 および 16 テストのセットアップ時間が大幅に向上しました。 + ** サポートされている依存関係用に標準化された選択可能なソフトウェアバージョン ** iOS と Android の両方のテストホストに`devicefarm-cli`ソフトウェア選択システムが追加され、サポートされている依存関係の任意のバージョンを選択できるようになりました。サポートされている依存関係 (Java、Python、Node.js、Ruby、Appium など) については、テスト仕様を使用してバージョンを選択できます。この機能の仕組みについては、「」のトピックを参照してください[カスタムテスト環境内でサポートされているソフトウェア](custom-test-environments-hosts-software.md)。 **重要** iOS 18 以前で を実行する場合、テストはデフォルトでレガシーテストホストで実行されます。レガシーホストから移行する方法については、以下のトピックを参照してください。 ## レガシー iOS テストホスト iOS 18 以下の既存のテストでは、カスタムテスト環境のレガシーテストホストがデフォルトで選択されます。次の表に、iOS デバイスバージョンによって で実行されるテストホストバージョンを示します。 | オペレーティングシステム | アーキテクチャ (複数可) | デバイスのデフォルト | | --- | --- | --- | | macOS Sonoma (バージョン 14) | arm64 | iOS 18 | | macOS Ventura (バージョン 13) | arm64 | iOS 17 | | macOS Monterey (バージョン 12) | x86\$164 | iOS 16 以下 | 新しいテストホストを選択するには、 に関するトピックを参照してください[カスタムテスト環境を新しい iOS テストホストに移行する](ios-host-migration.md)。 ## iOS デバイスでサポートされているソフトウェア iOS デバイステストをサポートするために、iOS デバイス用の Device Farm テストホストには Xcode および関連するコマンドラインツールが事前設定されています。その他の利用可能なソフトウェアについては、 に関するトピックを参照してください[カスタムテスト環境内でサポートされているソフトウェア](custom-test-environments-hosts-software.md)。 # カスタムテスト環境を新しい iOS テストホストに移行する 既存のテストをレガシーホストから新しい macOS テストホストに移行するには、既存のテスト仕様ファイルに基づいて新しいテスト仕様ファイルを開発する必要があります。 推奨されるアプローチは、目的のテストタイプのサンプルテスト仕様ファイルから開始し、関連するコマンドを古いテスト仕様ファイルから新しいテスト仕様ファイルに移行することです。これにより、既存のコードを再利用しながら、新しいホストのテスト仕様例の新機能と最適化を活用できます。 **Topics** + [チュートリアル: コンソールを使用した iOS テスト仕様ファイルの移行](#ios-host-migration-console-tutorial) + [新しいテストホストとレガシーテストホストの違い](#ios-host-migration-differences) ## チュートリアル: コンソールを使用した iOS テスト仕様ファイルの移行 この例では、Device Farm コンソールを使用して既存の iOS デバイステスト仕様をオンボードし、新しいテストホストを使用します。 ### ステップ 1: コンソールを使用して新しいテスト仕様ファイルを作成する 1. [AWS Device Farm コンソール](https://console.aws.amazon.com/devicefarm)にサインインします。 1. 自動化テストを含む Device Farm プロジェクトに移動します。 1. オンボードする既存のテスト仕様のコピーをダウンロードします。 1. 「プロジェクト設定**」オプションをクリックし、アップロード**タブに移動します。 1. オンボードするテスト仕様ファイルに移動します。 1. **ダウンロード**ボタンをクリックして、このファイルのローカルコピーを作成します。 1. プロジェクトページに戻り、**実行の作成**をクリックします。 1. ウィザードのオプションを、新しい実行を開始するかのように入力しますが、**テスト仕様の選択**オプションで停止します。 1. デフォルトで選択された iOS テスト仕様を使用して、**テスト仕様の作成**ボタンをクリックします。 1. テキストエディタで*デフォルトで*選択されたテスト仕様を変更します。 1. まだ存在しない場合は、以下を使用してテスト仕様ファイルを変更して新しいホストを選択します。 ``` ios_test_host: macos_sequoia ``` 1. 前のステップでダウンロードしたテスト仕様のコピーから、各 を確認します` phase`。 1. Java、Python、Node.js、Ruby、Appium、または Xcode のインストールまたは選択に関連するコマンドを無視して、古いテスト仕様のフェーズから新しいテスト仕様の各フェーズにコマンドをコピーします。 1. **** テキストボックスに新しいファイル名を入力します。 1. 変更を保存するには、**新しい名前で保存**ボタンをクリックします。 リファレンスとして使用できるテスト仕様ファイルの例については、「」で提供されている例を参照してください[テスト仕様の例](custom-test-environment-test-spec.md#custom-test-environment-test-spec-example)。 ### ステップ 2: プリインストールされたソフトウェアを選択する 新しいテストホストでは、 という新しい標準化バージョン管理ツールを使用して、プリインストールされたソフトウェアバージョンが選択されます`devicefarm-cli`。このツールは、テストホストで提供されているさまざまなソフトウェアを使用するための推奨アプローチになりました。 たとえば、次の行を追加して、テスト環境の別の JDK 17 を使用します。 ``` - devicefarm-cli use java 17 ``` サポートされているソフトウェアの詳細については、「」を参照してください[カスタムテスト環境内でサポートされているソフトウェア](custom-test-environments-hosts-software.md)。 ### ステップ 3: ソフトウェア選択ツールによる Appium とその依存関係の使用 新しいテストホストは Appium 2.x 以降のみをサポートしています。などのレガシーツールを削除しながら`devicefarm-cli`、 を使用して Appium バージョンを明示的に選択してください` avm`。例えば、次のようになります。 ``` # This line using 'avm' should be removed # - avm 2.3.1 # And the following lines should be added - devicefarm-cli use appium 2 # Selects the version - appium --version # Prints the version ``` で選択された Appium バージョン`devicefarm-cli`には、互換性のあるバージョンの iOS 用 XCUITest ドライバーがプリインストールされています。 さらに、 ` DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V9`の代わりに を使用するようにテスト仕様を更新する必要があります` DEVICEFARM_WDA_DERIVED_DATA_PATH`。新しい環境変数は、Appium 2 テストでサポートされている最新バージョンである WebDriverAgent 9.x のビルド済みバージョンを指します。 詳細については、[iOS テスト用の WebDriverAgent バージョンの選択](test-types-appium.md#test-types-appium-select-wda)「」および「」を参照してください[Appium テストの環境変数](custom-test-environment-variables.md#custom-test-environment-variables-appium)。 ## 新しいテストホストとレガシーテストホストの違い 新しい iOS テストホストを使用するようにテスト仕様ファイルを編集し、レガシーテストホストからテストを移行する場合は、以下の主な環境の違いに注意してください。 + ** Xcode バージョン: ** レガシーテストホスト環境では、使用可能な Xcode バージョンは、テストに使用されるデバイスの iOS バージョンに基づいていました。たとえば、iOS 18 デバイスのテストではレガシーホストで Xcode 16 が使用され、iOS 17 のテストでは Xcode 15 が使用されました。新しいホスト環境では、すべてのデバイスが同じバージョンの Xcode にアクセスできるため、異なるバージョンのデバイスでテストするための一貫した環境が可能になります。現在利用可能な Xcode バージョンのリストについては、「」を参照してください[対応ソフトウェア](custom-test-environments-hosts-software.md)。 + ** ソフトウェアバージョンの選択: ** 多くの場合、デフォルトのソフトウェアバージョンが変更されているため、レガシーテストホストでソフトウェアバージョンを明示的に選択していない場合は、 を使用して新しいテストホストで指定できます[`devicefarm-cli`](custom-test-environments-hosts-software-cli.md)。ほとんどのユースケースで、お客様はご使用のソフトウェアのバージョンを選択することが推奨されます。でソフトウェアバージョンを選択すると、予測可能で一貫したエクスペリエンス`devicefarm-cli`が得られ、Device Farm がテストホストからそのバージョンを削除する予定がある場合は、十分な警告が表示されます。 さらに、`nvm`、`pyenv`、` avm`、`rvm` などのソフトウェア選択ツールは削除され、新しい ` devicefarm-cli` ソフトウェア選択システムが採用されました。 + ** 利用可能なソフトウェアバージョン: ** 以前にプリインストールされたソフトウェアの多くのバージョンが削除され、多くの新しいバージョンが追加されました。そのため、`devicefarm-cli` を使用してソフトウェアバージョンを選択する際は、必ず[サポート対象バージョンリスト](custom-test-environments-hosts-software.md)にあるバージョンを選択してください。 + ツール**`libimobiledevice`スイートは、現在の iOS デバイスのテストと業界標準を追跡するために、新しい/ファーストパーティーツールを優先して削除されました**。iOS 17 以降では、ほとんどのコマンドを移行して、 と呼ばれる同様の Xcode ツールを使用できます`devicectl`。の詳細については`devicectl`、Xcode がインストールされたマシン`xcrun devicectl help`から を実行できます。 + 絶対**パスとしてレガシーホストのテスト仕様ファイルでハードコードされたファイル**パスは、新しいテストホストでは期待どおりに動作しない可能性が高く、通常はテスト仕様ファイルの使用には推奨されません。すべてのテスト仕様ファイルコードで相対パスと環境変数を使用することをお勧めします。詳細については、「」のトピックを参照してください[カスタムテスト環境実行のベストプラクティス](custom-test-environments-best-practices.md)。 + ** オペレーティングシステムのバージョンとアーキテクチャ: ** レガシーテストホストは、割り当てられたデバイスに基づいてさまざまな macOS バージョンと CPU アーキテクチャを使用していました。その結果、ユーザーは環境で使用可能なシステムライブラリにいくつかの違いに気付くことがあります。以前のホスト OS バージョンの詳細については、「」を参照してください[レガシー iOS テストホスト](custom-test-environments-hosts-ios.md#legacy-ios-host)。 + **Appium ユーザーの場合**、WebDriverAgent を選択する方法は、古いプレフィックス` DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V`ではなく、使用環境変数` DEVICEFARM_WDA_DERIVED_DATA_PATH_V`プレフィックスに変更されました。更新された変数の詳細については、「」を参照してください[Appium テストの環境変数](custom-test-environment-variables.md#custom-test-environment-variables-appium)。 + **Appium Java** ユーザーの場合、新しいテストホストにはクラスパスにプリインストールされた JAR ファイルが含まれていませんが、前のホストには TestNG フレームワーク用の JAR ファイルが含まれていました (環境変数 経由`$DEVICEFARM_TESTNG_JAR`)。お客様には、テストフレームワークに必要な JAR ファイルをテストパッケージ内にパッケージ化し、テスト仕様ファイルから `$DEVICEFARM_TESTNG_JAR` 変数のインスタンスを削除することをお勧めします。 ソフトウェアの観点からテストホスト間の違いについてフィードバックや質問がある場合は、サポートケースを通じてサービスチームに連絡することをお勧めします。