CTS otomatik testini ayarlama

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.

Not: Test çalıştırma süresini kısaltmak için aynı anda birden fazla DUT'yi test edebilirsiniz. Örneğin, USB hub'ı kullanarak cihazları aynı test iş istasyonuna bağlayabilirsiniz.

Fiziksel ortamı ayarlama

Belirli CTS testleri, DUT'un yakınına kurulacak harici cihazların kullanılmasını gerektirir. Fiziksel ortamınızı ayarlamak için:

Not: Aynı anda birden fazla DUT test ediyorsanız her DUT için fiziksel ortamı ayarlamanız gerekir.

1. (isteğe bağlı) DUT'unuz Bluetooth LE'yi destekliyorsa Bluetooth LE tarama testi için DUT'un 5 metre yakınına en az üç Bluetooth LE işaretçisi yerleştirin. Buna ek olarak:

   • İşaretçilerin yapılandırılması veya belirli bir şey yayması gerekmez.
   • İşaretçi, iBeacon, Eddystone ve hatta BLE işaretçilerini taklit eden cihazlar dahil olmak üzere her türde olabilir.

2. Telefonu, DUT'un minimum odak mesafesine eşit bir mesafede, duvar veya tavan gibi bir sahnenin önüne yerleştirin. Buna ek olarak:

   • Sahnede, test edilen sensörlerin CONTROL_AE_TARGET_FPS_RANGE bölümünde belirtildiği gibi yapılandırılmış maksimum saniyedeki kare sayısına (FPS) ulaşmasına ve bu değerde kalmasına yetecek kadar ışık olmalıdır.
   • Test, listelenen cihazlar üzerinde iterasyon yaparak performansı ayrı ayrı ölçtüğü için bu ayar, getCameraIdList tarafından raporlanan 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.

3. (isteğe bağlı) DUT'unuz bir küresel konumlandırma sistemi (GPS) veya başka bir küresel navigasyon uydu sistemi (GNSS) destekliyorsa DUT'a, alım ve konum hesaplaması için uygun bir sinyal seviyesinde GNSS sinyali sağlayın. Buna ek olarak:

   • GPS, ICD-GPS-200C ile uyumlu olmalıdır.
   • GNSS sinyali, uydu simülasyon cihazı veya açık hava sinyallerinin tekrarlayıcısı da dahil olmak üzere her türde olabilir.
   • DUT'u bir pencereye yakın bir yere yerleştirerek doğrudan bir uydudan yeterli GNSS sinyali almasını sağlayabilirsiniz.
   Dikkat: GPS testinde, internet bağlantısı kurulumu supl.google.com 7276 bağlantı noktasına yapılan bağlantıları engellememelidir. Bu bağlantı noktası, yerel cihazda konum hesaplamasını test etmek için GPS yardım verilerini indirir.

4. Kablosuz ağınızın IPv4 ve IPv6'yı desteklediğinden, IPv4 ve IPv6 için DNS'ye sahip bir internet bağlantısına sahip olduğundan, IP çoklu yayını desteklediğinden ve DUT'yu yalıtılmış bir istemci olarak işleyebildiğinden emin olun.

   Not: İzole edilmiş istemci, DUT'nun ilgili alt ağdaki yayın veya çok ağ mesajlarını göremediği bir yapılandırmadır. Yalıtılmış bir istemci oluşturmak için kablosuz erişim noktası (AP) yapılandırması kullanın veya DUT'yi başka cihazlar bağlı olmadan yalıtılmış bir alt ağda çalıştırın.

   IPv6 testlerini geçmek için yerel bir IPv6 ağına, IPv6 operatör ağına veya VPN'ye erişiminiz yoksa kablosuz AP ve IPv6 tüneli kullanın.

5. DUT'ta kablosuz arayüzünde UP, BROADCAST ve MULTICAST işaretlerinin ayarlandığından emin olun.

6. Kablosuz arayüzüne IPv4 ve IPv6 adreslerinin atandığından emin olun. Kablosuz arayüz özelliklerini kontrol etmek için adb shell ifconfig komutunu çalıştırın.

7. (isteğe bağlı) DUT'unuz Kablosuz STA veya STA eşzamanlılığını destekliyorsa en az iki kablosuz ağ oluşturun. Bu kablosuz ağlar, farklı SSID'lere sahip farklı bantlarda veya farklı BSSID'lere sahip aynı SSID'de çalışmalıdır.

8. (isteğe bağlı) DUT'unuz Kablosuz ağ gidiş dönüş süresini (RTT) destekliyorsa kablosuz ağ RTT'yi destekleyen bir cihaz kurun:

   1. Kablosuz RTT cihazını DUT'un 12 metre yakınına yerleştirin.
   2. Kablosuz RTT cihazını açın.

   Kablosuz RTT'yi destekleyen iki önerilen cihaz şunlardır: - Google Wifi - Compulab'ın fitlet2 erişim noktası (5 GHz'te 40 MHz bant genişliğine ayarlanmıştır).

Masaüstü bilgisayarınızı kurma

CTS otomatik testlerini çalıştırmadan önce, masaüstü bilgisayarınızın donanım ve işletim sistemi gereksinimlerini karşıladığından ve aşağıdaki bölümlerde açıklandığı gibi uygun yazılımın yüklü olduğundan emin olun.

Meet Donanım gereksinimleri

CTS masaüstü bilgisayarınız aşağıdaki donanım gereksinimlerini karşılamalı veya aşmalıdır:

• 64 bit x86 sistem

• Artan CTS test örneği sayısına ve Tradefed'de Java yığın alanı rezervasyonundaki artışa uyum sağlamak için en az 256 GB boş disk alanı

• En az 32 GB RAM

İşletim sistemi gereksinimlerini karşılama

Geliştirme makinenizde GNU C Kitaplığı (glibc) 2.17 veya daha yeni bir sürümün yüklü olduğu 64 bit bir Linux dağıtımı çalışmalıdır.

Masaüstü yazılımını yükleme

CTS için uygun masaüstü yazılımını yüklemek üzere:

1. FFmpeg paketinin 5.1.3 veya sonraki bir sürümünü yükleyin.

2. Android Debug Bridge (adb) ve Android Asset Packaging Tool (AAPT2)'ın en son sürümlerini yükleyin ve bu araçların konumunu makinenizin sistem yoluna ekleyin:

   1. sdkmanager komut satırı aracını yüklemek için SDK Yöneticisi 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 alt kısmındaki Yalnızca komut satırı araçları bölümünde yer alır.
   2. Sistem yolunuzu, yeni yüklenen sdkmanager'ün konumunu içerecek şekilde güncelleyin.
   3. sdkmanager'ü kullanarak en son platform-tools ve build-tools paketlerini yükleyin. Bu paketler adb ve AAPT2 içerir. Paketleri yükleme hakkında bilgi edinmek için Paketleri yükleme başlıklı makaleyi inceleyin.
   4. Yeni yüklenen adb ve AAPT2 araçlarının konumunu içerecek şekilde yolunuzu güncelleyin.
   5. adb ve AAPT2'nin yolunuzda olduğunu doğrulayın.
   Not: Alternatif olarak, CTS masaüstü bilgisayarınızda Android Studio kullanıyorsanız platformu ve SDK derleme araçlarını yüklemek için Android SDK Platform Araçları ve Android SDK Derleme Araçları seçeneklerini kontrol edebilirsiniz.

3. Java Geliştirme Kiti'nin (JDK) 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.

4. (isteğe bağlı) Android 13 veya sonraki sürümler için virtualenv'i yükleyin. Çok cihazlı testler için virtualenv aracı gereklidir.

5. Python'un yüklü olduğundan emin olmak için python3 yazın. Python'un düzgün şekilde yüklendiğini belirten Python sürümü ve tarihi gösterilir.

6. Uyumluluk Test Paketi indirmelerinden 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 indirip açın.

7. CTS medya dosyalarının en son sürümünü indirip açın. Medya dosyalarında, Big Buck Bunny'dan alınan ve Creative Commons Atıf 3.0 lisansı kapsamında Blender Foundation tarafından telif hakkıyla korunan video klipler yer alır.

8. (isteğe bağlı) CTS'yi ilk kez çalıştırdığınızda, ana hatla ilgili bazı CTS dosyalarını dinamik olarak indirir. Bu indirme işlemi, ağ hızınıza bağlı olarak CTS çalışma süresine 10 dakika veya daha fazla süre ekler.

   Bu ek CTS çalışma süresini önlemek için CTS'yi çalıştırmadan önce ana hatla ilgili CTS dosyalarını indirebilirsiniz. Ana hatla ilgili CTS dosyalarını indirme hakkında bilgi edinmek için Ana hatla ilgili CTS dosyalarını indirme başlıklı makaleyi inceleyin.

DUT'u hazırlama

Masaüstü bilgisayarınızı ayarladıktan sonra DUT'yu kurup yapılandırmanız gerekir.

DUT'u kurma

DUT'u kurmak için:

1. DUT'un, Kod Adları, Etiketler ve Derleme Numaraları'nda uyumlu olduğu bilinen kullanıcı derlemesini (Android 4.0 veya sonraki sürümler) temel alan bir sistem görüntüsünü çalıştırdığından ve user derleme varyantını kullandığından emin olun. Derleme varyantları hakkında daha fazla bilgi için Hedef seçme başlıklı makaleyi inceleyin.

2. DUT'ta Android 13 veya sonraki bir sürüm yüklüyse derlemenin ro.product.first_api_level, cihazın ticari olarak kullanıma sunulduğu API düzeyine ayarlandığından emin olun. Bu değeri ayarlamak için device.mk dosyasında aşağıdaki değişikliği yapın:

   PRODUCT_SHIPPING_API_LEVEL := 21
   

   Belirli CTS şartları, cihazın ilk gönderildiği derlemeye bağlıdır. Örneğin, başlangıçta daha eski sürümlerle birlikte gönderilen cihazlar, daha yeni sürümlerle birlikte gönderilen cihazlar için geçerli olan sistem koşullarından hariç tutulabilir. Geçerli API düzeyi değerleri için Kod Adları, Etiketler ve Yapı Numaraları başlıklı makaleyi inceleyin. ro.product.first_api_level hakkında daha fazla bilgi için Tedarikçi 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.

3. Cihazınız APEX paket yönetimi özelliğini destekliyorsa:

   1. Android sürümünüz ve donanım mimarinize uygun APEX shim paketini indirin. Dolgu paketleri tablosunun solundaki iki sütunda, indirilecek paketin bağlantıları sağlanır.
   2. İndirilen paketi /system/apex'e kopyalayın.
   3. Dosyayı com.android.apex.cts.shim.apex olarak yeniden adlandırın.

4. Cihazınız APEX paket yönetimini desteklemiyorsa:

   1. Android sürümünüz ve donanım mimarinize özel APEX shim paketlerini indirin. Ara yazılım paketleri tablosundaki sağdaki iki sütunda, indirilecek paketlerin bağlantıları sağlanır.
   2. CtsShim.apk dosyasını /system/app/ klasörüne kopyala
   3. CtsShim.apk'ü CtsShimPrebuilt.apk olarak yeniden adlandırın
   4. CtsShimPriv.apk dosyasını /system/priv-app/ klasörüne kopyala
   5. CtsShimPriv.apk'ü CtsShimPrivPrebuilt.apk olarak yeniden adlandırın

5. Cihazınız birden fazla güvenli öğe bildirirse:

   1. google-cardlet.cap dosyasını indirin.
   2. İndirilen dosyayı /data/uicc/cardlets/ klasörüne kopyalayın.

6. Cihazınız birden fazla güvenli öğe bildiriyorsa örnek appleti DUT'un yerleşik güvenli öğesine (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.

7. Cihazınızda yerleşik ekran yoksa cihaza bir ekran bağlayın.

8. Cihazda hafıza kartı yuvası varsa boş bir SD kart takın. CTS'den geçebilmesi için SDHC veya SDXC kapasiteli ultra yüksek hızlı (UHS) bir veriyolu destekleyen bir SD kart ya da hız sınıfı 10 veya daha iyi bir kart kullanın.

   Uyarı: CTS, cihaza takılı SD karttaki verileri değiştirebilir veya silebilir.

9. Cihazda SIM kart yuvaları varsa her yuvaya etkin bir SIM kart takın. Cihaz SMS'yi destekliyorsa her SIM kartın kendi numara alanı doldurulmalıdır. Android 12 veya sonraki sürümleri çalıştıran cihazlarda tüm SIM kartlar kısa numaraları (ADN) depolama desteğine sahip olmalıdır. Telekomünikasyona özel dosyaya (DF_Telecom) sahip GSM ve USIM kartları bu koşulu karşılar.

   Uyarı: CTS, cihaza takılı SIM kartlardaki verileri değiştirebilir veya silebilir.

10. 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 bulunduğundan emin olun.

Not: Aynı anda birden fazla DUT test ediyorsanız her DUT'yu ayarlamanız gerekir.

DUT'u yapılandırma

DUT'unuzu CTS ile kullanılacak şekilde yapılandırmak için aşağıdaki adımları uygulayın.

Not: Android 10 veya daha eski bir sürümü kullanıyorsanız DUT'yu yapılandırma bölümünü okuyun.

DUT'ta:

1. Cihazı fabrika verilerine sıfırlayın.

   Uyarı: Bu sıfırlama işlemi, cihazdaki tüm kullanıcı verilerini siler.

2. Cihazın dilini İngilizce (ABD) olarak ayarlayın.

3. Cihaz varsayılan yazı tiplerini özelleştirmeyi destekliyorsa varsayılan sans-serif yazı tipi ailesinin Roboto olarak ayarlandığından emin olun.

4. Cihazınızda GPS, kablosuz ağ veya mobil ağ özelliği varsa konum ayarını etkinleştirin.

5. IPv6'yı destekleyen, DUT'yu izole bir istemci olarak değerlendirebilen ve internet bağlantısı olan bir kablosuz ağa bağlanın. İzole istemciler hakkında bilgi edinmek için Fiziksel ortamı ayarlama başlıklı makaleyi inceleyin.

6. Kilit deseninin veya şifresinin ayarlanmadığından emin olun.

7. USB hata ayıklamayı etkinleştirme:

   1. Ayarlar > Telefon hakkında'ya gidin ve Derleme numarası'na yedi kez dokunun. Geliştirici seçenekleri, Sistem ayarları kategorisinde görünür.

   2. USB üzerinden hata ayıklama'ya dokunun.

   Android 10 veya önceki sürümlerde USB hata ayıklama özelliğini etkinleştirmek için CTS'yi ayarlama (AOSP 10 veya önceki sürümler) başlıklı makaleyi inceleyin.

8. Saati 12 saatlik biçime ayarlayın.

9. Geliştirici seçenekleri > Uyku moduna girme'yi etkinleştirin.

10. USB üzerinden uygulama doğrulamasını devre dışı bırakma:

    1. Geliştirici seçenekleri'ne gidin.

    2. USB üzerinden uygulamaları doğrula'ya dokunun.

11. Android 13 veya sonraki sürümlerde sahte modemi etkinleştirin:

    1. Geliştirici seçenekleri'ne gidin.

    2. Sahte Modem'e izin ver'e dokunun.

    Bu ayar, belirli telefon görüşmeleri testleri için gereklidir.

Masaüstü bilgisayarda:

1. Tarayıcıyı başlatın ve tüm başlangıç veya kurulum ekranlarını kapatın.

2. DUT'yu USB kablosuyla masaüstü bilgisayara bağlayın.

3. Sistem, bu bilgisayar üzerinden hata ayıklama işlemine izin veren bir RSA anahtarını kabul etmenizi isterse USB üzerinden hata ayıklamaya izin ver'i tıklayın.

4. Kullanıcının erişebileceği bir kolaylık (gizli olmayan) ayar kullanarak Roboto2'yi sans serif yazı tipi olarak ayarlayın.

5. CTS medya dosyalarını DUT'a kopyalayın:

   1. Medya dosyalarının indirildiği ve sıkıştırmasının açıldığı yola gidin (cd).

   2. Dosya izinlerini değiştirin:

      chmod u+x copy_media.sh
      

   3. Dosyaları kopyalayın:

      • Klipleri 720x480 çözünürlüğe kadar kopyalamak için:

        ./copy_media.sh 720x480

      • Maksimum çözünürlükten emin değilseniz tüm dosyaları kopyalayın:

        ./copy_media.sh all

      • Birden fazla DUT varsa belirli bir cihazın seri numarası seçeneğini (-s) sonuna ekleyin. Örneğin, 1234567 seri numaralı cihaza 720x480'e kadar kopyalamak için şu komutu çalıştırın:

        ./copy_media.sh 720x480 -s 1234567

Ana hatla ilgili CTS dosyalarını indirme

Ana hatla ilgili CTS dosyalarını indirmek için:

1. Aşağıdaki komutu çalıştırarak cihazdaki Android API düzeyini öğrenin:

   adb shell getprop ro.build.version.sdk
   

2. Ana CTS dosyalarını indirmek için download_mcts.sh komut dosyasında yer alan talimatları uygulayın.

   İndirme işlemi, ağ hızınıza bağlı olarak en az 10 dakika sürer.

Dolgu paketleri

Aşağıdaki tabloda her cihaz sürümü ve mimarisi için kullanılabilen paketler listelenmiştir:

Cihaz Sürümü	Paketler (APEX destekleniyorsa)		Paketler (APEX desteklenmiyorsa)
	ALARMI ETKİNLEŞTİR	x86	ALARMI ETKİNLEŞTİR	x86
Android 15	15-arm-release	android15-x86-release	android15-arm-CtsShim.apk android15-arm-CtsShimPriv.apk	android15-x86-CtsShim.apk android15-x86-CtsShimPriv.apk
Android 14	android14-arm-release	android14-x86-release	android14-arm-CtsShim.apk android14-arm-CtsShimPriv.apk	android14-x86-CtsShim.apk android14-x86-CtsShimPriv.apk
Android 13	android13-arm-release	android13-x86-release	android13-arm-CtsShim.apk android13-arm-CtsShimPriv.apk	android13-x86-CtsShim.apk android13-x86-CtsShimPriv.apk
Android 12	android12-arm-release	android12-x86-release	android12-arm-CtsShim.apk android12-arm-CtsShimPriv.apk	android12-x86-CtsShim.apk android12-x86-CtsShimPriv.apk
Android 11	android11-arm-release	android11-x86-release	android11-arm-CtsShim.apk android11-arm-CtsShimPriv.apk	android11-x86-CtsShim.apk android11-x86-CtsShimPriv.apk
Android 10	android10-release		android10-arm-CtsShim.apk android10-arm-CtsShimPriv.apk	android10-x86-CtsShim.apk android10-x86-CtsShimPriv.apk
Android 9, O ve O-MR1	Yok	Yok	arm-CtsShim.apk arm-CtsShimPriv.apk	x86-CtsShim.apk x86-CtsShimPriv.apk

Sırada ne var?

Bu dokümanı okuduktan sonra Otomatik CTS testlerini çalıştırma başlıklı makaleyi inceleyin.