カスタムテスト環境を新しい iOS テストホストに移行する

Xcode バージョン: レガシーテストホスト環境では、使用可能な Xcode バージョンは、テストに使用されるデバイスの iOS バージョンに基づいていました。たとえば、iOS 18 デバイスのテストではレガシーホストで Xcode 16 が使用され、iOS 17 のテストでは Xcode 15 が使用されました。新しいホスト環境では、すべてのデバイスが同じバージョンの Xcode にアクセスできるため、異なるバージョンのデバイスでテストするための一貫した環境が可能になります。現在利用可能な Xcode バージョンのリストについては、「」を参照してください対応ソフトウェア。

ソフトウェアバージョンの選択: 多くの場合、デフォルトのソフトウェアバージョンが変更されているため、レガシーテストホストでソフトウェアバージョンを明示的に選択していない場合は、 を使用して新しいテストホストで指定できますdevicefarm-cli。ほとんどのユースケースで、お客様はご使用のソフトウェアのバージョンを選択することが推奨されます。でソフトウェアバージョンを選択すると、予測可能で一貫したエクスペリエンスdevicefarm-cliが得られ、Device Farm がテストホストからそのバージョンを削除する予定がある場合は、十分な警告が表示されます。

さらに、nvm、pyenv、 avm、rvm などのソフトウェア選択ツールは削除され、新しい devicefarm-cli ソフトウェア選択システムが採用されました。

利用可能なソフトウェアバージョン: 以前にプリインストールされたソフトウェアの多くのバージョンが削除され、多くの新しいバージョンが追加されました。そのため、devicefarm-cli を使用してソフトウェアバージョンを選択する際は、必ずサポート対象バージョンリストにあるバージョンを選択してください。

ツールlibimobiledeviceスイートは、現在の iOS デバイスのテストと業界標準を追跡するための新しい/ファーストパーティーツールに代わって削除されました。iOS 17 以降では、ほとんどのコマンドを移行して、 と呼ばれる同様の Xcode ツールを使用できますdevicectl。の詳細についてはdevicectl、Xcode がインストールされたマシンxcrun devicectl helpから を実行できます。

絶対パスとしてレガシーホストのテスト仕様ファイルでハードコードされたファイルパスは、新しいテストホストでは期待どおりに動作しない可能性が高く、通常はテスト仕様ファイルの使用には推奨されません。すべてのテスト仕様ファイルコードで相対パスと環境変数を使用することをお勧めします。詳細については、「」のトピックを参照してくださいカスタムテスト環境実行のベストプラクティス。

オペレーティングシステムのバージョンとアーキテクチャ: レガシーテストホストは、割り当てられたデバイスに基づいてさまざまな macOS バージョンと CPU アーキテクチャを使用していました。その結果、ユーザーは環境で使用可能なシステムライブラリにいくつかの違いに気付くことがあります。以前のホスト OS バージョンの詳細については、「」を参照してくださいレガシー iOS テストホスト。

Appium ユーザーの場合、WebDriverAgent を選択する方法は、古いプレフィックス DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_Vではなく、使用環境変数 DEVICEFARM_WDA_DERIVED_DATA_PATH_Vプレフィックスに変更されました。更新された変数の詳細については、「」を参照してくださいAppium テストの環境変数。

Appium Java ユーザーの場合、新しいテストホストにはクラスパスにプリインストールされた JAR ファイルが含まれていませんが、前のホストには TestNG フレームワーク用の JAR ファイルが含まれていました (環境変数 経由$DEVICEFARM_TESTNG_JAR)。お客様には、テストフレームワークに必要な JAR ファイルをテストパッケージ内にパッケージ化し、テスト仕様ファイルから $DEVICEFARM_TESTNG_JAR 変数のインスタンスを削除することをお勧めします。