Mulai 27 Maret 2025, sebaiknya gunakan android-latest-release, bukan aosp-main, untuk mem-build dan berkontribusi pada AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.
Menjalankan pengujian otomatis (Android 11 atau yang lebih baru)
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Ada dua opsi untuk menjalankan pengujian otomatis CTS:
Trade Federation adalah framework aplikasi dan pengujian yang memungkinkan Anda
menjalankan pengujian dari command line. Pada dasarnya, framework
memungkinkan Anda menganotasi pengujian menggunakan anotasi @Test dan aplikasi menemukan serta menjalankan
pengujian tersebut.
OmniLab Android Test Station adalah aplikasi yang memungkinkan Anda menjalankan pengujian
di GUI.
Halaman ini menjelaskan cara menjalankan pengujian otomatis menggunakan Trade Federation. Untuk
mengetahui petunjuk cara menjalankan pengujian menggunakan OmniLab Android Test Harness, lihat
OmniLab Android Test Station.
Menjalankan semua pengujian CTS otomatis
Trade Federation berisi konsol CTS, antarmuka command line untuk
menjalankan pengujian. Untuk menjalankan seluruh rangkaian pengujian CTS otomatis:
- Pastikan Anda telah mengikuti petunjuk di Menyiapkan pengujian otomatis CTS.
Di workstation pengujian, luncurkan konsol CTS dengan menjalankan skrip cts-tradefed dari folder tempat paket CTS diekstrak:
./android-cts/tools/cts-tradefed
Konsol CTS menampilkan kursor untuk Anda mengetik perintah CTS
(cts-tradefed >).
Rencana pengujian cts berisi semua pengujian CTS otomatis. Jalankan perintah berikut untuk menjalankan rencana pengujian cts:
run cts
Pengujian CTS otomatis dijalankan. Perhatikan hal berikut:
Android 13 dan yang lebih baru mendukung pengujian multiperangkat. Pengujian ini berjalan
secara otomatis hanya saat sharding digunakan. Untuk informasi selengkapnya tentang sharding,
lihat Meningkatkan waktu eksekusi pengujian. Jika Anda ingin menjalankan pengujian ini
secara manual, lihat Menjalankan pengujian multiperangkat.
Setiap kali menjalankan CTS, tekan ctrl+c untuk menghentikan konsol CTS yang ada,
lalu jalankan kembali konsol CTS.
Anda tidak dapat menjalankan beberapa versi CTS di satu host karena setiap versi CTS akan terbuka
dengan server kode lokasi terbuka (OLC) yang ada.
Melihat hasil pengujian. Untuk mengetahui informasi selengkapnya, lihat Menafsirkan hasil CTS.
Jika ini adalah pengujian pertama Anda, mungkin ada pengujian yang gagal karena masalah di luar kendali Anda. Misalnya, koneksi jaringan mungkin lambat atau sinyal GPS mungkin lemah. Jalankan ulang (coba lagi) pengujian hingga semua modul pengujian selesai dan jumlah kegagalan pengujian sama antara dua sesi percobaan ulang terakhir:
run retry --retry session_number`
Setelah kegagalan pengujian konsisten di seluruh percobaan ulang, fokuslah pada proses debug
pengujian yang gagal. Untuk informasi tentang cara memecahkan masalah hasil
pengujian, lihat
Memilih kegagalan pengujian
dan
Memecahkan masalah pengujian CTS.
Menjalankan CTS untuk perangkat multilayar
Jika perangkat Anda menjalankan Android 11 atau 12, dan perangkat memiliki beberapa
layar, Anda harus menjalankan rencana pengujian cts-foldable secara terpisah:
run cts-foldable
Kasus pengujian yang lulus atau gagal untuk mode layar alternatif ditambahkan dengan
nilai dari display_mode, misalnya, testcase1[display_mode=0].
Menjalankan pengujian multiperangkat (Android 15 atau yang lebih lama)
Jalankan perintah berikut untuk menjalankan rencana pengujian cts-multidevice:
run cts-multidevice
Menjalankan setiap rencana pengujian
Daripada menjalankan semua rencana pengujian sekaligus, Anda dapat menjalankan setiap rencana pengujian. Opsi ini berguna untuk menghemat waktu dan berfokus pada kumpulan pengujian tertentu.
Untuk menjalankan setiap rencana pengujian:
Identifikasi nama rencana pengujian yang ingin Anda jalankan dengan menjalankan perintah list modules.
Jalankan rencana pengujian:
run cts --plan test_module_or_plan_name
Meningkatkan waktu eksekusi pengujian
Jika ingin meningkatkan waktu eksekusi pengujian, Anda dapat melakukan sharding pengujian di beberapa
perangkat. Sharding mengharuskan host menghubungkan minimal dua perangkat, tetapi enam perangkat atau
lebih direkomendasikan untuk efisiensi.
Untuk melakukan shard pengujian di Android 11 atau yang lebih baru, jalankan:
run cts --shard-count number_of_shards
Selain itu, sebelum menjalankan pengujian untuk validasi, Anda dapat meningkatkan waktu eksekusi
pengujian dengan menggunakan perintah run cts-dev CTS. Perintah ini melewati
prasyarat, pengumpulan informasi perangkat, dan semua pemeriksa status sistem.
Alat ini juga menjalankan pengujian hanya pada satu ABI.
Konten dan contoh kode di halaman ini tunduk kepada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-30 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-07-30 UTC."],[],[],null,["# Run automated tests (Android 11 or higher)\n\nThere are two options for running CTS automated tests:\n\n- *Trade Federation* is an app and test framework that lets you\n run tests from the command line. Fundamentally, the framework\n lets you annotate tests using the `@Test` annotation and the app finds and runs\n those tests.\n\n- *OmniLab Android Test Station* is an app that lets you run tests\n in a GUI.\n\nThis page explains how to run automated tests using Trade Federation. For\ninstructions on running tests using OmniLab Android Test Harness, see\n[OmniLab Android Test Station](/docs/core/tests/development/android-test-station/ats-user-guide).\n\nRun all automated CTS tests\n---------------------------\n\nTrade Federation contains the *CTS console*, a command-line interface for\nrunning tests. To run the entire automated CTS test suite:\n\n1. Ensure you have followed the instructions in [Set up CTS automated testing](/docs/compatibility/cts/setup).\n2. On your test workstation, launch the CTS console by running the `cts-tradefed` script from the folder where the CTS package has been unzipped:\n\n ./android-cts/tools/cts-tradefed\n\n The CTS console displays a cursor for you to type CTS commands\n (`cts-tradefed \u003e`).\n3. The `cts` test plan contains all of the automated CTS tests. Execute the\n following command to run the `cts` test plan:\n\n run cts\n\n The automated CTS tests execute. Note the following:\n - Android 13 and higher support multidevice testing. These tests run\n automatically only when sharding is used. For further information on sharding,\n see [Improve test execution time](#improve). If you want to run these tests\n manually, see [Run multidevice tests](#multi-device-testing).\n\n - Whenever running CTS, press **ctrl+c** to stop the existing CTS console\n and then rerun the CTS console.\n\n - You can't run multiple CTS versions on single host because each opens\n with an existing open location code (OLC) server.\n\n4. View test results. For more information, see [Interpret CTS results](/docs/compatibility/cts/interpret).\n\n5. If this is your first test run, there might be tests that fail due to issues beyond your control. For example, a network connection might be slow or a GPS signal might be weak. Rerun (retry) the tests until all test modules are completed and the test failure numbers are the same between the last two retry sessions:\n\n run retry --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 | **Note:** For instructions on how to run a retry session on Android 10 or lower, see [Run CTS automated tests (AOSP 10 or lower)](/docs/compatibility/cts/run-older).\n6. After tests failures are consistent across retries, focus on debugging\n the remaining failed tests. For information on troubleshooting test\n results, see\n [Triage test failures](/docs/compatibility/cts/interpret#triaging-test-failures)\n and\n [Troubleshoot CTS tests](/docs/compatibility/cts/troubleshooting).\n\n| **Note:** For a list of all CTS console commands, see [CTS v2 command console](/compatibility/cts/command-console-v2).\n\nRun CTS for multiscreen devices\n-------------------------------\n\nIf your device is running Android 11 or 12, 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]`.\n| **Note:** For instructions on how to run the `cts-foldable` test plan for Android 10 or lower, see [Run CTS automated tests (Android 10 or lower)](/docs/compatibility/cts/run-older).\n\nRun multidevice tests (Android 15 or lower)\n-------------------------------------------\n\nExecute the following command to run the `cts-multidevice` test plan: \n\n run cts-multidevice\n\nRun individual test plans\n-------------------------\n\nInstead of running all test plans at once, you can run individual test plans.\nThis option is useful to save time and to focus on a specific set of tests.\nTo run an individual test plan:\n\n1. Identify the name of the test plan you want to run by executing the `list modules` command.\n\n | **Note:** For instructions on how to identify the module on Android 10 or lower, see [Run CTS automated tests (Android 10 or lower)](/docs/compatibility/cts/run-older).\n2. Run the test plan:\n\n run cts --plan \u003cvar translate=\"no\"\u003etest_module_or_plan_name\u003c/var\u003e\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 11 or higher, run: \n\n run cts --shard-count \u003cvar translate=\"no\"\u003enumber_of_shards\u003c/var\u003e\n\nAdditionally, before running your tests for validation you can improve test\nexecution time by using the CTS `run cts-dev` command. This command skips\npreconditions, device-information collection, and all system status checkers.\nIt also runs the tests on only a single ABI."]]
