27 Mart 2025'ten itibaren AOSP'yi derlemek ve AOSP'ye katkıda bulunmak için aosp-main yerine android-latest-release kullanmanızı öneririz. Daha fazla bilgi için AOSP'de yapılan değişiklikler başlıklı makaleyi inceleyin.
Otomatik testleri çalıştırma (Android 11 veya daha yeni sürümler)
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
CTS otomatik testlerini çalıştırmak için iki seçenek vardır:
Trade Federation, komut satırından test çalıştırmanıza olanak tanıyan bir uygulama ve test çerçevesidir. Temel olarak, çerçeve @Test ek açıklamasını kullanarak testlere ek açıklama eklemenize olanak tanır ve uygulama bu testleri bulup çalıştırır.
OmniLab Android Test İstasyonu, testleri bir GUI'de çalıştırmanıza olanak tanıyan bir uygulamadır.
Bu sayfada, Trade Federation'ı kullanarak otomatik testlerin nasıl çalıştırılacağı açıklanmaktadır. OmniLab Android Test Aparatı'nı kullanarak test çalıştırma talimatları için OmniLab Android Test İstasyonu başlıklı makaleyi inceleyin.
Tüm otomatik CTS testlerini çalıştırma
Trade Federation, test çalıştırmak için komut satırı arayüzü olan CTS konsolunu içerir. Otomatik CTS test paketinin tamamını çalıştırmak için:
- CTS otomatik testini ayarlama başlıklı makaledeki talimatları uyguladığınızdan emin olun.
Test iş istasyonunuzda, CTS paketinin sıkıştırmasının açıldığı klasörden cts-tradefed komut dosyasını çalıştırarak CTS konsolunu başlatın:
./android-cts/tools/cts-tradefed
CTS konsolunda, CTS komutlarını (cts-tradefed >) yazmanız için bir imleciniz olur.
cts test planı, tüm otomatik CTS testlerini içerir. cts test planını çalıştırmak için aşağıdaki komutu yürütün:
run cts
Otomatik CTS testleri çalıştırılır. Aşağıdakileri göz önünde bulundurun:
Android 13 ve sonraki sürümler çok cihazlı testi destekler. Bu testler yalnızca bölümleme kullanıldığında otomatik olarak çalışır. Bölme hakkında daha fazla bilgi için Test yürütme süresini iyileştirme başlıklı makaleyi inceleyin. Bu testleri manuel olarak çalıştırmak istiyorsanız Çok cihazlı testler çalıştırma başlıklı makaleyi inceleyin.
CTS'yi çalıştırırken mevcut CTS konsolunu durdurmak için ctrl+c tuşlarına basın ve ardından CTS konsolunu yeniden çalıştırın.
Her biri mevcut bir açık konum kodu (OLC) sunucusuyla açıldığı için tek bir ana makinede birden fazla CTS sürümü çalıştıramazsınız.
Test sonuçlarını görüntüleyin. Daha fazla bilgi için CTS sonuçlarını yorumlama başlıklı makaleyi inceleyin.
Bu ilk test çalıştırma işleminizse kontrolünüz dışındaki sorunlar nedeniyle başarısız olan testler olabilir. Örneğin, ağ bağlantısı yavaş veya GPS sinyali zayıf olabilir. Tüm test modülleri tamamlanana ve test başarısızlığı sayıları son iki yeniden deneme oturumu arasında aynı olana kadar testleri yeniden çalıştırın (yeniden deneyin):
run retry --retry session_number`
Testler, yeniden denemelerde tutarlı bir şekilde başarısız olursa kalan başarısız testlerde hata ayıklama işlemine odaklanın. Test sonuçlarıyla ilgili sorunları giderme hakkında bilgi edinmek için Test hatalarını önceliklendirme ve CTS testleriyle ilgili sorunları giderme başlıklı makaleleri inceleyin.
Çoklu ekranlı cihazlar için CTS'yi çalıştırma
Cihazınızda Android 11 veya 12 yüklüyse ve cihazınızda birden fazla ekran varsa cts-foldable test planını ayrı olarak çalıştırmanız gerekir:
run cts-foldable
Alternatif ekran modu için başarılı veya başarısız test durumlarına display_mode'teki değer eklenir (ör. testcase1[display_mode=0]).
Çok cihazlı testler çalıştırma (Android 15 veya önceki sürümler)
cts-multidevice test planını çalıştırmak için aşağıdaki komutu yürütün:
run cts-multidevice
Ayrı test planları çalıştırma
Tüm test planlarını aynı anda çalıştırmak yerine tek tek çalıştırabilirsiniz. Bu seçenek, zamandan tasarruf etmek ve belirli bir test grubuna odaklanmak için kullanışlıdır.
Tek bir test planını çalıştırmak için:
list modules komutunu yürüterek çalıştırmak istediğiniz test planının adını tanımlayın.
Test planını çalıştırın:
run cts --plan test_module_or_plan_name
Test yürütme süresini iyileştirme
Test yürütme süresini iyileştirmek istiyorsanız testleri birden fazla cihaza bölebilirsiniz. Bölme işlemi için barındırıcının en az iki cihaz bağlaması gerekir ancak verimlilik için altı veya daha fazla cihaz kullanılması önerilir.
Android 11 veya sonraki sürümlerde testleri bölme işlemini yapmak için:
run cts --shard-count number_of_shards
Ayrıca, doğrulama için testlerinizi çalıştırmadan önce CTS run cts-dev komutunu kullanarak test yürütme süresini artırabilirsiniz. Bu komut, ön koşulları, cihaz bilgisi toplamayı ve tüm sistem durumu kontrollerini atlar.
Ayrıca testleri yalnızca tek bir ABI'de çalıştırır.
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-30 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 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."]]
