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ş 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 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.
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:
- Ayarları aç.
- Sistem > Hareket > Sistemde Gezinme'ye gidin.
- 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:
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.
DUT'u Linux bilgisayarına bağlayın.
Linux bilgisayardaki bir terminalden DUT'a
CtsVerifier.apk
dosyasını yükleyin.adb install -r -g CtsVerifier.apk
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
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
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
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.
Şekil 1. CTS Doğrulayıcı simgesi
Uygulama, manuel doğrulama için kullanılabilen çeşitli test setlerini görüntüler.
Şekil 2. Testlerin CTS Verifier menüsü
Her test ekranın alt kısmında bir dizi ortak öğe içerir.
Ş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.
- 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ılı olarak açıklandığı gibi ek test kurulumu ve talimatlar gerektirir.
USB aksesuar modunu 8.0 ve üzeri için test edin
Şekil 4. 8.0 ve üzeri için USB aksesuar test prosedürü
Ş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.
- DUT'u Linux bilgisayarına bağlayın.
Bilgisayarda, CTS Doğrulayıcı paketindeki
cts-usb-accessory
programını çalıştırın:./cts-usb-accessory
DUT'ta bir açılır mesajın görünmesini bekleyin, ardından Tamam'ı seçin.
Şekil 6. USB aksesuar testi
DUT'taki CTS Doğrulayıcı uygulamasında USB Aksesuar Testi'ne gidin.
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.
Test ortamını ayarlayın:
- Calibration-pattern.pdf hedef dosyasını 11” x 17” veya A3 boyutunda kağıda yazdırın.
- Yazdırılan deseni sert bir arkalık üzerine monte edin.
Kamera cihazını ve yazdırılan hedefi aşağıdaki şemada gösterildiği gibi yönlendirin.
Şekil 7. Kameranın yazdırdığı hedef
Hedef genişliğini ayarlayın:
- Yazdırma hatalarını (~38 cm) hesaba katmak için hedef desen üzerindeki düz çizgiler arasındaki mesafeyi (santimetre cinsinden) ölçün.
- Kalibrasyon uygulamasını başlatın.
- Kurulum düğmesine basın ve İşaretçi mesafesi öğesini 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ğ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.
Kalibrasyon testini çalıştırın:
- 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.
- 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.
- 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.
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.
Test sonuçlarınızı kaydetmek için test kategorileri listesinin üst kısmındaki kaydet (disk) simgesine dokunun.
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.DUT'u Linux bilgisayarına bağlayın.
Linux bilgisayardaki Android SDK kurulumundan,
adb shell content read
veyaadb 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
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.