再試行機能の仕組みについては、テストの自動再試行のドキュメントをご覧ください。
再試行を行うと、デバイスが異常な状態になり、テストを成功させることができなくなる場合があります。分離機能を使用すると、デバイスをフレッシュな初期状態に戻し、テストを実行して成功させることができます。
機能を有効にする
再試行の分離機能を有効にするには、再試行オプションに加えて次のオプションを使用します。
--retry-isolation-grade <FULLY_ISOLATED|REBOOT_ISOLATED>
無効にするには、次のオプションを使用します。
--retry-isolation-grade NOT_ISOLATED
この機能はデフォルトでは無効になっています。
さまざまな等級の分離
分離等級は、再試行と再試行の間に構成する分離の程度を表します。
- FULLY_ISOLATED は、構成の構成済み target_preparers を再実行することにより、デバイスを完全にワイプしてリセットします。
- REBOOT_ISOLATED は、デバイスを再起動します。
互換性テストスイート（CTS）に関する注意事項
現在、Android パートナーの CTS 実行では FULLY_ISOLATED はサポートされていません。
結果の表示
結果レポーターは、特定のモジュールまたは実行が分離されて実行されているマーカーを受け取ります。また、レポートにマーカーを表示するかどうかを選択できます。
- モジュール レベルでは、
module-isolatedプロパティが分離等級に設定されます。 - 実行レベルでは、
run-isolatedプロパティが分離等級に設定されます。
たとえば、分離後に最初に実行されるモジュールは module-isolated:FULLY_ISOLATED として報告されます。
分離されたテスト実行は、強いシグナルを提供します。テストが合格か不合格かにかかわらず、テストオーナーは以前のテストによって生じた異常な状態がデバイスに残っていないと確信できます。