CTS testlerini çalıştırma

Ticaret Federasyonu, Android'de test çalıştırmaya yönelik bir sürekli test çerçevesidir cihazlar. Uyumluluk Test Paketi'ni (CTS) çalıştırmak için önce için Ticaret Federasyonuna Genel Bakış Tradefed test çerçevesinin açıklaması

Test planı çalıştırmak için:

  1. Test Altındaki Cihazları (DUT) şuna göre ayarlayın: Android cihaz kurulumu.
  2. Her iki uygulamanın da son sürümlerini yüklediğinizden emin olun. Android Debug Bridge (adb) ve Android Öğe Paketleme Aracı (AAPT) ve bu araçların konumlarını makinenizin sistem yoluna ekledi. Bu araçları yüklemeyle ilgili bilgi edinmek için bkz. CTS'yi ayarlama: ADB ve AAPT.
  3. Yayınlanan CTS derlemelerini Linux ana makinesinde derlemeyi açın ve ana makine konumuna yapıştırın.
  4. En az bir cihaz bağlayın. DUT'u hazırlamak için:
    • Cihazı ana ekrana ayarlamak için ana ekran düğmesine basın.
    • DUT kodunu başka görevler için kullanmayın.
    • Sensör etkinliğini tetiklememek için DUT'yi sabit bir konumda tutun.
    • Cihaz kamerasını odaklanılabilen bir nesneye doğru tutun.
    • CTS çalışırken cihazda hiçbir tuşa basmayın. Basılıyor DUT tuşlarına basmak veya ekrana dokunmak, çalışan testlerin çalışmasını engeller testin başarısız olmasına yol açabilir.
  5. CTS paketinin sıkıştırmasının açıldığı klasörden CTS konsolu cts-tradefed komut dosyasını başlatın. Ana makinenin komut satırı kabuğunda şu komutu ç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 iyileştirmek istiyorsanız testleri birden fazla cihaza dağıtabilirsiniz. Bölme işlemi için ana makinenin en az iki cihaz bağlaması gerekir ancak verimlilik için altı veya daha fazla cihaz kullanılması önerilir. 1'den fazla cihazı bölerken:

      • Android 9 ve sonraki sürümler için komut seçeneğini kullanın

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

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

      run cts --plan test_plan_name

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

      • Android 7.0 ve sonraki sürümler için test modüllerinin listesini görmek için

        list modules
      • Android 6.0 ve önceki sürümlerde test planlarının listesini kod deposu, girin

        list plans
      • Android 6.0 ve önceki sürümlerde, depodaki test paketlerinin listesini görüntülemek için

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

  7. Tüm test modülleri tamamlanana ve son iki yeniden deneme oturumunda test hatası sayıları aynı olana kadar birden fazla yeniden deneme oturumu çalıştırın.

    • Android 9 ve sonraki sürümler için

      run retry --retry session_number --shard-count number_of_shards
    • Android 7.0 - 8.1 için

      run cts --retry session_number --shards number_of_shards
    • CTS sürümüne bağlı olarak ek yeniden deneme komutu seçenekleri için CTS v2 Komut Konsolu'na bakın.

    • CTS yeniden denemesi için uygulama ayrıntılarını öğrenmek üzere Trade Federation Suite'i yeniden deneme başlıklı makaleyi inceleyin.

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

    • Android 11 ve sonraki sürümlerde aşağıdaki yeniden deneme komutu seçeneği etkindir run cts komutunda varsayılan olarak kullanılır:

      run retry --retry  --new-parameterized-handling
  9. Konsolda test ilerleme durumunu ve raporlanan sonuçları görüntüleyin.

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

Android Test Station, Android geliştiricilerinin ve uygulamalarını test ettikleri standart testi çalıştırmak için bir kullanıcı arayüzü süitleri. Android Compatibility Test Suite ile çalışır. (CTS) değerleridir.

Bu araç, ATS Kullanıcı Kılavuzu üzerinden herkese açık olarak kullanılabilir ve kodu AOSP'de açık kaynak olarak bulunur (multitest_transport,tradefed_cluster).

Alternatif Modlar için CTS'yi Çalıştırma

CTS 10 R4 sürümü, alternatif modları veya birden fazla ekranı olan cihazlar için bir test planı ekler. Alternatif modlar test planını şunu kullanarak yürütün: 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]).

CTS 13'te DeviceStateManager API, aşağıdaki özelliklere sahip test modüllerine izin verir: katlanabilir cihazın farklı cihaz durumlarında çalıştırılmasını sağlayan bir yapılandırma seçeneği sunar. CTS'de test yürütme işlemi, cts-foldable test planının çalıştırılmasına gerek kalmadan cihazda tanımlanan ekran katlama durumlarına göre otomatik olarak gerçekleşir.

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

CTS'de birden fazla cihaz testi

Android 13 ve sonraki sürümler çoklu cihaz testini destekler. CTS çalıştırması sırasında birden fazla cihaz gerektiren testler otomatik olarak yürütülür. CTS 13, bölümleme kullanıldığında otomatik olarak tetiklenen bazı çok cihazlı testler içerir. Test, fiziksel kurulumda ek değişiklikler gerektirmese de virtualenv uygulamasının yüklenmesi gerekiyor testlerin doğru şekilde çalıştırılması için gereklidir. Ayrıntılı bilgi için bkz. Birden Çok Cihazlı Paketler.

Birden çok cihazda testler yapın

Çok cihazlı testi 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 için Cihaz sayısı için --serial <serial1> --serial <serial2> vb. emin olabilirsiniz.

Çok cihazlı testleri otomatik olarak tetiklemek için --shard-count 2'te olduğu gibi parçalama kullanın.