CTS v2 komut konsolu

CTS v2 konsolunu kullanma

Android 7.0 veya üzeri için CTS v2'yi kullanın.

Planları seçin

Mevcut test planları aşağıdakileri içerir:

  • cts —CTS'yi önceden var olan bir CTS kurulumundan çalıştırır.
  • cts-camera — Önceden var olan bir CTS kurulumundan CTS kamerasını çalıştırır.
  • cts-java — Önceden var olan bir CTS kurulumundan Temel Java Testlerini çalıştırır.
  • cts-pdk — Bir PDK füzyon yapısının doğrulanmasında yararlı olan Testleri çalıştırır.
  • her şey — Uyumluluk paketleri için ortak yapılandırma.

Mevcut diğer konfigürasyonlar aşağıdakileri içerir:

  • basic-reporters — Temel CTS raporlayıcılarıyla yapılandırma.
  • Collect-tests-only —CTS'yi önceden var olan bir CTS kurulumundan çalıştırır.
  • common-compatibility-config — Uyumluluk paketleri için ortak yapılandırma.
  • cts-filtered-sample — Uyumluluk paketleri için ortak yapılandırma.
  • cts-known-failures — Bilinen CTS hatalarıyla yapılandırma.
  • cts-preconditions — CTS önkoşul yapılandırmaları.
  • ana bilgisayar — Mevcut bir cihazda tek bir ana bilgisayar tabanlı test çalıştırır.
  • enstrüman — Mevcut bir cihazda tek bir Android enstrümantasyon 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 — Şarjı neredeyse biten cihazları bekleyen ve onları şarj için tutan sahte bir test.
  • testdef — Mevcut bir cihazda test_def.xml dosyalarında bulunan testleri çalıştırır.
  • util/wifi — Cihazda Wi-Fi'yi yapılandırmak için yardımcı program yapılandırması.
  • util/wipe — Cihazdaki kullanıcı verilerini siler.

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

CTS v2 konsol komut referansı

Bu tablo, çeşitli kullanımlara yönelik CTS v2 konsolu komutlarını özetlemektedir.

Ev sahibi Tanım
help En sık kullanılan komutların özetini görüntüleyin
help all Mevcut komutların tam listesini görüntüleyin
version Sürümü göster.
exit CTS konsolundan zarif bir şekilde çıkın. Şu anda yürütülen tüm testler bittiğinde konsol kapanır.
extdir

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

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

Geçerli dizine açmak istiyorsanız -d seçeneğini kullanmayın, yalnızca şunu çalıştırın:

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

Koşmak Tanım
run cts

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

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

Hiçbir cihaz bağlı değilse CTS masaüstü makinesi (veya ana bilgisayarı), testlere başlamadan önce bir cihazın bağlanmasını bekleyecektir. Birden fazla cihaz bağlıysa CTS ana bilgisayarı otomatik olarak bir cihaz seçecektir.

run cts-instant

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

run cts --module-parameter INSTANT_APP

Android 10'da varsayılan CTS-Anında 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ünü veya modüllerini çalıştırın.

run retry

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

Android 9 veya üzeri sürümlerde run cts --retry izin verilmez.

run cts-sim

Android 11 veya üzeri sürümler için. Testlerin alt kümesini SIM kartlı bir cihazda çalıştırır.

--device-token

Android 8.1 veya daha düşük sürümler için. Belirli bir aygıtın verilen belirtece sahip olduğunu belirtir. Örneğin, --device-token 1a2b3c4d:sim-card .

--enable-token-sharding

Yalnızca Android 10 veya üzeri için . İlgili SIM tipini gerektiren testle otomatik olarak eşleşir. SIM ile ilgili test senaryolarını yürütmek için cihaz seri numarası sağlamaya 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 yinelemeli gelişimi için çalışma süresinden tasarruf etmek amacıyla ön koşulları atlayın. Bu, --skip-preconditions seçeneği kullanıldığında yapıldığı gibi, medya dosyalarının gönderilmesi veya Wi-Fi bağlantısının kontrol edilmesi gibi cihaz yapılandırmasının doğrulanmasını ve kurulumunu atlar. Bu komut aynı zamanda cihaz bilgilerinin toplanmasını ve tüm sistem durumu denetleyicilerini de atlar. Ayrıca testleri yalnızca tek bir ABI üzerinde ç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'e bakın.

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

Hiçbir cihaz bağlı değilse CTS masaüstü makinesi (veya ana bilgisayarı), testlere başlamadan önce bir cihazın bağlanmasını bekleyecektir. Birden fazla cihaz bağlıysa CTS ana bilgisayarı otomatik olarak bir cihaz seçecektir.

--subplan subplan_name Belirtilen alt planı çalıştırın.
--module/-m test_module_name --test/-t test_name Belirtilen modülü çalıştırın ve test edin. Örneğin, run cts -m Gesture --test android.gesture.cts.GestureTest#testGetStrokes belirli 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ülmeyen testleri yeniden deneyin. Oturum kimliğini almak için list results kullanın.
--shards number_of_shards Android 8.1 veya daha düşük sürümler için . Birden fazla cihazda paralel olarak çalışmak için bir CTS çalışmasını belirli sayıda bağımsız parçaya bölün.
--shard-count number_of_shards Android9 için . Birden fazla cihazda paralel olarak çalışmak için bir CTS çalışmasını belirli sayıda bağımsız parçaya bölün.
--serial/-s deviceID Belirli bir cihazda CTS'yi çalıştırın.
--include-filter "test_module_name test_name" Belirtilen modüllerle veya test paketleri, sınıflar ve vakalarla çalıştırın. Örneğin, run cts --include-filter "CtsCalendarcommon2TestCases android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" belirtilen modülü içerir.

Yeniden deneme çalıştırılırken bu komut seçeneği desteklenmez.

--exclude-filter "test_module_name test_name" Belirtilen modülleri veya test paketlerini, sınıfları ve vakaları çalıştırmanın dışında bırakın. Örneğin, run cts --exclude-filter "CtsCalendarcommon2Test android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" belirtilen modülü hariç tutar.
--log-level-display/-l log_level STDOUT 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 verilen ABI (32 veya 64) üzerinde çalışmaya zorlayın. Varsayılan olarak CTS, cihazın desteklediği her ABI için bir test çalıştırır.
--logcat-on-failure ,
--bugreport-on-failure ,
--screenshoot-on-failure
Arızalara ilişkin daha fazla görünürlük sağlar ve tanılamaya yardımcı olabilir.
--device-token Belirli bir aygıtın --device-token 1a2b3c4d:sim-card gibi verilen belirtece sahip olduğunu belirtir.
--skip-device-info Cihazla ilgili bilgilerin toplanmasını atlar.
--skip-preconditions Yeni bir testin yinelemeli geliştirilmesi amacıyla çalışma süresinden tasarruf etmek için ön koşulları atlayın. Bu, medya dosyalarının iletilmesi veya Wi-Fi bağlantısının kontrol edilmesi gibi cihaz yapılandırmasının doğrulanmasını ve kurulumunu atlar.
Liste Tanım
list modules Depodaki mevcut tüm test modüllerini listeleyin.
planları veya list configs list plans Depodaki mevcut tüm test planlarını (yapılandırmaları) listeleyin.
list subplans Depodaki tüm mevcut alt planları listeleyin.
list invocations Cihazlarda halihazırda yürütülmekte olan 'çalıştır' komutlarını listeleyin.
list commands Şu anda kuyrukta bulunan ve cihazlara atanmayı bekleyen tüm 'çalıştırma' komutlarını listeleyin.
list results Şu anda depoda saklanan CTS sonuçlarını listeleyin.
list devices Şu anda bağlı olan cihazları ve durumlarını listeleyin.

'Kullanılabilir' cihazlar çalışıyor, boşta olan cihazlar, testleri çalıştırmak için kullanılabilir.

'Kullanılamayan' cihazlar, adb aracılığıyla görülebilen ancak adb komutlarına yanıt vermeyen ve testlere ayrılmayan cihazlardır.

'Ayrılan' cihazlar, halihazırda testleri yürüten cihazlardır.

Çöplük Tanım
dump logs Çalışan tüm çağrılar için takas edilen günlükleri boşaltın.
Eklemek Tanım
add subplan --name/-n subplan_name
--result-type
[pass | fail | timeout | notExecuted]
[--session session_id ]
Önceki oturumdan türetilmiş bir alt plan oluşturun; bu seçenek, testlerin bir alt kümesini çalıştırmak için kullanılabilecek bir alt plan oluşturur.

Gerekli olan tek seçenek --session . Diğerleri isteğe bağlıdır ancak dahil edildiklerinde arkasından bir değer gelmelidir. --result-type seçeneği tekrarlanabilir; örneğin add subplan --session 0 --result-type passed --result-type failed geçerli.