Android Uyumluluk Test Paketi Doğrulayıcı (CTS Doğrulayıcı), Uyumluluk Test Paketi (CTS) ile uyumludur. CTS, yayınlanabilecek API'leri ve işlevleri CTS Doğrulayıcı tarafından sağlanamayacak API'ler ve işlevler için manuel giriş veya konumlandırma olmadan (ör. ses sistemi) sabit bir cihazda test edilir kalite, dokunmatik ekran, ivme ölçer ve kamera.
Gereksinimler
CTS Doğrulayıcı'yı çalıştırmadan önce aşağıdaki ekipmanlara sahip olduğunuzdan emin olun:
- Android API uyumluluğunu başarıyla doğrulamış olan Android cihaz çok önemli. Bu, test edilen cihazdır (DUT).
- USB 2.0 uyumlu bağlantı noktasına sahip Linux bilgisayar. DUT'ye tüm bağlantılar gider yapabilirsiniz.
- Uyumlu bir Bluetooth, doğrudan kablosuz ve kablosuz ağa sahip ikinci Android cihaz Duyarlı, ultra geniş bant (DUT, ultra geniş bant destekliyorsa) ve NFC ana makine kartı emülasyonu (HCE) hakkında bilgi edindiniz.
- Erişim noktası adı ve şifresiyle yapılandırılmış bir kablosuz yönlendirici. Yönlendirici internet bağlantısı kesilebilir, ancak kapalı.
Tripodları, cihaz tutucuları ve önceden ölçülmüş ölçümleri de ultra geniş bant testlerinde mesafe (yakınlık) ölçümü için gereken mesafeler, Kablosuz NAN ve Bluetooth RSSI. Ayrıntılar için bkz. Bulunma kalibrasyonu.
NFC testleri için UICC gereksinimleri
CTS Doğrulayıcı'da aşağıdaki NFC test durumları mevcuttur:
- Alan-kapalı (0x54 işlem verilerini kullanır)
- Seçimi kaldır (0x52 işlem verilerini kullanır)
- HCI komutu (0025000000) (0x02 sürümünden alınan işlem verilerini kullanır)
İşlem etkinliği testleri için iki cihaz gerekir ve bunlardan birinde SecureElement UICC'de ise aşağıdaki erişim kuralları mevcuttur:
- CtsVerifier APK hash değeri: 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 karşılık gelen bu etkinliği ön plana alabiliyorsunuz.
Kurulum
Test cihazının sistem gezinme modunu üç düğmeli olarak değiştirin: şöyle olur:
- Ayarlar'ı açın.
- Sistem > Hareket > Sistemde Gezinme.
- Herhangi bir düğme tabanlı gezinme modunu (üç düğme modu tercih edilirse) seçin kullanılabilir.
CTS Doğrulayıcı test ortamını ayarlamak için:
Linux bilgisayarda:
CTS Doğrulayıcı'yı yüklemeden önce aşağıdaki komutu çalıştırarak SDK dışı arayüzlere erişebilir.
adb shell settings put global hidden_api_policy 1
Android Studio'yu yükleyin.
Şu uygulama için CTS Doğrulayıcı APK'sını indirin: sürümünü kullandığınızdan emin olun.
DUT'yi Linux bilgisayara bağlayın.
Linux bilgisayarın bir terminalinden DUT öğesine
CtsVerifier.apk
dosyasını yükleyin.adb install -r -g CtsVerifier.apk
Android 10 ve sonraki sürümlerde aşağıdaki komutu çalıştırın: komutuna ekleyerek uygulamaya rapor oluşturma izni verebilirsiniz.
adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
Android 11 ve sonraki sürümlerde aşağıdaki komutu çalıştırın: komutuna ekleyerek raporların, cihazındaki harici üst düzey dizini.
adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
Android 13 ve sonraki sürümlerde aşağıdaki komutu çalıştırın: komutunu kullanın.
adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
Android 14 ve sonraki sürümlerde aşağıdaki komutu çalıştırın: komutuna basarak uygulamaya ekranı açma izni verebilirsiniz.
adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0
DUT'de sistem tarihi ve saatinin doğru şekilde ayarlandığından emin olun.
CTS Doğrulayıcıyı Çalıştır
DUT üzerindeki CTS Doğrulayıcı simgesine dokunarak CTS Doğrulayıcı uygulamasını başlatın.
Şekil 1. CTS Doğrulayıcı simgesi
Uygulamada, manuel doğrulama için kullanılabilen çeşitli test kümeleri görüntülenir.
Şekil 2. Testlerin CTS Doğrulayıcı menüsü
Her test, ekranın alt kısmında bir dizi ortak öğe içerir.
Şekil 3. Ortak test öğelerinin vurgulandığı test ekranı
- Onaylı (✓). DUT numarası, bilgilerdeki test şartlarını karşılıyorsa dokunun bakın.
- Bilgi (?). Test talimatlarını görüntülemek için dokunun. Otomatik olarak da görünür Google'a otomatik olarak gönderilir.
- Başarısız (!). DUT, bilgilerdeki test şartlarını karşılamıyorsa dokunun bakın.
USB aksesuarı modu ve kamera kalibrasyon testi gibi bazı testler ve talimatları aşağıda bulabilirsiniz.
8.0 ve sonraki sürümler için USB aksesuar modunu test edin
4.Şekil 8.0 ve 8.0 için USB aksesuarı test uygulaması üzerinde
5. Şekil. USB aksesuarı modu 8.0 ve 8.0 için test ediliyor üzerinde
7.x ve önceki sürümler için USB aksesuar modunu test edin
USB Aksesuar testi için USB masaüstü makinesinin çalıştırılması için bir Linux bilgisayar gerekir. (ana makine) programı.
- DUT'yi Linux bilgisayara bağlayın.
Bilgisayarda, CTS'den
cts-usb-accessory
programını yürütün Doğrulayıcı paketi:./cts-usb-accessory
DUT'de pop-up mesajının görünmesini bekleyin, ardından Tamam'ı seçin.
6. Şekil. USB aksesuar testi
DUT'deki CTS Doğrulayıcı uygulamasındaki USB Aksesuar Testi'ne gidin.
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 et
Cihazı hızlı bir şekilde belirlemek için görüş alanı kalibrasyon prosedürünü kullanma orta düzey doğrulukta.
Test ortamını ayarlayın:
- Şunu yazdır: calibration-pattern.pdf hedefi dosyası olarak kaydedin.
- Yazdırılan deseni sabit bir arka plana monte edin.
Kamera cihazını ve yazdırılan hedefi aşağıda gösterildiği gibi yönlendirin diyagramı tıklayın.
7.Şekil Kamera yazdırılan hedef
Hedef genişliği ayarlayın:
- Resmin üzerindeki düz çizgiler arasındaki mesafeyi (santimetre cinsinden) hedef deseni belirleyin (yaklaşık 38 cm).
- Kalibrasyon uygulamasını başlatın.
- Kurulum düğmesine basın ve İşaretçi mesafesi'ni seçin.
- Hedef desene olan mesafeyi ölçün ve girin (~100 cm).
- Kalibrasyon önizlemesine dönmek için geri düğmesine basın.
Cihazın ve hedefin şekilde gösterildiği gibi yerleştirildiğinden ve kurulum iletişim kutusuna doğru mesafeler girildiğinden emin olun. Önizleme resmi üzerine yerleştirilmiş dikey bir çizgiyle görüntüler; bu satır hedef kalıbın orta çizgisiyle aynı hizaya getirin. Şeffaf ızgara optik eksenin iyi performans göstermesini sağlamak için diğer dikey çizgilerle hedefe göre dik olmalıdır.
Kalibrasyon testini çalıştırın:
- Resim çözünürlüğünü seçin (sol alt kısımdaki seçiciyi kullanarak) ve ekrana dokunun. Test, kalibrasyon moduna girer ve fotoğrafı, resmin üzerine yerleştirilmiş iki dikey çizgiyle görüntüler.
- Doğruluğu belirleyin:
- Çizgiler hedef desendeki dikey çizgilerle hizalanıyorsa birkaç santimetre içinde kalan alan için bildirilen görüş alanı doğru olduğundan emin olun.
- Çizgiler uyuşmuyorsa bildirilen görüş alanı yanlıştır. Bunu düzeltmek için ekranın altındaki kaydırma çubuğunu hedef kalıpla mümkün olduğunca uyumlu olduğundan emin olun. Bindirme ve hedef desen resmi hizalandığında, görüntüleme alanı, doğru konuma değer. Bildirilen görüş alanı +/-2 derece içinde olmalıdır kalibrasyon değerini seçin.
- Geri düğmesine basıp tüm görüntü için kalibrasyon testini tekrarlayın DUT tarafından desteklenen çözünürlüktür.
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ı, gerekli testleri destekler. veya birden fazla ekran modu olan cihazlar için uygulamanızı öneririz.
CTS Doğrulayıcı'da ana liste görünümünün üst kısmında, kullanıcıların açılmış ekran modu arasında geçiş yapmasını sağlar. CTS Doğrulayıcı, seçilen görüntü modu için gerekli testleri içerir. Alternatif CTS Doğrulayıcı'da başka modlar varsa düğme uygun ekrana geçirilmelidir test edin ve gösterilen testlerin listesini çalıştırın.
Katlanmış testlerin sonuçları, açılmış durumdaki aynı rapora kaydedilir testler. Test veri kümesinin ait olduğu her bir test sonucunu tanımlamak için katlanmış mod altındaki her test adına 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 kaydedip indirebilirsiniz nasıl aktarabileceğinizi göstereceğim. Rapor adlarına DUT'ye göre otomatik olarak zaman damgası eklenir sistem saati.
Test sonuçlarınızı kaydetmek için listenin üst kısmındaki kaydet (disk) simgesine dokunun test kategorilerinden biridir.
Kaydedilen raporun dosya yolunu gösteren bir pop-up mesajı bekleyin ( örneğin,
/sdcard/verifierReports/ctsVerifierReport-date-time.zip
), ardından yolu kaydedin.DUT'yi Linux bilgisayara bağlayın.
Linux bilgisayardaki Android SDK yüklemesinden raporları indirin.
adb shell content read
veyaadb pull CTSVerifierReportPath
kullanarak bağlı cihazdan.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ümler için aşağıdaki komutu kullanarak tüm raporları indirin:
adb pull /mnt/sdcard/ctsVerifierReports/
Android 10 ve sonraki sürümlerde Otomotiv ve ikincil kullanıcı, indirme kullanarak en son raporu çıkarabilirsiniz:
adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports/latest > report.zip
.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ı. Ö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
Başarılı/başarısız sonuçlarını temizlemek için CTS Doğrulayıcı uygulamasındaki sonuçları seçin ve Menü > Temizle.