CTS v2 komut konsolu

CTS v2 konsolunu kullanma

Android 7.0 veya sonraki sürümler için CTS v2'yi kullanın.

Seçilen planlar

Kullanılabilir test planları şunlardır:

  • cts: Mevcut bir CTS kurulumundan CTS'yi çalıştırır.
  • cts-camera: Mevcut bir CTS kurulumundan CTS-camera'yı çalıştırır.
  • cts-java: Mevcut bir CTS kurulumundan Core Java Testleri'ni çalıştırır.
  • cts-pdk: PDK füzyon derlemesini doğrulamada faydalı olan testleri çalıştırır.
  • her şey: Uyumluluk paketleri için ortak yapılandırma.

Diğer kullanılabilir yapılandırmalar şunlardır:

  • basic-reporters: Temel CTS raporlayıcıları içeren yapılandırma.
  • collect-tests-only: CTS'yi önceden mevcut bir CTS kurulumundan çalıştırır.
  • common-compatibility-config: Uyumluluk paketleri için genel yapılandırma.
  • cts-filtered-sample: Uyumluluk paketleri için ortak yapılandırma.
  • cts-known-failures: CTS'de bilinen hataları içeren yapılandırma.
  • cts-önkoşulları: CTS önkoşulu yapılandırmaları.
  • host: Mevcut bir cihazda tek bir ana makine tabanlı test çalıştırır.
  • instrument: Mevcut bir cihazda tek bir Android araç testi çalıştırır.
  • native-benchmark: Mevcut bir cihazda yerel bir stres testi çalıştırır.
  • native-stress: Mevcut bir cihazda yerel stres testi çalıştırır.
  • recharge: Neredeyse boşalmış cihazları bekleyip şarj için bekleten sahte bir testtir.
  • testdef: test_def.xml dosyalarında bulunan testleri mevcut bir cihazda çalıştırır.
  • util/wifi: Cihazdaki kablosuz ağı yapılandırmak için kullanılan yardımcı program yapılandırması.
  • util/wipe: Cihazdaki kullanıcı verilerini temizler.

Bu planların ve yapılandırmaların tümü run cts komutuyla yürütülebilir.

CTS v2 konsol komutu referansı

Bu tabloda, çeşitli kullanım alanlarına yönelik CTS v2 konsol komutları özetlenmiştir.

Düzenleyen Açıklama
help En sık kullanılan komutların özetini görüntüleme
help all Kullanılabilir komutların tam listesini görüntüleme
version Sürümü gösterin.
exit CTS konsolundan sorunsuz bir şekilde çıkın. Şu anda çalışan tüm testler tamamlandığında konsol kapanır.
extdir

Sıkıştırılmış indirilenler dosyası extdir olarak sıkıştırılır. Şişirilmiş çıkıştan kurtulmak istiyorsanız -q seçeneğini kullanın:

unzip -q android-cts-9.0_r15-linux_x86-arm.zip -d extdir

Sıkıştırılmış dosyayı mevcut dizine açmak istiyorsanız -d seçeneğini kullanmayın, şunu çalıştırın:

unzip -q android-cts-9.0_r15-linux_x86-arm.zip

Çalıştır Açıklama
run cts

Android 10'da varsayılan CTS planını ve CTS-Instant'ı birlikte (yani tam CTS çağrısı) çalıştırın. Android 9 veya önceki sürümler için yalnızca varsayılan CTS planını çalıştırın. Cihaz doğrulaması için bu kapsamlı seçeneği (ön koşullar dahil) kullanın. Dahil edilecekler için cts.xml dosyasını inceleyin.

CTS konsolu, testler devam ederken diğer komutları kabul edebilir.

Bağlı cihaz yoksa CTS masaüstü makinesi (veya ana makine) testleri başlatmadan önce bir cihazın bağlanmasını bekler. Birden fazla cihaz bağlıysa CTS ana makinesi otomatik olarak bir cihaz seçer.

run cts-instant

Android 9 için varsayılan CTS-Instant planını çalıştırın.

run cts --module-parameter INSTANT_APP

Android 10'da varsayılan CTS-Instant planını çalıştırın.

run cts --module-parameter INSTANT_APP --module/-m test_module_name

Android 10'da, belirtilen CTS-Instant test modülü veya modüllerini çalıştırın.

run retry

Yalnızca Android 9 veya sonraki sürümler için. Önceki oturumlarda başarısız olan veya yürütülmeyen tüm testleri yeniden deneyin. Örneğin, TF bölme ile run retry --retry -s veya run retry --retry --shard-count.

run cts --retry sürümüne izin verilmiyor.

run cts-sim

Android 11 veya sonraki sürümler için. Test alt kümesini SIM kartı olan bir cihazda çalıştırır.

--device-token

Android 8.1 veya önceki sürümler için. Belirli bir cihazın belirli bir jetona sahip olduğunu belirtir. Örneğin, --device-token 1a2b3c4d:sim-card.

--enable-token-sharding

Yalnızca Android 10 veya sonraki sürümler için. İlgili SIM türünü gerektiren testi otomatik olarak eşleştirir. SIM ile ilgili test durumlarını yürütmek için cihaz seri numarası sağlamanıza gerek yoktur. Desteklenen SIM'ler: SIM_CARD, UICC_SIM_CARD ve SECURE_ELEMENT_SIM_CARD.

run cts-dev

Varsayılan CTS planını (yani tam CTS çağrısını) çalıştırın ancak yeni bir testin iteratif gelişimi için çalışma süresinden tasarruf etmek amacıyla ön koşulları atlayın. Bu işlem, --skip-preconditions seçeneği kullanıldığında olduğu gibi, cihazın yapılandırmasının doğrulanması ve ayarlanması (ör. medya dosyalarının aktarılması veya kablosuz bağlantı olup olmadığının kontrol edilmesi) işlemlerini atlar. Bu komut, cihaz bilgileri toplama işlemini ve tüm sistem durumu kontrollerini de atlar. Ayrıca testleri yalnızca tek bir ABI'de çalıştırır. Cihaz doğrulaması için bu optimizasyondan kaçının ve tüm ön koşulları ve kontrolleri dahil edin. Hariç tutulanlar için cts-dev.xml dosyasını inceleyin.

CTS konsolu, testler devam ederken diğer komutları kabul edebilir.

Bağlı cihaz yoksa CTS masaüstü makinesi (veya ana makine) testleri başlatmadan önce bir cihazın bağlanmasını bekler. Birden fazla cihaz bağlıysa CTS ana makinesi otomatik olarak bir cihaz seçer.

--subplan subplan_name Belirtilen alt planı çalıştırın.
--module/-m test_module_name --test/-t test_name  Belirtilen modülü ve testi çalıştırın. Örneğin, run cts -m Gesture --test android.gesture.cts.GestureTest#testGetStrokes belirli bir paketi, sınıfı veya testi çalıştırır.
--retry Önceki oturumlarda başarısız olan veya yürütülmeyen tüm testleri yeniden deneyin. Oturum kimliğini almak için list results kullanın.
--retry-type NOT_EXECUTED Yalnızca önceki oturumlarda yürütülmemiş testleri yeniden deneyin. Oturum kimliğini almak için list results kullanın.
--shards number_of_shards Android 8.1 veya önceki sürümler için. CTS çalıştırmasını belirli sayıda bağımsız parçaya bölerek birden fazla cihazda paralel olarak çalıştırın.
--shard-count number_of_shards Android 9 için. CTS çalıştırmasını belirli sayıda bağımsız parçaya bölerek birden fazla cihazda paralel olarak çalıştırın.
--serial/-s deviceID Belirli cihazda CTS'yi çalıştırın.
--include-filter "test_module_name test_name" Belirtilen modüller veya test paketleri, sınıflar ve durumlarla çalıştırın. Örneğin, run cts --include-filter "CtsCalendarcommon2TestCases android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" belirtilen modülü içerir.

Bu komut seçeneği, yeniden deneme çalıştırıldığında desteklenmez.

--exclude-filter "test_module_name test_name" Belirtilen modülleri veya test paketlerini, sınıfları ve test durumlarını çalıştırmadan hariç tutun. Örneğin, run cts --exclude-filter "CtsCalendarcommon2Test android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" belirtilen modülü hariç tutar.
--log-level-display/-l log_level STDOUT olarak görüntülenen minimum belirtilen günlük düzeyiyle çalıştırın. Geçerli değerler: [VERBOSE, DEBUG, INFO, WARN, ERROR, ASSERT].
--abi abi_name Testi, belirtilen ABI'de (32 veya 64) çalıştırmaya zorlar. CTS varsayılan olarak cihazın desteklediği her ABI için bir kez test yapar.
--logcat-on-failure,
--bugreport-on-failure,
--screenshoot-on-failure
Hatalarla ilgili daha fazla görünürlük sağlar ve teşhis konusunda yardımcı olabilir.
--device-token Belirli bir cihazın --device-token 1a2b3c4d:sim-card gibi belirli bir jetona sahip olduğunu belirtir.
--skip-device-info Cihazla ilgili bilgilerin toplanmasını atlar.
--skip-preconditions Yeni bir testin iteratif gelişimi için çalışma süresinden tasarruf etmek amacıyla ön koşulları atlayın. Bu işlem, cihazın yapılandırmasının doğrulanması ve ayarlanması (ör. medya dosyalarının aktarılması veya kablosuz bağlantının kontrol edilmesi) işlemlerini atlar.
Liste Açıklama
list modules Depodaki tüm mevcut test modüllerini listeleyin.
list plans veya list configs Depodaki tüm mevcut test planlarını (yapılandırmaları) listeleyin.
list subplans Depodaki tüm alt planları listeleyin.
list invocations Cihazlarda şu anda yürütülmekte olan run komutlarını listeler.
list commands Şu anda cihazlara atanmayı bekleyen tüm run komutlarını listeler.
list results Depoda depolanan CTS sonuçlarını listeleyin.
list devices Şu anda bağlı cihazları ve durumlarını listeler.

Kullanılabilir cihazlar, çalışan, boşta olan ve test çalıştırmaya uygun cihazlardır.

Kullanılamıyor cihazlar, adb üzerinden görülebilen ancak adb komutlarına yanıt vermeyen ve testler için ayrılmayacak cihazlardır.

Ayrılan cihazlar, şu anda test çalıştıran cihazlardır.

Döküm Açıklama
dump logs Çalışan tüm çağrılar için tradefed günlüklerini dökme.
Ekle Açıklama
add subplan --name/-n subplan_name
--result-type
[passed | failed | not_executed]
[--session session_id]
Önceki oturumdan türetilen bir alt plan oluşturun. Bu seçenek, bir test alt kümesini çalıştırmak için kullanılabilecek bir alt plan oluşturur.

Tek zorunlu seçenek --session'dur. Diğerleri isteğe bağlıdır ancak dahil edildiğinde bir değerle birlikte kullanılmalıdır. --result-type seçeneği tekrarlanabilir. Örneğin, add subplan --session 0 --result-type passed --result-type failed geçerlidir.