CTS Doğrulayıcıyı Kullanma

Android Uyumluluk Testi Paketi Doğrulayıcı (CTS Doğrulayıcı), Uyumluluk Testi Paketini (CTS) tamamlar. CTS, otomatikleştirilebilen API'leri ve işlevleri kontrol ederken CTS Verifier, 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.

Gereksinimler

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

  • CTS'yi başarıyla geçerek Android API uyumluluğunu doğrulayan Android 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ından geçer.
  • Uyumlu olduğu bilinen bir Bluetooth, Wi-Fi direct, Wi-Fi Aware, UWB (DUT UWB'yi destekliyorsa) ve NFC ana bilgisayar kartı emülasyonu (HCE) uygulamasına sahip ikinci Android cihazı.
  • Erişim noktası adı ve parolasıyla yapılandırılmış bir Wi-Fi yönlendirici. Yönlendiricinin internet bağlantısını kesebilme özelliği olmalı ancak kapatılmamalıdır.

UWB, Wi-Fi NAN ve Bluetooth RSSI için mesafe (yakınlık) ölçüm testleri için gerekli olan tripodları, cihaz tutucularını ve önceden ölçülen mesafeleri de hazırladığınızdan emin olun. Ayrıntılar için bkz. Varlık kalibrasyonu .

NFC testleri için UICC gereksinimleri

CTS Doğrulayıcı aşağıdaki NFC test durumlarına sahiptir:

  • Field-off (0x54'teki işlem verilerini kullanır)
  • Seçimi kaldır (0x52'deki işlem verilerini kullanır)
  • HCI komutu (0025000000) (0x02'deki işlem verilerini kullanır)

İşlem olayı testleri iki cihaz gerektirir; bunlardan birinin aşağıdaki erişim kurallarına sahip SecureElement UICC'ye sahip olması gerekir:

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

Emülatör tarafında, işlem olayının ilgili etkinliği ön plana itmesini bekliyoruz.

Kurmak

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

  1. Ayarları aç.
  2. Sistem > Hareket > Sistemde Gezinme'ye gidin.
  3. Varsa herhangi bir düğme tabanlı gezinme modunu seçin; üç düğmeli mod tercih edilir.

CTS Doğrulayıcı test ortamını ayarlamak için:

  1. Linux bilgisayarda:

    • SDK olmayan arayüzlere erişime izin vermek için CTS Doğrulayıcı'yı kurmadan önce aşağıdaki komutu çalıştırın.

      adb shell settings put global hidden_api_policy 1
      
    • Android Studio'yu yükleyin.

    • Test edilecek Android sürümü için CTS Doğrulayıcı APK'sını indirin.

  2. DUT'u Linux bilgisayarına bağlayın.

  3. Linux bilgisayardaki bir terminalden CtsVerifier.apk DUT'a yükleyin.

    adb install -r -g CtsVerifier.apk
    
  4. Android 10 ve üzeri 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 üzeri sürümlerde, raporların cihazın harici üst düzey dizini altında kendi tanımladığı 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 üzeri sürümlerde, CTS Doğrulayıcı için test API erişimine 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 üzeri 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 tarih ve saatinin doğru ayarlandığından emin olun.

CTS Doğrulayıcıyı Çalıştır

DUT'taki CTS Verifier simgesine dokunarak CTS Verifier uygulamasını başlatın.

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

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

Uygulama, manuel doğrulama için kullanılabilen çeşitli test setlerini görüntüler.

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

Şekil 2. Testlerin CTS Verifier menüsü

Her test ekranın alt kısmında bir dizi ortak öğe içerir.

Akış video kalitesi doğrulayıcı

Şekil 3. Ortak test öğelerinin vurgulandığı test ekranı

  • Başarılı (✓). DUT, Bilgi talimatlarına göre test gereksinimlerini karşılıyorsa 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.
  • Hata (!). DUT, Bilgi talimatlarına göre test gereksinimlerini karşılamıyorsa dokunun.

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

USB aksesuar modunu 8.0 ve üzeri için test edin

CTS Doğrulayıcı usb aksesuar testi

Şekil 4. 8.0 ve üzeri için USB aksesuar test prosedürü

CTS Doğrulayıcı usb aksesuar testi

Şekil 5. 8.0 ve üzeri için USB aksesuar modunun test edilmesi

7.x ve daha düşük sürümler için USB aksesuar modunu test edin

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

  1. DUT'u Linux bilgisayarına bağlayın.
  2. Bilgisayarda, CTS Doğrulayıcı paketindeki cts-usb-accessory programını çalıştırın:

    ./cts-usb-accessory
  3. DUT'ta bir açılır mesajın görünmesini bekleyin, ardından Tamam'ı seçin.
    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 konsoldan gelen çıktıyı inceleyin. Örnek çıktı:

    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
    

Kamera görüş alanını kalibre edin

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. Calibration-pattern.pdf hedef dosyasını 11” x 17” veya A3 boyutunda kağıda yazdırın.
    2. Yazdırılan deseni sert bir arkalık üzerine monte edin.
    3. Kamera cihazını ve yazdırılan hedefi aşağıdaki şemada gösterildiği gibi yönlendirin.
      Kamera baskılı hedef

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

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

    1. Yazdırma hatalarını (~38 cm) hesaba katmak için hedef desen üzerindeki düz çizgiler arasındaki mesafeyi (santimetre cinsinden) ölçün.
    2. Kalibrasyon uygulamasını başlatın.
    3. Kurulum düğmesine basın ve İşaretçi mesafesi öğesini seçin.
    4. Hedef desene olan mesafeyi ölçün ve girin (~100 cm).
    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. Önizleme, görüntüyü üzerine dikey bir çizgi yerleştirilmiş olarak görüntüler; bu çizgi hedef modelin merkez çizgisiyle aynı hizada olmalıdır. Şeffaf ızgara, optik eksenin hedefe dik olmasını sağlamak için 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ı, görüntünün üzerine yerleştirilmiş iki dikey çizgiyle görüntüler.
    2. Doğruluğu belirleyin:
      • Çizgiler hedef desen üzerindeki dikey çizgilerle birkaç santimetre içinde hizalanıyorsa, seçilen çözünürlük için bildirilen görüş alanı doğrudur.
      • Çizgiler hizalanmıyorsa bildirilen görüş alanı hatalıdır. Bunu düzeltmek için ekranın altındaki kaydırıcıyı, kaplama hedef desenle mümkün olduğunca yakın hizalanıncaya kadar ayarlayın. Kaplama ve hedef desen görüntüsü hizalandığında, görüntülenen görüş alanı doğru değere yakın bir yaklaşımdır. Bildirilen görüş alanı kalibrasyon değerinin +/-2 derecesi dahilinde olmalıdır.
    3. Geri düğmesine basın ve DUT tarafından desteklenen tüm görüntü çözünürlükleri için kalibrasyon testini tekrarlayın.

Alternatif modlar için CTS Verifier'ı çalıştırın

CTS 10 R6 ve CTS 11 R2 sürümlerini başlatan 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 katlanmamış 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österecektir. CTS Verifier'da alternatif modları yürütmek için düğme uygun görüntüleme moduna geçirilmeli ve gösterilen test listesi çalıştırılmalıdır.

CTS-V geçiş anahtarı

Katlanmış testlerin sonuçları, katlanmamış testlerle aynı rapora kaydedilecektir. Test setinin ait olduğu her test sonucunu tanımlamak için, katlanmış modun altındaki her test adına bir son ek 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 aktar

Tüm testler tamamlandıktan sonra sonuçları rapor olarak kaydedebilir ve bilgisayarınıza 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 kaydet (disk) simgesine dokunun.

  2. Kaydedilen raporun dosya yolunu görüntüleyen açılır mesajı bekleyin (örneğin, /sdcard/verifierReports/ctsVerifierReport-date-time.zip ), ardından yolu kaydedin.

  3. DUT'u Linux bilgisayarına bağlayın.

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

    • Android 7.x ve üzeri için aşağıdaki komutu kullanarak tüm raporları indirin:

      adb pull /sdcard/verifierReports
      
    • Android 6.0 ve önceki sürümler için aşağıdaki komutu kullanarak tüm raporları indirin:

      adb pull /mnt/sdcard/ctsVerifierReports/
      
    • Android 10 ve üzeri için, Automotive'i ve ikincil kullanıcı olarak çalışan cihazları uygularken aşağıdaki komutu kullanarak en son raporu indirin:

      adb shell content read --user CURRENT_USER --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
      

      Listeden bir rapor indirmek için Satır Kimliğini veya dosya adını belirtebilirsiniz. Örneğin:

      adb shell content read --user CURRENT_USER --uri
      
      content://com.android.cts.verifier.testresultsprovider/reports/0 > report.zip
      
      adb shell content read --user CURRENT_USER --uri
      
      content://com.android.cts.verifier.testresultsprovider/reports/ctsVerifierReport-date-time.zip >
      report.zip
      
  5. Başarılı/başarısız sonuçlarını temizlemek için CTS Doğrulayıcı uygulamasında sonuçları seçin ve Menü > Temizle seçeneğini belirleyin.