CTS testlerini çalıştırın

Ticaret Federasyonu, Android cihazlarda testler yürütmek için sürekli bir test çerçevesidir. Uyumluluk Test Paketini (CTS) çalıştırmak için öncelikle Tradefed test çerçevesinin açıklaması için Ticaret Federasyonuna Genel Bakış bölümünü okuyun.

Bir test planı çalıştırmak için:

  1. Test Edilen Cihazları (DUT'lar) Android cihaz kurulumuna göre ayarlayın.
  2. Hem Android Debug Bridge'in (adb) hem de Android Asset Packaging Tool'un (AAPT) en son sürümlerini yüklediğinizden ve bu araçların konumunu makinenizin sistem yoluna eklediğinizden emin olun. Bu araçları yükleme hakkında bilgi için bkz. CTS Kurulumu: ADB ve AAPT.
  3. Yayınlanan CTS yapılarını Linux ana makinenize indirin ve yapıyı ana makine konumuna sıkıştırın.
  4. En az bir cihazı bağlayın. DUT'u hazırlamak için:
    • Cihazı ana ekrana ayarlamak için ana sayfa düğmesine basın.
    • DUT'u başka görevler için kullanmayın.
    • Sensör aktivitesinin tetiklenmesini önlemek için DUT'u sabit bir konumda tutun.
    • Cihaz kamerasını odaklanabilecek bir nesneye doğrultun.
    • CTS çalışırken cihaz üzerindeki herhangi bir tuşa basmayın. DUT'un tuşlarına basmak veya ekranına dokunmak, testlerin yürütülmesini engeller ve test hatalarına yol açabilir.
  5. CTS paketinin sıkıştırıldığı klasörden CTS konsolu cts-tradefed komut dosyasını başlatın. Ana bilgisayarın komut satırı kabuğunda şunu çalıştırın:

    ./android-cts/tools/cts-tradefed
  6. Varsayılan test planını çalıştırın (tüm test paketlerini içerir):

    cts-tradefed > run cts
    • Test yürütme süresini artırmak istiyorsanız testleri birden fazla cihaza dağıtabilirsiniz . Parçalama, ana bilgisayarın en az iki cihazı bağlamasını gerektirir ancak verimlilik için altı veya daha fazla cihaz önerilir. 1'den fazla cihazı parçalarken:

      • Android 9 ve üzeri için komut seçeneğini kullanın

        --shard-count number_of_shards
      • Android 8.1 ve önceki sürümler için komut seçeneğini kullanın

        --shards number_of_shards
    • Test paketinin tamamını çalıştırmak istemiyorsanız, seçtiğiniz CTS planını komut satırından çalıştırabilirsiniz:

      run cts --plan test_plan_name

      Test planı adını bulmak için:

      • Android 7.0 ve üzeri için test modüllerinin listesini görmek için şunu girin:

        list modules
      • Android 6.0 ve önceki sürümler için depodaki test planlarının listesini görüntülemek için şunu girin:

        list plans
      • Android 6.0 ve önceki sürümler için, depodaki test paketlerinin listesini görüntülemek için şunu girin:

        list packages
    • CTS sürümlerine bağlı ek komut seçenekleri için konsol komut referansına veya Tradefed konsolundaki "tüm yardım" bölümüne bakın.

  7. Tüm test modülleri tamamlanana ve test başarısızlık numaraları son iki yeniden deneme oturumunda aynı olana kadar birden fazla Yeniden Deneme oturumu çalıştırın.

    • Android 9 ve üzeri için şunu kullanın:

      run retry --retry session_number --shard-count number_of_shards
    • Android 7.0–8.1 için şunu kullanın:

      run cts --retry session_number --shards number_of_shards
    • CTS sürümüne bağlı olarak ek Yeniden Dene komutu seçenekleri için bkz. CTS v2 Komut Konsolu .

    • CTS yeniden denemesine ilişkin uygulama ayrıntılarını anlamak için bkz. Trade Federasyon Paketi Yeniden Denemesi .

  8. Yalnızca başarısız parametrelendirilmiş testlerde yeniden deneme oturumu çalıştırın. Geçilen parametreli testler yeniden denenmez.

    • Android 11 ve üzeri için, run cts komutunda aşağıdaki yeniden deneme komutu seçeneği varsayılan olarak etkindir:

      run retry --retry  --new-parameterized-handling
  9. Test ilerlemesini ve konsolda bildirilen sonuçları görüntüleyin.

Android Test Station'ı kullanarak CTS'yi çalıştırın

Android Test Station, Android geliştiricilerinin ve test mühendislerinin standart test paketlerini çalıştırmak için bir kullanıcı arayüzü kullanmak amacıyla kullanabileceği bir test otomasyon aracıdır. Android Uyumluluk Test Paketi (CTS) ile çalışır.

Araç , ATS Kullanıcı Kılavuzu aracılığıyla kamuya açıktır ve kodu AOSP'de açık kaynaklıdır ( multitest_transport , tradefed_cluster ).

Alternatif Modlar için CTS'yi çalıştırın

CTS 10 R4 sürümü, alternatif modlara sahip cihazlar veya birden fazla ekranı olan cihazlar için bir test planı ekler. Alternatif modlar test planını run cts-foldable yürütün.

Alternatif ekran modu için başarılı veya başarısız test senaryoları, display_mode öğesindeki değerle eklenir; örneğin, testcase1[display_mode=0] .

CTS 13'te DeviceStateManager API, aşağıdaki yapılandırma seçeneğine sahip test modüllerinin katlanabilir bir cihazın farklı cihaz durumlarında çalıştırılmasına olanak tanır. CTS cts-foldable test planını çalıştırmaya gerek kalmadan, cihazda tanımlanan ekran katlama durumlarına göre CTS'de test yürütmesi otomatiktir.

<option name="config-descriptor:metadata" key="parameter" value="all_foldable_states" />

CTS'de çoklu cihaz testi

Android 13 ve üzeri çoklu cihaz testini destekler. Birden fazla cihaz gerektiren testler, CTS çalıştırması sırasında otomatik olarak yürütülür. CTS 13, parçalama kullanıldığında otomatik olarak tetiklenen bazı çoklu cihaz testleri içerir. Test, fiziksel kurulumda ek değişiklikler gerektirmese de testlerin düzgün çalışması için virtualenv kurulması gerekir. Ayrıntılar için bkz. Çoklu Cihaz Paketleri .

Çoklu cihaz testleri çalıştırın

Çoklu cihaz testini bağımsız olarak çalıştırmak için aşağıdaki kodu kullanın:

  cts-tradefed > run cts-multidevice
  

Tüm normal seçenekler desteklenir. Belirli cihazları hedeflemek amacıyla, hedeflenen cihazların sayısı için --serial <serial1> --serial <serial2> vb. ekleyin.

Çoklu cihaz testlerini otomatik olarak tetiklemek için --shard-count 2 gibi parçalamayı kullanın.