2025 年 3 月 27 日より、AOSP のビルドとコントリビューションには aosp-main
ではなく android-latest-release
を使用することをおすすめします。詳細については、AOSP の変更をご覧ください。
CTS 自動テストを実行する(AOSP 10 以前)
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
このページでは、Android 10 以前で CTS 自動テストを実行する手順について説明します。
再試行セッションを実行する
今回が初めてのテスト実行の場合は、外部要因などが原因でテストが失敗することがあります。たとえば、ネットワーク接続が遅い場合や GPS 信号が弱い場合などです。そのため、すべてのテスト モジュールが完了し、最後の 2 回の再試行セッションでテスト失敗の数が同じになるまで、テストを再実行(再試行)します。Android 9 および 10 で再試行セッションを実行する方法は次のとおりです。
run retry --retry session_number`
8.1 以前で再試行セッションを実行する方法は次のとおりです。
run cts --retry session_number
失敗したパラメータ化テストで再試行セッションを実行する
成功したパラメータ化テストは再試行されません。パラメータ化テストが失敗した場合にのみ再試行セッションを実行するには:
run retry --retry session_number --new-parameterized-handling
個々のテストプランを実行する
すべてのテストプランを一度に実行するのではなく、個々のテストプランを実行することもできます。個々のテストプランを実行するには、次のようにします。
実行するテストプランの名前を特定します。
Android 7 以降の場合:
list modules
Android 6 以前の場合:
list plans
テストプランを実行します。
run cts --plan test_module_or_plan_name
テスト実行時間を短縮する
テストの実行時間を短縮するには、複数のデバイス間でテストをシャーディングします。シャーディングするには、2 台以上のデバイスをホストに接続する必要がありますが、適切な効果を得るには 6 台以上接続することをおすすめします。
Android 9 または 10 でテストをシャーディングするには、次のコマンドを実行します。
run cts --shard-count number_of_shards
Android 8.1 以前でテストをシャーディングするには、次のコマンドを実行します。
run cts --shards number_of_shards
マルチスクリーン デバイスで CTS を実行する
デバイスが Android 10 を搭載していて、デバイスに複数の画面がある場合は、cts-foldable
テストプランを個別に実行する必要があります。
run cts-foldable
代替画面モードで合格または不合格になったテストケースには、display_mode
の値(testcase1[display_mode=0]
など)が末尾に付加されます。
このページのコンテンツやコードサンプルは、コンテンツ ライセンスに記載のライセンスに従います。Java および OpenJDK は Oracle および関連会社の商標または登録商標です。
最終更新日 2025-05-08 UTC。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2025-05-08 UTC。"],[],[],null,["# Run CTS automated tests (AOSP 10 or lower)\n\nThis page contains instructions for running CTS automated tests on Android 10\nor lower.\n\nRun a retry session\n-------------------\n\nIf this is your first test run, there might be tests that fail due to issues\nbeyond your control. For example, a network connection might be slow or a GPS\nsignal might be weak. So, rerun (retry) the tests until all test modules are\ncompleted and the test failure numbers are the same in the last two retry\nsessions. To run a retry session for Android 9 and 10: \n\n run retry --retry \u003cvar translate=\"no\"\u003esession_number\u003c/var\u003e`\n\nTo run a retry session for Android 8.1 or lower: \n\n run cts --retry \u003cvar translate=\"no\"\u003esession_number\u003c/var\u003e\n\n| **Note:** For implementation details for CTS retry, see [Use suite retry](/docs/core/tests/tradefed/testing/through-suite/suite-retry).\n\nRun a retry session on failed parameterized tests\n-------------------------------------------------\n\nPassed parameterized tests aren't retried. To run a retry session on failed\nparameterized tests only: \n\n run retry --retry \u003cvar translate=\"no\"\u003esession_number\u003c/var\u003e --new-parameterized-handling\n\nRun individual test plans\n-------------------------\n\nInstead of running all test plans at once, you can run individual test plans.\nTo run an individual test plan:\n\n1. Identify the name of the test plan you want to run.\n\n For Android 7 and higher: \n\n list modules\n\n For Android 6 or lower: \n\n list plans\n\n2. Run the test plan:\n\n run cts --plan \u003cvar translate=\"no\"\u003etest_module_or_plan_name\u003c/var\u003e\n\n| **Note:** For a list of all CTS console commands for Android 7 and higher, see [CTS v2 command console](/compatibility/cts/command-console-v2). For a list of all CTS console commands for Android 6 or lower, see [CTS v1 command console](/compatibility/cts/command_console).\n\nImprove test execution time\n---------------------------\n\nIf you want to improve test execution time, you can shard tests across multiple\ndevices. Sharding requires the host to connect at least two devices, but six or\nmore devices are recommended for efficiency.\n\nTo shard tests on Android 9 or 10, run: \n\n run cts --shard-count \u003cvar translate=\"no\"\u003enumber_of_shards\u003c/var\u003e\n\nTo shard tests on Android 8.1 or lower, run: \n\n run cts --shards \u003cvar translate=\"no\"\u003enumber_of_shards\u003c/var\u003e\n\nRun CTS for multiscreen devices\n-------------------------------\n\nIf your device is running Android 10, and your device has multiple\nscreens, you must run the `cts-foldable` test plan separately: \n\n run cts-foldable\n\nPassed or failed test cases for alternate screen mode are appended with the\nvalue from `display_mode`, for example, `testcase1[display_mode=0]`."]]