CTS Doğrulayıcı'yı kullanma

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

Şartlar

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

• CTS'den 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ı olan Linux bilgisayar. DUT'ya yapılan tüm bağlantılar bu bağlantı noktasından geçer.
• Bilinen uyumlu Bluetooth, Wi-Fi Direct, Wi-Fi Aware, UWB (DUT UWB'yi destekliyorsa) ve NFC ana kart emülasyonu (HCE) uygulamasına sahip ikinci Android cihaz.
• Erişim noktası adı ve şifresiyle yapılandırılmış bir kablosuz yönlendirici. Yönlendiricinin internet bağlantısını kesebilme özelliği olmalıdır, ancak bağlantı kapalı olmamalıdır.

Ultra geniş bant, kablosuz NAN ve Bluetooth RSSI için mesafe (yakınlık) ölçüm testleri için gereken tripodları, cihaz tutucuları ve önceden ölçülmüş mesafeleri de hazırladığınızdan emin olun. Ayrıntılar için Bulunma kalibrasyonunu inceleyin.

NFC testleri için UICC gereksinimleri

CTS Doğrulayıcı'da aşağıdaki NFC test durumları vardır:

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

İşlem etkinliği testleri için iki cihaz gerekir. Bunlardan birinde aşağıdaki erişim kurallarına sahip SecureElement UICC bulunmalı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ğine erişim için yetkili uygulama tanımlayıcısı (AID): 0xA000000476416E64726F696443545341

Emülatör tarafında, işlem etkinliğinin ilgili etkinliği öne plana itmesini bekleriz.

Kurulum

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

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

Not: Sistem gezinme modunu değiştirmek, Android 10 çalıştıran Pixel 4 cihazlarda bir iş akışı seçeneğidir. Diğer Android cihazlarda veya OS sürümlerinde değişiklik gösterebilir.

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

1. Linux bilgisayarda:

   • SDK dışı arayüzlere 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 yükleyin.

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

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

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

   adb install -r -g CtsVerifier.apk
   

4. Android 10 ve sonraki sürümlerde, uygulamanın raporu oluşturmasına izin 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 dizininin altındaki kendi tanımlanmış 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 Doğrulayıcı için test API'sine erişim izni 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 tarihinin ve saatinin doğru ayarlandığından emin olun.

Not: Daha fazla bilgi için Hazır Uygulamalar için CTS Doğrulayıcı'ya bakın.

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

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

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

Uygulama, manuel doğrulama için kullanılabilen çeşitli test gruplarını gösterir.

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

Her testin ekranın alt kısmında ortak öğeler bulunur.

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

• Geçti (✓). DUT'nin Bilgi talimatlarına göre test şartlarını karşılayıp karşılamadığını kontrol edin.
• 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 şartlarını karşılamıyorsa dokunun.

Not: Bazı testlerde başarılı/başarısız sonuç otomatik olarak belirlenir.

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

8.0 ve sonraki sürümler için USB aksesuar modunu test edin

Şekil 4. 8.0 ve üzeri için USB aksesuarı test işlemi

Şekil 5. 8.0 ve sonraki sürümler için USB aksesuar modunu test etme

7.x ve önceki sürümler için USB aksesuar modunu test etme

USB Aksesuar testi, USB masaüstü makine (ana makine) 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 üzerinde pop-up mesajının görünmesini bekleyin, ardından Tamam'ı seçin.
   

   Şekil 6. USB aksesuarı testi

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

5. Bilgisayarda, konsoldan gelen çı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
   

Kamera 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. calibration-pattern.pdf hedef dosyasını 11 inç x 17 inç veya A3 boyutunda kağıda yazdırın.
   2. Basılı deseni sert bir arka plana yapıştırın.

   3. Kamera cihazını ve basılı hedefi aşağıdaki şemada gösterildiği gibi yönlendirin.
      

      7.Şekil Kamerayla basılan hedef

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

   1. Baskı hatalarını hesaba katmak için hedef desendeki katı ç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 kalıba 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ğinden ve kurulum iletişim kutusuna doğru mesafelerin girildiğinden emin olun. Önizlemede, üzerine dikey bir çizgi yerleştirilmiş resim gösterilir. Bu çizgi, hedef kalıbın orta çizgisiyle hizalanmalıdır. Şeffaf ızgara, optik eksenin hedefe dikey olmasını sağlamak için diğer dikey çizgilerle birlikte kullanılabilir.

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

   1. Resim çözünürlüğünü seçin (sol alt kısımdaki seçiciyi kullanarak) ve 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österir.
   2. Doğruluğu belirleme:
      • Ç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.
      • Çizgiler hizalanmıyorsa bildirilen görüş alanı yanlıştır. Bunu düzeltmek için ekranın alt kısmındaki kaydırma çubuğunu, yer paylaşımı hedef kalıpla mümkün olduğunca yakın bir şekilde hizalanana kadar ayarlayın. Yer paylaşımı ve hedef desen resmi hizalandığında, görüntülenen görüş alanı doğru değere yakın bir yaklaşık değerdir. Bildirilen görüş alanı, kalibrasyon değerinden +/-2 derece 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ırma

CTS 10 R6 ve CTS 11 R2 sürümlerinden itibaren CTS Doğrulayıcı, alternatif modları veya birden fazla ekran modu olan cihazlar için gereken testleri destekler.

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

Katlanmış testlerin sonuçları, katlanmamış testlerle aynı rapora kaydedilir. Test grubunun ait olduğu her bir test sonucunu tanımlamak için katlanmış modun altındaki 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 kaydedip bir bilgisayara indirebilirsiniz. Rapor adlarına, DUT sistem saatine göre otomatik olarak zaman damgası eklenir.

Not: Test yürütme metrikleri (yürütme süresi ve otomasyon algılama), kayıtlı rapordan toplanır ve yalnızca test paketi iyileştirmeleri amacıyla kullanılır.

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

   Not: Android 7.0 ve sonraki sürümlerde önizleme özelliği yoktur.

2. Kaydedilen raporun dosya yolunu (örneğin, /sdcard/verifierReports/ctsVerifierReport-date-time.zip) gösteren bir pop-up mesajı bekleyin ve 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ümler için aşağıdaki komutu kullanarak tüm raporları indirin:

     adb pull /sdcard/verifierReports
     

   • Android 6.0 ve önceki sürümlerde, tüm raporları indirmek için aşağıdaki komutu kullanın:

     adb pull /mnt/sdcard/ctsVerifierReports/
     

   • Android 10 ve sonraki sürümlerde Automotive'i uygularken ve ikincil kullanıcı olarak çalışan cihazlarda 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
     

     Not: CURRENT_USER kimliğini almak için adb shell am get-current-user'i kullanın.

     Bağlı cihazda kullanılabilen 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. Örnek:

     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/Geçmedi sonuçlarını silmek için CTS Doğrulayıcı uygulamasında sonuçları seçin ve Menü > Sil'i seçin.