CTS Doğrulayıcıyı Kullanma

Android Uyumluluk Test Paketi Doğrulayıcı (CTS Doğrulayıcı), Uyumluluk Test Paketi'ni (CTS) tamamlar. CTS, API'leri ve otomatikleştirilebilen işlevleri kontrol ederken, CTS Verifier, ses kalitesi, dokunmatik ekran, ivmeölçer ve kamera gibi manuel giriş 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 donanıma 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.
  • Bilinen uyumlu bir Bluetooth, Wi-Fi doğrudan ve NFC ana kart öykünmesi (HCE) uygulamasına sahip ikinci Android cihazı.
  • Erişim noktası adı ve parolası ile yapılandırılmış bir Wi-Fi yönlendirici. Yönlendirici internet bağlantısını kesebilme özelliğine sahip olmalı, ancak kapatılmamış olmalıdır.

NFC Testleri için UICC Gereksinimleri

CTS Verifier aşağıdaki NFC test senaryolarına sahiptir:

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

İşlem olayı testleri, biri aşağıdaki erişim kurallarına sahip SecureElement UICC'ye sahip olması gereken iki cihaz gerektirir:

  • CtsVerifier APK karma: 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

Öykünücü tarafında, işlem olayının karşılık gelen etkinliği ön plana çıkarmasını bekliyoruz.

kurulum

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

  1. Ayarları aç.
  2. Sistem > Hareket > Sistem Gezintisi'ne gidin.
  3. Herhangi bir düğme tabanlı gezinme modunu seçin, varsa, tercih edilen üç düğmeli mod.

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

  1. Linux bilgisayarda:

    • SDK olmayan arabirimlere erişime izin vermek için CTS Verifier'ı yüklemeden önce aşağıdaki komutu çalıştırın.

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

    • Test etmek için Android sürümü için CTS Verifier APK'sini indirin.

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

  3. Linux bilgisayardaki bir terminalden, CtsVerifier.apk 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ında kendinden 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. DUT'nin sistem verilerinin ve saatin doğru şekilde ayarlandığından emin olun.

Koşma

DUT üzerindeki CTS Verifier simgesine dokunarak CTS Verifier uygulamasını başlatın.

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

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

Uygulama, manuel doğrulama için kullanılabilen birkaç test seti görüntüler.

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

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

Her test, ekranın altında bir dizi ortak öğe (Bilgi, Başarılı, Başarısız) içerir.

Akış video kalitesi doğrulayıcı

Şekil 3. Test elemanları

  • Bilgi (?). Test talimatlarını görüntülemek için dokunun. Ayrıca bir test ilk açıldığında otomatik olarak görünür.
  • Geç (✓). DUT, Bilgi talimatlarına göre test gereksinimlerini karşılıyorsa öğesine dokunun.
  • Başarısız (!). DUT, Bilgi talimatlarına göre test gereksinimlerini karşılamıyorsa öğesine 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.

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

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 modunu test etme

7.x ve altı için USB aksesuar modunu test etme

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

  1. DUT'yi Linux bilgisayara bağlayın.
  2. Bilgisayarda, CTS Verifier paketinden 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 üzerindeki CTS Verifier uygulamasındaki USB Aksesuar Testine gidin.

  5. Bilgisayarda, konsoldan çıktıyı gözden geçirin. Ö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 etme

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

  1. Test ortamını kurun:

    1. Calibration-pattern.pdf hedef dosyasını 11” x 17” veya A3 boyutlu kağıda yazdırın.
    2. Basılı deseni sert bir destek üzerine monte edin.
    3. Kamera cihazını ve yazdırılan hedefi aşağıda gösterildiği gibi yönlendirin.
      Kamera baskılı hedef

      Şekil 7. Kamera ile yazdırılan hedef

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

    1. Yazdırma hatalarını (~38 cm) hesaba katmak için hedef desendeki 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 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 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 yerleştirilmiş dikey bir çizgiyle görüntüler; bu çizgi, hedef desenin merkez çizgisiyle hizalanmalıdır. Saydam ı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 bindirilmiş iki dikey çizgi ile görüntüler.
    2. Doğruluğu belirleyin:
      • Çizgiler, hedef desendeki dikey çizgilerle birkaç santimetre içinde hizalanırsa, seçilen çözünürlük için rapor edilen görüş alanı doğrudur.
      • Çizgiler hizalanmazsa, bildirilen görüş alanı hatalıdır. Bunu düzeltmek için, kaplama hedef desenle mümkün olduğunca yakın hizalanana kadar ekranın altındaki kaydırıcıyı ayarlayın. Bindirme ve hedef desen görüntüsü hizalandığında, görüntülenen görüş alanı doğru değere yakın bir değerdir. Raporlanan görüş alanı, kalibrasyon değerinin +/-2 derecesi içinde 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ırma

CTS 10 R6 ve CTS 11 R2 sürümlerinden başlayarak, 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 en üstünde, kullanıcıların katlanmış ve katlanmış görüntüleme modu arasında geçiş yapmasını sağlayan bir düğme gösterilir. CTS Verifier, seçilen görüntüleme 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 testler listesi çalıştırılmalıdır.

CTS-V geçiş anahtarı

Katlanmış testlerin sonuçları, katlanmamış testlerle aynı rapora kaydedilecektir. Test setinin geldiği her test sonucunu belirlemek için, katlanmış modda 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 aktarma

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

  1. Kaydet (disk) simgesine dokunun.
    CTS Doğrulayıcı Kaydet simgesi

    Şekil 8. CTS Doğrulayıcı Kaydet simgesi

  2. Açılır mesajın kaydedilen raporun yolunu görüntülemesini bekleyin (örneğin, /sdcard/verifierReports/ctsVerifierReport-date-time.zip ), ardından yolu kaydedin.
    Kaydedilmiş rapora giden CTS Doğrulayıcı yolu

    Şekil 9. Kaydedilmiş rapora giden CTS Doğrulayıcı yolu

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

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

    • Android 7.x ve sonraki sürümleri için, aşağıdakileri kullanarak tüm raporları indirin:

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

      adb pull /mnt/sdcard/ctsVerifierReports/
      
    • Android 10 ve sonraki sürümler için, Otomotiv ve ikincil kullanıcı olarak çalışan cihazları uygulayarak, aşağıdakileri 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. Geçti/kaldı sonuçlarını temizlemek için, CTS Verifier uygulamasında sonuçları seçin ve Menü > Temizle öğesini seçin.