Otomatik CTS testlerini çalıştırmadan önce fiziksel ortamınızı hazırlayın, iş istasyonunuzu kurun ve test ettiğiniz cihazı yapılandırın.
Fiziksel ortamı ayarlama
Belirli CTS testleri için DUT'un yakınına harici cihazlar kurulması gerekir. Fiziksel ortamınızı ayarlamak için:
DUT'nuz Bluetooth LE'yi destekliyorsa Bluetooth LE tarama testi için DUT'tan 5 metre uzaklığa en az üç Bluetooth LE işaretçisi yerleştirin. Ayrıca:
- Beacon'ların yapılandırılması veya belirli bir şey yayması gerekmez.
- Beacon'lar iBeacon, Eddystone veya BLE beacon'ları simüle eden cihazlar da dahil olmak üzere her türden olabilir.
DUT'u, duvar veya tavan gibi bir sahnenin önüne, DUT'un minimum odak mesafesine eşit bir mesafede yerleştirin. Ayrıca:
- Sahne, test edilen sensörlerin
CONTROL_AE_TARGET_FPS_RANGEbölümünde belirtildiği gibi saniyedeki maksimum yapılandırılmış hedef kare sayısına (FPS) ulaşmasına ve bu sayıda kalmasına olanak tanıyacak kadar aydınlık olmalıdır. - Bu kurulum, listelenen cihazlar üzerinde test tekrarlanıp performans tek tek ölçülürken
getCameraIdListtarafından bildirilen tüm kamera sensörleri için geçerlidir. - DUT, USB web kameraları gibi harici kameraları destekliyorsa CTS'yi çalıştırırken harici bir kamera takın. Aksi takdirde CTS testleri başarısız olur.
- Sahne, test edilen sensörlerin
DUT'nuz küresel konumlandırma sistemini (GPS) veya başka bir küresel navigasyon uydu sistemini (GNSS) destekliyorsa DUT'a alım ve konum hesaplaması için uygun bir sinyal seviyesinde GNSS sinyali sağlayın. Ayrıca:
- GPS, ICD-GPS-200C ile uyumlu olmalıdır.
- GNSS sinyali, uydu simülatörü veya dış mekan sinyallerinin tekrarlayıcısı da dahil olmak üzere herhangi bir türde olabilir.
- DUT'u, uydudan yeterli GNSS sinyalini doğrudan alabilmesi için pencerenin yakınına yerleştirebilirsiniz.
Kablosuz ağınızın IPv4 ve IPv6'yı desteklediğini, IPv4 ve IPv6 için DNS'li bir internet bağlantısı olduğunu, IP çoklu yayını desteklediğini ve test cihazını izole edilmiş bir istemci olarak değerlendirebildiğini doğrulayın.
Yerel bir IPv6 ağına, IPv6 operatör ağına veya IPv6 testlerini geçmek için bir VPN'ye erişiminiz yoksa kablosuz ağ erişim noktası ve IPv6 tüneli kullanın.
DUT'ta kablosuz arayüzünde
UP,BROADCASTveMULTICASTişaretlerinin ayarlandığını doğrulayın.Kablosuz arayüzüne IPv4 ve IPv6 adreslerinin atanmış olduğunu doğrulayın. Kablosuz arayüz özelliklerini kontrol etmek için
adb shell ifconfigkomutunu çalıştırın.DUT'niz Wi-Fi STA veya STA eşzamanlılığını destekliyorsa en az iki kablosuz ağ kurun. Bu kablosuz ağlar, farklı bantlarda farklı SSID'lerle veya aynı SSID'de farklı BSSID'lerle çalışmalıdır.
DUT'nız Kablosuz gidiş dönüş süresini (RTT) destekliyorsa Wi-Fi RTT'yi destekleyen bir cihaz kurun:
- Kablosuz RTT cihazını, test edilen cihazın 12 metre yakınına yerleştirin.
- Kablosuz RTT cihazını açın.
Kablosuz RTT'yi destekleyen iki cihaz önerilir: - Google Wifi - Compulab'ın fitlet2 erişim noktası (5 GHz'de 40 MHz bant genişliğine ayarlanmış).
Masaüstü makinenizi kurma
CTS otomatik testlerini çalıştırmadan önce masaüstü makinenizin donanım ve işletim sistemi gereksinimlerini karşıladığını ve aşağıdaki bölümlerde açıklandığı gibi uygun yazılımın yüklendiğini doğrulayın.
Meet Donanım gereksinimleri
CTS masaüstü makineniz şu donanım gereksinimlerini karşılamalı veya aşmalıdır:
64 bit x86 sistemi
CTS test senaryolarının sayısındaki artışı ve Tradefed'deki Java yığın alanı rezervasyonundaki artışı karşılamak için en az 256 GB boş disk alanı
En az 32 GB RAM
İşletim sistemi gereksinimlerini karşılayın
Geliştirme makinenizde GNU C Library (glibc) 2.17 veya sonraki bir sürümün yüklü olduğu 64 bit Linux dağıtımı çalıştırılmalıdır.
CTS'nin yolu doğru şekilde çözebilmesi için İşletim Sistemi dili "İngilizce" olarak ayarlanmalıdır.
Masaüstü yazılımını yükleme
CTS için uygun masaüstü yazılımını yüklemek üzere:
Android Debug Bridge (adb) ve Android Öğe Paketleme Aracı (AAPT2)'nin en son sürümlerini yükleyin ve bu araçların konumunu makinenizin sistem yoluna ekleyin:
sdkmanagerkomut satırı aracını yüklemek için SDK Manager dokümanının başındaki talimatları uygulayın. Komut satırı araçlarını indirme bağlantısı, Android Studio indirme sayfasının en altındaki Yalnızca komut satırı araçları bölümünde yer alır.- Sistem yolunuzu, yeni yüklenen
sdkmanagerkonumunu içerecek şekilde güncelleyin. sdkmanagerkullanarak en sonplatform-toolsvebuild-toolspaketlerini yükleyin. Bu paketler adb ve AAPT2'yi içerir. Paketleri yükleme hakkında bilgi edinmek için Paketleri yükleme başlıklı makaleye göz atın.- Yeni yüklenen adb ve AAPT2 araçlarının konumunu içerecek şekilde yolunuzu güncelleyin.
- adb ve AAPT2'nin yolunuzda olduğunu doğrulayın.
Java Development Kit (JDK)'nin uygun sürümünü yükleyin:
- Android 11 veya sonraki sürümler için JDK 11'i yükleyin.
- Android 10 veya önceki sürümler için CTS'yi ayarlama (AOSP 10 veya önceki sürümler) başlıklı makaleyi inceleyin.
Android 13 ve 14 için virtualenv'i yükleyin. Çok cihazlı testler için virtualenv aracı gereklidir.
Python'un yüklendiğini doğrulamak için
python3yazın. Python'un düzgün şekilde yüklendiğini belirten Python sürümü ve tarihi görünmelidir.Cihazlarınızın Android sürümüyle ve cihazlarınızın desteklediği tüm uygulama ikili arayüzleriyle (ABI'ler) eşleşen CTS paketlerini Compatibility Test Suite indirmeleri sayfasından indirip açın.
CTS medya dosyalarının son sürümünü indirip açın. Medya dosyaları, Blender Foundation'ın Creative Commons Attribution 3.0 lisansı kapsamında telif hakkı sahibi olduğu Big Buck Bunny'den alınan video klipler içerir.
(İsteğe bağlı) CTS'yi ilk kez çalıştırdığınızda, Mainline ile ilgili bazı CTS dosyaları dinamik olarak indirilir. Ağ hızınıza bağlı olarak bu indirme, CTS çalışma süresine 10 dakika veya daha fazla süre ekler.
CTS'nin ek çalışma süresini önlemek için CTS'yi çalıştırmadan önce Mainline ile ilgili CTS dosyalarını indirebilirsiniz. Mainline ile ilgili CTS dosyalarını indirme hakkında bilgi edinmek için Mainline ile ilgili CTS dosyalarını indirme başlıklı makaleyi inceleyin.
DUT'u hazırlama
Masaüstü makinenizi kurduktan sonra DUT'u kurup yapılandırmanız gerekir.
Test edilecek cihazı kurma
DUT'u ayarlamak için:
DUT'un, Codenames, Tags, and Build Numbers (Kod Adları, Etiketler ve Derleme Numaraları) bölümünde uyumlu olduğu bilinen kullanıcı derlemesine (Android 4.0 veya sonraki sürümler) dayalı bir sistem görüntüsü çalıştırdığını ve
userderleme değişkenini kullandığını doğrulayın. Derleme varyantları hakkında daha fazla bilgi için Hedef seçme başlıklı makaleyi inceleyin.DUT'ta Android 13 veya sonraki bir sürüm çalışıyorsa derlemenin, cihazın ticari olarak piyasaya sürüldüğü API düzeyine ayarlanmış
ro.product.first_api_leveliçerdiğini doğrulayın. Bu değeri ayarlamak içindevice.mkdosyasında aşağıdaki değişikliği yapın:PRODUCT_SHIPPING_API_LEVEL := 21Belirli CTS şartları, cihazın ilk gönderildiği derlemeye bağlıdır. Örneğin, ilk olarak daha eski derlemelerle gönderilen cihazlar, daha yeni derlemelerle gönderilen cihazlar için geçerli olan sistem gereksinimlerinin dışında kalabilir. Geçerli API düzeyi değerleri için Kod Adları, Etiketler ve Derleme Numaraları başlıklı makaleyi inceleyin.
ro.product.first_api_levelhakkında daha fazla bilgi için Vendor API düzeyi başlıklı makaleyi inceleyin.Android 10 veya önceki sürümler için CTS'yi ayarlama (AOSP 10 veya önceki sürümler) başlıklı makaleyi inceleyin.
Cihazınız APEX paket yönetimini destekliyorsa:
- Belirli Android sürümünüz ve donanım mimariniz için APEX ara katman paketini indirin. Shim paketleri tablosundaki soldaki iki sütunda, indirilecek paketin bağlantıları yer alır.
- İndirilen paketi
/system/apexkonumuna kopyalayın. - Dosyayı
com.android.apex.cts.shim.apexolarak yeniden adlandırın.
Cihazınız APEX paket yönetimini desteklemiyorsa:
- Belirli Android sürümünüz ve donanım mimariniz için APEX ara katman paketlerini indirin. Shim paketleri tablosundaki sağdaki iki sütunda, indirilecek paketlerin bağlantıları bulunur.
CtsShim.apkdosyasını/system/app/konumuna kopyalamaCtsShim.apkcihazınıCtsShimPrebuilt.apkolarak yeniden adlandırın.CtsShimPriv.apkdosyasını/system/priv-app/konumuna kopyalamaCtsShimPriv.apkcihazınıCtsShimPrivPrebuilt.apkolarak yeniden adlandırın.
Cihazınız birden fazla güvenlik unsuru bildiriyorsa:
google-cardlet.capdosyasını indirin.- İndirilen dosyayı
/data/uicc/cardlets/konumuna kopyalayın.
Cihazınız birden fazla güvenlik unsuru bildiriyorsa örnek küçük uygulamayı DUT'un yerleşik güvenlik unsuruna (eSE) veya DUT tarafından kullanılan SIM karta yükleyin. Daha fazla bilgi için Güvenli öğe için CTS testi başlıklı makaleyi inceleyin.
Cihazınızda yerleşik ekran yoksa cihaza bir ekran bağlayın.
Cihazda hafıza kartı yuvası varsa boş bir SD kart takın. CTS'yi geçebildiğini doğrulamak için SDHC veya SDXC kapasiteli, ultra yüksek hızlı (UHS) veri yolu destekleyen bir SD kart ya da 10 veya daha yüksek hız sınıfına sahip bir kart kullanın.
Cihazda SIM kart yuvaları varsa her yuvaya etkinleştirilmiş bir SIM kart takın. Cihaz SMS'i destekliyorsa her SIM kartın kendi numara alanı doldurulmalıdır. Android 12 veya daha yeni bir sürümün yüklü olduğu cihazlarda, tüm SIM kartların kısaltılmış arama numaralarını (ADN) depolama desteği olmalıdır. Telekomünikasyon için ayrılmış dosyayı (DFTelecom) içeren GSM ve USIM kartları bu koşulu karşılar.
Cihazınızda, UICC'yi hazırlama bölümünde belirtilen koşulları karşılayan CTS operatörü ayrıcalıklarına sahip bir SIM kart olduğundan emin olun.
DUT'u yapılandırma
CTS ile kullanılacak şekilde test cihazınızı yapılandırmak için aşağıdaki adımları uygulayın.
DUT'ta:
Cihazı fabrika verilerine sıfırlayın.
Cihazın dilini İngilizce (ABD) olarak ayarlayın.
Cihaz, varsayılan yazı tiplerini özelleştirmeyi destekliyorsa varsayılan sans-serif yazı tipi ailesinin Roboto olarak ayarlandığını doğrulayın.
Cihazda GPS, kablosuz ağ veya mobil ağ özelliği varsa konum ayarını etkinleştirin.
IPv6'yı destekleyen, DUT'u yalıtılmış bir istemci olarak değerlendirebilen ve internet bağlantısı olan bir kablosuz ağa bağlanın. İzole edilmiş istemcilerle ilgili açıklama için Fiziksel ortamı ayarlama başlıklı makaleyi inceleyin.
Kilit deseni veya şifre ayarlanmadığını doğrulayın.
USB üzerinden hata ayıklamayı etkinleştirin:
Ayarlar > Telefon hakkında'ya gidin ve Derleme numarası'na yedi kez dokunun. Geliştirici seçenekleri, Sistem ayarları kategorisinde görünür.
USB üzerinden hata ayıklama'ya dokunun.
Android 10 veya önceki sürümlerde USB üzerinden hata ayıklamayı etkinleştirmek için CTS'yi ayarlama (AOSP 10 veya önceki sürümler) başlıklı makaleyi inceleyin.
Saati 12 saatlik biçime ayarlayın.
Geliştirici seçenekleri > Uyanık kal'ı etkinleştirin.
USB uygulama doğrulamasını devre dışı bırakma:
Geliştirici seçenekleri'ne gidin.
USB'den yüklenen uygulamaları doğrula'ya dokunun.
Android 13 veya sonraki sürümlerde sahte modemi etkinleştirin:
Geliştirici seçenekleri'ne gidin.
Sahte Modem'e izin ver'e dokunun.
Bu ayar, belirli telefon testleri için gereklidir.
Masaüstü bilgisayarda:
Tarayıcıyı başlatın ve başlangıç veya kurulum ekranlarını kapatın.
Test edilen cihazı USB kablosuyla masaüstü makineye bağlayın.
Sistem, bu bilgisayar üzerinden hata ayıklamaya izin veren bir RSA anahtarını kabul etmenizi isterse USB üzerinden hata ayıklamaya izin ver'i tıklayın.
Kullanıcı tarafından erişilebilen (gizli olmayan) bir uygunluk (affordance) ayarı kullanarak Roboto2'yi sans-serif yazı tipi olarak ayarlayın.
CTS medya dosyalarını DUT'a kopyalayın:
- Medya dosyalarının indirildiği ve sıkıştırılmamış hâle getirildiği yola gidin (
cd). Dosya izinlerini değiştirme:
chmod u+x copy_media.shDosyaları kopyalayın:
720x480 çözünürlüğe kadar olan klipleri kopyalamak için şu komutu çalıştırın:
./copy_media.sh 720x480Maksimum çözünürlükten emin değilseniz tüm dosyaları kopyalayın:
./copy_media.sh allBirden fazla DUT varsa belirli bir cihazın seri seçeneğini (
-s) sona ekleyin. Örneğin, 1234567 seri numaralı cihaza 720x480 çözünürlüğe kadar kopyalamak için şu komutu çalıştırın:./copy_media.sh 720x480 -s 1234567
- Medya dosyalarının indirildiği ve sıkıştırılmamış hâle getirildiği yola gidin (
Mainline ile ilgili CTS dosyalarını indirme
Mainline ile ilgili CTS dosyalarını indirmek için:
Aşağıdaki komutu çalıştırarak cihazdaki Android API düzeyini alın:
adb shell getprop ro.build.version.sdkMainline CTS dosyalarını indirmek için
download_mcts.shkomut dosyasındaki talimatları uygulayın.İndirme işlemi, ağ hızınıza bağlı olarak en az 10 dakika sürer.
Shim paketleri
Aşağıdaki tabloda her cihaz sürümü ve mimar için kullanılabilen paketler listelenmiştir:
Sırada ne var?
Bu belgeyi okuduktan sonra Otomatik CTS testlerini çalıştırma bölümüne geçin.