CTS-V testlerini çalıştırma

Android Compatibility Test Suite Verifier (CTS Verifier), Compatibility Test Suite'i (CTS) tamamlar. CTS, otomatikleştirilebilen API'leri ve işlevleri kontrol ederken CTS Doğrulayıcı, ses kalitesi, dokunmatik ekran, ivmeölçer ve kamera gibi manuel giriş veya konumlandırma olmadan sabit bir cihazda test edilemeyen API'ler ve işlevler için testler sağlar.

Şartlar

CTS Verifier'ı çalıştırmadan önce aşağıdaki ekipmanlara sahip olduğunuzdan emin olun:

  • CTS'yi geçerek Android API uyumluluğu doğrulanmış Android destekli cihaz. Bu, test edilen cihazdır (DUT).
  • USB 2.0 uyumlu bağlantı noktasına sahip Linux bilgisayar. DUT'a yapılan tüm bağlantılar bu bağlantı noktası üzerinden gerçekleşir.
  • Bluetooth, Wi-Fi Direct, Wi-Fi Aware, UWB (DUT, UWB'yi destekliyorsa) ve NFC ana makine kartı emülasyonu (HCE) uygulamasıyla uyumlu olduğu bilinen ikinci bir Android destekli cihaz.
  • Erişim noktası adı ve şifresiyle yapılandırılmış bir kablosuz yönlendirici. Yönlendirici, kapatılmadan internet bağlantısını kesebilmelidir.

Ayrıca UWB, Wi-Fi NAN ve Bluetooth RSSI için mesafe (yakınlık) ölçme testlerinde gerekli olan tripodları, cihaz tutucuları ve önceden ölçülmüş mesafeleri de hazırladığınızdan emin olun. Ayrıntılar için Varoluş kalibrasyonu bölümüne bakın.

NFC testleri için UICC koşulları

CTS Verifier'da aşağıdaki NFC test senaryoları bulunur:

  • Sahada olmayan (0x54'ten gelen işlem verilerini kullanır)
  • Seçimi kaldır (0x52 kimlikli işlem verilerini kullanır)
  • HCI komutu (0025000000) (0x02'deki işlem verilerini kullanır)

İşlem etkinliği testleri için iki cihaz gerekir. Bu cihazlardan birinde aşağıdaki erişim kurallarına sahip bir SecureElement UICC olmalıdır:

  • CtsVerifier APK karması: 61:ED:37:7E:85:D3:86:A8:DF:EE:6B:86:4B:D8:5B:0B:FA:A5:AF:81
  • NFC etkinliği erişimi için yetkili uygulama tanımlayıcısı (AID): 0xA000000476416E64726F696443545341

Emülatör tarafında, işlem etkinliğinin ilgili etkinliği ön plana çıkarmasını bekliyoruz.

Kurulum

Test cihazının sistem gezinme modunu aşağıdaki gibi üç düğmeli moda değiştirin:

  1. Ayarlar'ı açın.
  2. Sistem > Hareket > Sistemde gezinme'ye gidin.
  3. Varsa düğme tabanlı bir gezinme modu seçin (üç düğmeli mod tercih edilir).

CTS Verifier test ortamını ayarlamak için:

  1. Linux bilgisayarda:

    1. CTS Verifier'ı yüklemeden önce aşağıdaki komutu çalıştırarak SDK dışı arayüzlere erişime izin verin.
    adb shell settings put global hidden_api_policy 1

    1. Android Studio'yu yükleyin.

    2. Test edilecek Android sürümü için CTS Verifier APK'sını indirin.

  2. DUT'u Linux bilgisayara bağlayın.

  3. Linux bilgisayardaki bir terminalden DUT'a CtsVerifier.apk uygulamasını yükleyin:

    adb install -r -g CtsVerifier.apk

  4. Android 10 ve sonraki sürümlerde, uygulamaya rapor oluşturma izni vermek için aşağıdaki komutu çalıştırın:

    adb shell appops set com.android.cts.verifier android:read_device_identifiers allow

  5. Android 11 ve sonraki sürümlerde, raporların cihazın harici üst düzey dizini altındaki kullanıcı tanımlı bir dizine kaydedilmesine izin vermek için aşağıdaki komutu çalıştırın:

    adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0

  6. Android 13 ve sonraki sürümlerde, CTS Verifier için test API'sine erişime izin vermek üzere aşağıdaki komutu çalıştırın:

    adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier

  7. Android 14 ve sonraki sürümlerde, uygulamaya ekranı açma izni vermek için aşağıdaki komutu çalıştırın:

    adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0

  8. DUT'ta sistem tarihi ve saatinin doğru şekilde ayarlandığını doğrulayın.

CTS Doğrulayıcı'yı çalıştırma

DUT'ta CTS Doğrulayıcı simgesine dokunarak CTS Doğrulayıcı uygulamasını başlatın.

Başlatıcıda CTS Doğrulayıcı simgesi

Şekil 1. CTS Doğrulayıcı simgesi.

Uygulamada, manuel doğrulama için kullanılabilen çeşitli test kümeleri gösterilir.

CTS Doğrulayıcı test menüsü

Şekil 2. CTS Doğrulayıcı test menüsü.

Her testin ekranın alt kısmında bir dizi ortak öğe bulunur.

Video kalitesi doğrulayıcısı

Şekil 3. Yaygın test öğelerinin vurgulandığı test ekranı.

  • Geçti (✓): DUT, talimatlardaki test şartlarını karşılıyorsa bu seçeneğe dokunun.
  • Bilgi (?). Test talimatlarını görüntülemek için dokunun. Ayrıca, bir test ilk kez açıldığında otomatik olarak görünür.
  • Başarısız (!). DUT, Bilgi talimatlarına göre test koşullarını karşılamıyorsa bu seçeneğe dokunun.

USB aksesuar modu ve kamera kalibrasyon testi gibi bazı testler için aşağıdaki bölümlerde ayrıntılı olarak açıklanan ek test kurulumu ve talimatlar gerekir.

8.0 ve sonraki sürümlerde USB aksesuar modunu test etme

CTS Doğrulayıcı USB aksesuarı testi

Şekil 4. 8.0 ve sonraki sürümlerde USB aksesuarı test prosedürü

CTS Doğrulayıcı USB aksesuarı testi

Şekil 5. 8.0 ve sonraki sürümlerde USB aksesuar modu test ediliyor.

7.x ve önceki sürümlerde USB aksesuar modunu test etme

USB aksesuarı testi, USB masaüstü makine (ana makine) programını çalıştırmak için Linux bilgisayar gerektirir.

  1. DUT'u Linux bilgisayara bağlayın.

  2. Bilgisayarda, CTS Verifier paketindeki cts-usb-accessory programını çalıştırın:

    ./cts-usb-accessory

  3. DUT'ta bir iletişim kutusunun görünmesini bekleyin, ardından Tamam'a dokunun.

    CTS Doğrulayıcı USB aksesuarı testi

    Şekil 6. USB aksesuarı testi

  4. DUT'taki CTS Doğrulayıcı uygulamasında USB Aksesuar Testi'ne gidin.

  5. Bilgisayarda konsoldaki çıkışı inceleyin. Örnek çıkış:

    CTS USB Accessory Tester
Found possible Android device (413c:2106) - attempting to switch to accessory
mode...
Failed to read protocol versionfigure3
Found Android device in accessory mode (18d1:2d01)...
[RECV] Message from Android device #0
[SENT] Message from Android accessory #0
[RECV] Message from Android device #1
[SENT] Message from Android accessory #1
[RECV] Message from Android device #2
[SENT] Message from Android accessory #2
[RECV] Message from Android device #3
[SENT] Message from Android accessory #3
[RECV] Message from Android device #4
[SENT] Message from Android accessory #4
[RECV] Message from Android device #5
[SENT] Message from Android accessory #5
[RECV] Message from Android device #6
[SENT] Message from Android accessory #6
[RECV] Message from Android device #7
[SENT] Message from Android accessory #7
[RECV] Message from Android device #8
[SENT] Message from Android accessory #8
[RECV] Message from Android device #9
[SENT] Message from Android accessory #9
[RECV] Message from Android device #10
[SENT] Message from Android accessory #10

Kameranın görüş alanını kalibre etme

Cihazın görüş alanını orta düzeyde doğrulukla hızlı bir şekilde belirlemek için görüş alanı kalibrasyon prosedürünü kullanın.

  1. Test ortamını ayarlayın:

    1. Kalibrasyon deseni PDF hedef dosyasını 11" x 17" veya A3 boyutlu kağıda yazdırın.
    2. Yazdırılan deseni sert bir zemine monte edin.

    3. Kamera cihazını ve yazdırılmış hedefi aşağıdaki şemada gösterildiği gibi yönlendirin:

      Kamerayla yazdırılan hedef

      Şekil 7. Kameranın yazdırdığı hedef.

  2. Hedef genişliği ayarlayın:

    1. Baskı hatalarını hesaba katmak için hedef desendeki tam çizgiler arasındaki mesafeyi (santimetre cinsinden) ölçün (~38 cm).
    2. Kalibrasyon uygulamasını başlatın.
    3. Kurulum düğmesine basın ve İşaretçi mesafesi'ni seçin.
    4. Hedef desene olan mesafeyi (~100 cm) ölçün ve girin.
    5. Kalibrasyon önizlemesine dönmek için geri düğmesine basın.

  3. Cihazın ve hedefin şekilde gösterildiği gibi yerleştirildiğini ve kurulum iletişim kutusuna doğru mesafelerin girildiğini doğrulayın. Önizlemede, üzerine dikey bir çizgi yerleştirilmiş resim gösterilir. Bu çizgi, hedef desenin merkez çizgisiyle aynı hizada olmalıdır. Optik eksenin hedefe dik olduğunu doğrulamak için şeffaf ızgara diğer dikey çizgilerle birlikte kullanılabilir.

  4. Kalibrasyon testini çalıştırın:

    1. Bir görüntü çözünürlüğü seçin (sol alttaki seçiciyi kullanarak), ardından fotoğraf çekmek için ekrana dokunun. Test, kalibrasyon moduna girer ve fotoğrafı, resmin üzerine yerleştirilmiş iki dikey çizgiyle gösterir.
    2. Doğruluğu belirleme:
    3. Çizgiler, hedef desendeki dikey çizgilerle birkaç santimetre içinde hizalanıyorsa seçilen çözünürlük için bildirilen görüş alanı doğrudur.
    4. Çizgiler hizalanmıyorsa bildirilen görüş alanı doğru değildir. Bunu düzeltmek için ekranın alt kısmındaki kaydırma çubuğunu, yer paylaşımı hedef desenle mümkün olduğunca yakın şekilde hizalanana kadar ayarlayın. Yer paylaşımı ve hedef desen resmi hizalandığında, gösterilen görüş alanı doğru değere yakın bir yaklaşımdır. Bildirilen görüş alanı, kalibrasyon değerinin 2 derece içinde olmalıdır.
    5. Geri düğmesine basın ve kalibrasyon testini DUT tarafından desteklenen tüm görüntü çözünürlükleri için tekrarlayın.

Alternatif modlar için CTS Doğrulayıcı'yı çalıştırın

CTS 10 R6 ve CTS 11 R2 sürümlerinden itibaren CTS Verifier, alternatif modlara sahip cihazlar veya birden fazla ekran moduna sahip cihazlar için gerekli testleri destekler.

CTS Verifier'daki ana liste görünümünün üst kısmında, kullanıcıların açılmış ve katlanmış ekran modu arasında geçiş yapmasını sağlayan bir düğme gösterilir. CTS Verifier, seçilen ekran modu için gerekli testleri gösterir. CTS Verifier'da alternatif modları çalıştırmak için düğmeyi uygun ekran moduna getirip gösterilen test listesini çalıştırmanız gerekir.

CTS-V açma/kapatma anahtarı

Şekil 8. CTS Doğrulayıcı açma/kapatma anahtarı.

Katlanmış testlerin sonuçları, katlanmamış testlerle aynı raporda kaydedilir. Test grubunun hangi test sonucundan geldiğini belirlemek için katlanmış moddaki her test adına bir sonek eklenir.

<Test result="fail" name="com.android.cts.verifier.deskclock.DeskClockTestsActivity[folded]">
  <RunHistory subtest="CREATE_ALARM[folded]">
    <Run start="1594176663973" end="1594176665841" isAutomated="false" />
  </RunHistory>
</Test>

Sonuçları dışa aktarma

Tüm testler tamamlandıktan sonra sonuçları rapor olarak kaydedebilir ve bilgisayara indirebilirsiniz. Rapor adlarına, DUT sistem saatine göre otomatik olarak zaman damgası eklenir.

  1. Test sonuçlarınızı kaydetmek için test kategorileri listesinin üst kısmındaki kaydetme (disk) simgesine dokunun.

  2. Kayıtlı raporun yolunu gösteren bir iletişim kutusunun (örneğin, /sdcard/verifierReports/ctsVerifierReport-date-time.zip) görünmesini bekleyin, ardından yolu kaydedin.

  3. DUT'u Linux bilgisayara bağlayın.

  4. Linux bilgisayardaki Android SDK yüklemesinden, adb shell content read veya adb pull CTSVerifierReportPath kullanarak bağlı cihazdan raporları indirin.

    • Android 7.x ve sonraki sürümlerde, aşağıdaki komutu kullanarak tüm raporları indirin:

      adb pull /sdcard/verifierReports

    • Android 6.0 ve önceki sürümlerde, aşağıdaki komutu kullanarak tüm raporları indirin:

      adb pull /mnt/sdcard/ctsVerifierReports/

    • Android 10 ve sonraki sürümlerde, Automotive'i ve ikincil kullanıcı olarak çalışan cihazları uygulamak için aşağıdaki komutu kullanarak en son raporu indirin:

      adb shell content read --user <var>CURRENT_USER</var> --uri content://com.android.cts.verifier.testresultsprovider/reports/latest > report.zip

      Bağlı cihazda bulunan tüm raporları listelemek için:

        adb shell content query --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports
  ```

To download a report from the list, you can specify the Row ID or
filename. For example:

```shell
  adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports/0 > report.zip
  ```

```shell
  adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports ctsVerifierReport-date-time.zip > report.zip
  ```

  5. Geçti veya kaldı sonuçlarını temizlemek için CTS Verifier uygulamasında sonuçları seçip Menü > Temizle'yi seçin.