CTS Doğrulayıcıyı Kullanma

Android Uyumluluk Test Paketi Doğrulayıcısı (CTS Doğrulayıcı), Uyumluluk Test Paketi'ni (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ş 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 ekipmana 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 ve NFC ana kart emülasyonu (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ı kesme yeteneğine sahip olmalı, ancak kapalı olmamalıdır.

NFC Testleri için UICC Gereksinimleri

CTS Doğrulayıcı aşağıdaki NFC test senaryoları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, biri aşağıdaki erişim kurallarına sahip SecureElement UICC'ye sahip olması gereken iki cihaz gerektirir:

  • 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

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

Kurmak

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

  1. Ayarları aç.
  2. System > Gesture > System Navigation seçeneğine gidin.
  3. Herhangi bir düğme tabanlı gezinme modunu seçin, varsa üç düğme modu tercih edilir.

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

  1. Linux bilgisayarda:

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

      adb shell settings put global hidden_api_policy 1
      
    • Android Studio'yu kurun.

    • 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 yükleyin.

    adb install -r -g CtsVerifier.apk
    
  4. Android 10 ve sonraki sürümlerde, uygulamaya raporu 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ı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
    

    Oluşturulan bir iş profiline doğru izni vermek için --user profileID işaretini aşağıdaki gibi ekleyin:

    adb shell appops set --user profileID 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. DUT'ta sistem verilerinin ve saatin doğru ayarlandığından emin olun.

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

DUT'taki CTS Doğrulayıcı simgesine dokunarak CTS Doğrulayıcı 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 mevcut birkaç test setini görüntüler.

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

Şekil 2. Testlerin CTS Verifier menüsü

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

Akışlı video kalitesi doğrulayıcı

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

  • Geç (✓). 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 açıldığında otomatik olarak görünür.
  • Başarısız (!). 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ıları verilen ek test kurulumu ve talimatları gerektirir.

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

CTS Verifier usb aksesuar testi

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

CTS Verifier usb aksesuar testi

Şekil 5. USB aksesuar modunu 8.0 ve üzeri için test etme

7.x ve altı 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 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 Verifier usb aksesuar testi

    Şekil 6. USB aksesuar testi

  4. DUT'taki CTS Verifier uygulamasında USB Aksesuar Testine 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 et

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ı kurun:

    1. Calibration-pattern.pdf hedef dosyasını 11” x 17” veya A3 boyutlu kağıda yazdırın.
    2. Yazdırılan deseni sert bir destek ü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. Kamera tarafından yazdırılan hedef

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

    1. Baskı hatalarını (~38 cm) hesaba katmak için hedef desendeki düz çizgiler arasındaki mesafeyi (santimetre olarak) ölçün.
    2. Kalibrasyon uygulamasını başlatın.
    3. Ayar düğmesine basın ve İşaretçi mesafesi öğesini seçin.
    4. Hedef desene olan mesafeyi ölçün ve girin (~100 cm).
    5. Kalibrasyon ön izlemesine 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 bindirilmiş olarak görüntüler; bu çizgi, hedef modelin merkez çizgisiyle hizalanmalı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 bindirilmiş iki dikey çizgiyle görüntüler.
    2. Doğruluğu belirleyin:
      • Çizgiler, hedef modeldeki dikey çizgilerle birkaç santimetre içinde hizalanırsa, seçilen çözünürlük için bildirilen görüş alanı doğrudur.
      • Çizgiler hizalanmazsa, bildirilen görüş alanı yanlıştır. Bunu düzeltmek için, kaplama hedef desenle mümkün olduğu kadar yakın hizalanana kadar ekranın altındaki kaydırıcıyı ayarlayın. Bindirme ve hedef model görüntüsü hizalandığında, görüntülenen görüş alanı doğru değere yakındır. Bildirilen 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 Doğrulayıcıyı Çalıştırın

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 üst kısmında, kullanıcıların katlanmamış 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ı çalıştırmak için düğme uygun görüntüleme moduna geçirilmeli ve gösterilen testlerin 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 tanımlamak için, katlanmış mod altında 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 aktar

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

  1. Test sonuçlarınızı kaydetmek için, test kategorileri listesinin en üstündeki kaydet (disk) simgesine dokunun.

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

  3. DUT'u Linux bilgisayara 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 üstü için, aşağıdaki komutu kullanarak tüm raporları indirin:

      adb pull /sdcard/verifierReports
      
    • Android 6.0 ve altı için, aşağıdaki komutu kullanarak tüm raporları indirin:

      adb pull /mnt/sdcard/ctsVerifierReports/
      
    • Android 10 ve üstü için, Otomotiv 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 Verifier uygulamasında sonuçları seçin ve Menü > Temizle öğesini seçin.