CTS'yi ayarlama

CTS'yi çalıştırmak için önce fiziksel ortamınızı, masaüstü makinenizi ve kullandığınız Android cihazını test için hazırlayın.

Fiziki çevre

Bluetooth LE işaretleri

Test edilen cihaz (DUT) Bluetooth LE'yi destekliyorsa, Bluetooth LE tarama testi için DUT'nin 5 metre yakınına en az üç Bluetooth LE işaretçisi yerleştirin. Bu işaretlerin yapılandırılması veya belirli bir şey yayması gerekmez ve iBeacon, Eddystone ve hatta BLE işaretlerini simüle eden cihazlar dahil olmak üzere herhangi bir tür olabilir.

kameralar

Kamera CTS'sini çalıştırırken, bir test deseni çizelgesiyle (dama tahtası deseni gibi) normal aydınlatma koşullarını kullanın. Objektife çok yakın olmadığından emin olmak için test deseni tablosunu DUT'nin minimum odak mesafesine göre yerleştirin.

Kamera sensörlerini, test edilen sensörlerin CONTROL_AE_TARGET_FPS_RANGE içinde belirtilen maksimum yapılandırılmış saniyedeki hedef kare sayısına (FPS) ulaşmasına ve burada kalmasına izin vermek için yeterli aydınlatmaya sahip bir sahneye doğrultun. Test, listelenen cihazlar üzerinde yinelendiğinden ve performansı ayrı ayrı ölçtüğünden, bu, getCameraIdList tarafından bildirilen tüm kamera sensörleri için geçerlidir.

DUT, USB web kameraları gibi harici kameraları destekliyorsa, CTS çalıştırırken harici bir kamera takın. Aksi takdirde, CTS testleri başarısız olur.

GPS/GNSS

DUT, küresel konumlandırma sistemi/küresel navigasyon uydu sistemi (GPS/GNSS) özelliğini destekliyorsa, alım ve GPS konum hesaplaması için DUT'a uygun bir sinyal düzeyinde bir GPS/GNSS sinyali sağlayın. GPS kısmı, ICD-GPS-200C ile uyumlu olmalıdır. Aksi takdirde, GPS/GNSS sinyali, bir uydu simülatörü veya dış mekan sinyallerinin bir GPS/GNSS tekrarlayıcısı dahil olmak üzere herhangi bir türde olabilir veya DUT'yi, yeterli GPS/GNSS sinyalini doğrudan alabilecek şekilde bir pencereye yeterince yakın yerleştirebilirsiniz.

Wi-Fi ve IPv6

CTS testleri, IPv6'yı destekleyen, internet bağlantısı olan ve DUT'yi yalıtılmış bir istemci olarak değerlendirebilen bir Wi-Fi ağı gerektirir. Yalıtılmış bir istemci, DUT'nin o alt ağdaki yayın/çoklu ağ mesajlarına görünürlüğünün olmadığı bir yapılandırmayı ifade eder. Bu, bir Wi-Fi AP yapılandırmasıyla veya DUT'u başka cihazlar bağlı olmadan yalıtılmış bir alt ağda çalıştırarak gerçekleşir.

IPv6'ya bağlı olarak bazı testleri geçmek için yerel bir IPv6 ağına, bir IPv6 taşıyıcı ağına veya bir VPN'e erişiminiz yoksa, bir Wi-Fi erişim noktası ve bir IPv6 tüneli kullanabilirsiniz. Wikipedia'nın IPv6 tünel brokerleri listesine bakın.

Kablosuz RTT

Android, Wi-Fi gidiş-dönüş süresi (RTT) özelliği için Wi-Fi RTT API'sini içerir. Bu, cihazların erişim noktalarına olan mesafelerini 1 ila 2 metrelik bir doğrulukla ölçmesine olanak vererek, iç mekan konum doğruluğunu önemli ölçüde artırır. Wi-Fi RTT'yi destekleyen önerilen iki cihaz, Google Wifi ve Compulab'ın fitlet2 erişim noktasıdır (5 GHz'de 40 MHz bant genişliğine ayarlanmıştır).

Erişim noktalarına güç verilmelidir, ancak bir ağ bağlantısı gerektirmez. Erişim noktalarının test cihazının yanında olması gerekmez, ancak DUT'nin 40 fit içinde olması önerilir. Genellikle bir erişim noktası yeterlidir.

Masaüstü makine kurulumu

ADB ve AAPT

CTS'yi çalıştırmadan önce, hem Android Debug Bridge (adb) hem de Android Asset Packaging Tool'un (AAPT) son sürümlerini yüklediğinizden ve bu araçların konumunu makinenizin sistem yoluna eklediğinizden emin olun.

ADB'yi kurmak için, işletim sisteminiz için Android SDK Tools paketini indirin, açın ve verilen BENİOKU dosyasındaki talimatları izleyin. Sorun giderme bilgileri için bkz . Bağımsız SDK Araçlarını Yükleme .

adb ve aapt sistem yolunuzda olduğundan emin olun. Aşağıdaki komut, paket arşivini ana dizininizde açtığınızı varsayar:

export PATH=$PATH:$HOME/android-sdk-linux/build-tools/version

Ubuntu için Java Geliştirme Kiti

Java Development Kit'in (JDK) uygun sürümünü yükleyin.

  • Android 11 için OpenJDK11'i yükleyin.
  • Android 9 ve Android 10 için OpenJDK9'u yükleyin.
  • Android 7.0, 7.1, 8.0 ve 8.1 için OpenJDK8'i yükleyin.

Ayrıntılar için JDK gereksinimlerine bakın.

Python desteği için kurulum

Kurulum talimatlarını izleyerek platformunuz için virtualenv kurun.

virtualenv -h çağırarak kurulumun başarılı olduğunu doğrulayabilirsiniz.

CTS dosyaları

Cihazlarınızın Android sürümüyle ve cihazlarınızın desteklediği tüm uygulama ikili arabirimleriyle (ABI'ler) eşleşen Uyumluluk Testi Paketi İndirmeleri'nden CTS paketlerini indirin ve açın.

CTS medya dosyalarının en son sürümünü indirin ve açın.

Cihaz algılama

Cihazınızı algılamak için sisteminizi kurmak için adımı izleyin.

hafıza sınırı

cts-tradfed komut dosyasında test çalıştırması sırasında kullanılabilen maksimum belleği artırmak isteyebilirsiniz. Daha fazla bilgi için CL örneğine bakın.

Android cihaz kurulumu

Kullanıcı derlemeleri

Uyumlu bir cihaz, kullanıcı/serbest bırakma anahtarı imzalı yapıya sahip bir cihaz olarak tanımlanır. Cihazınız, Kod Adları, Etiketler ve Yapı Numaralarından uyumlu olduğu bilinen kullanıcı derlemesine (Android 4.0 veya üstü) dayalı bir sistem görüntüsü çalıştırıyor olmalıdır.

İlk API düzeyinde yapı özelliği

Belirli CTS gereksinimleri, bir cihazın orijinal olarak birlikte gönderildiği yapıya bağlıdır. Örneğin, orijinal olarak daha önceki yapılarla birlikte gelen cihazlar, sonraki yapılarla birlikte gelen cihazlar için geçerli olan sistem gereksinimlerinden hariç tutulabilir.

Bu bilgiyi CTS'ye sunmak için, cihaz üreticileri ro.product.first_api_level oluşturma zamanı özelliğini tanımlamış olabilir. Bu özelliğin değeri, cihazın ticari olarak piyasaya sürüldüğü ilk API düzeyidir.

Cihaz üreticileri, aynı cihaz grubundaki mevcut bir ürünün yükseltmesi olarak yeni bir ürün başlatmak için ortak temel uygulamayı yeniden kullanabilir. Cihaz üreticileri isteğe bağlı olarak mevcut ürünün API seviyesini ro.product.first_api_level olarak ayarlayabilir, böylece CTS ve Treble/VTS için yükseltme gereksinimleri uygulanır.

Cihaz üreticileri, aşağıdaki örnekte gösterildiği gibi, bu özelliği ayarlamak için device.mk dosyasına PRODUCT_PROPERTY_OVERRIDES ekleyebilir:

#ro.product.first_api_level indicates the first api level that the device has
been commercially launched on.
PRODUCT_PROPERTY_OVERRIDES +=\
ro.product.first_api_level=21

Android 9 veya üzeri için ilk API seviyesi

Android 9 veya sonraki sürümlerle başlatılan cihazlar için ro.product.first_api_level özelliğini Codenames, Tags ve Build Numbers'dan geçerli bir değere ayarlayın.

Android 8.x veya altı için ilk API düzeyi

Android 8.x veya önceki sürümlerde başlatılan cihazlar için, ürünün ilk yapısı için ro.product.first_api_level özelliğini kaldırın (kaldırın). Sonraki tüm yapılar için ro.product.first_api_level doğru API düzeyi değerine ayarlayın. Bu, mülkün yeni bir ürünü doğru bir şekilde tanımlamasını sağlar ve ürünün ilk API düzeyi hakkındaki bilgileri korur. Bayrak ayarlanmamışsa, Android, Build.VERSION.SDK_INT öğesini Build.VERSION.SDK_INT ro.product.first_api_level atar.

CTS pul paketleri

Android 10 veya üstü, APEX adlı bir paket biçimi içerir. APEX yönetim API'leri (yeni bir sürüme güncelleme veya etkin APEX'leri raporlama gibi) için CTS testlerini çalıştırmak için bir /system bölümüne bir CtsShimApex paketini önceden yüklemelisiniz.

APEX dolgu doğrulama testi, CtsShimApex uygulanmasını doğrular.

ro.apex.updatable gereksinimler

  • ro.apex.updatable özelliği true olarak ayarlanırsa, APEX paket yönetimini destekleyen tüm cihazlar için CtsShimApex gerekir.

  • ro.apex.updatable özelliği yoksa veya ayarlanmadıysa, CtsShimApex bir cihaza önceden yüklenmesi gerekmez.

APEX dolgu doğrulama testi, CtsShimApex uygulanmasını doğrular.

CtsShim ön yüklemeleri ve önyüklemeleri

Android 11'den başlayarak, CtsShimApex , bildirim dışında herhangi bir kod içermeyen iki önceden oluşturulmuş uygulama ( build kaynağından oluşturulmuştur ) içerir. CTS, ayrıcalıkları ve izinleri test etmek için bu uygulamaları kullanır.

Cihaz APEX paket yönetimini desteklemiyorsa (yani ro.apex.updatable özelliği eksikse veya ayarlanmamışsa) veya cihaz 10 veya daha düşük bir sürümü çalıştırıyorsa, önceden oluşturulmuş iki uygulama sistem ayrı.

Cihaz Sürümü ön yükleme
(APEX destekleniyorsa)
ön yükleme
KOL x86 KOL x86
Android 12 android12-kol bırakma
/system/apex/com.android.apex.cts.shim.apex altında
android12-x86 sürümü
/system/apex/com.android.apex.cts.shim.apex altında
android12-arm-CtsShim.apk
/system/app/CtsShimPrebuilt.apk altında

android12-arm-CtsShimPriv.apk
/system/priv-app/CtsShimPrivPrebuilt.apk altında

android12-x86-CtsShim.apk
/system/app/CtsShimPrebuilt.apk altında

android12-x86-CtsShimPriv.apk
/system/priv-app/CtsShimPrivPrebuilt.apk altında

Android 11 android11-kol bırakma
/system/apex/com.android.apex.cts.shim.apex altında
android11-x86 sürümü
/system/apex/com.android.apex.cts.shim.apex altında
android11-arm-CtsShim.apk
/system/app/CtsShimPrebuilt.apk altında

android11-arm-CtsShimPriv.apk
/system/priv-app/CtsShimPrivPrebuilt.apk altında

android11-x86-CtsShim.apk
/system/app/CtsShimPrebuilt.apk altında

android11-x86-CtsShimPriv.apk
/system/priv-app/CtsShimPrivPrebuilt.apk altında

Android 10 android10 sürümü
/system/apex/com.android.apex.cts.shim.apex altında
android10-arm-CtsShim.apk
/system/app/CtsShimPrebuilt.apk altında

android10-arm-CtsShimPriv.apk
/system/priv-app/CtsShimPrivPrebuilt.apk altında

android10-x86-CtsShim.apk
/system/app/CtsShimPrebuilt.apk altında

android10-x86-CtsShimPriv.apk
/system/priv-app/CtsShimPrivPrebuilt.apk altında

Android 9, O ve O-MR1 Yok Yok arm-CtsShim.apk
/system/app/CtsShimPrebuilt.apk altında

arm-CtsShimPriv.apk
/system/priv-app/CtsShimPrivPrebuilt.apk altında

x86-CtsShim.apk
/system/app/CtsShimPrebuilt.apk altında

x86-CtsShimPriv.apk
/system/priv-app/CtsShimPrivPrebuilt.apk altında

Testleri geçmek için uygulamaları yeniden imzalamadan sistem görüntüsündeki uygun dizinlere önceden yükleyin.

Örnek Uygulama

Android 9, Open Mobile API'lerini tanıttı. Birden fazla güvenli öğe bildiren cihazlar için, CTS, Open Mobile API'lerinin davranışını doğrulamak için test senaryoları ekler. Bu test durumları, bir örnek uygulamanın DUT'un yerleşik Güvenli Öğesine (eSE) veya DUT tarafından kullanılan SIM karta bir kerelik kurulumunu gerektirir. eSE örnek uygulaması ve SIM örnek uygulaması AOSP'de bulunabilir.

Open Mobile API test senaryoları ve Erişim Kontrolü test senaryoları hakkında daha ayrıntılı bilgi için Güvenli Öğe için CTS Testi'ne bakın.

Depolama gereksinimleri

CTS ortam stres testleri, video kliplerin harici depolamada ( /sdcard ) olmasını gerektirir. Kliplerin çoğu, Creative Commons Atıf 3.0 lisansı altında Blender Vakfı'na ait olan Big Buck Bunny'den alınmıştır.

Gerekli alan, cihaz tarafından desteklenen maksimum video oynatma çözünürlüğüne bağlıdır. Gerekli çözünürlüklerin platform versiyonu için Android Uyumluluk Tanımı belgesindeki 5. bölüme bakın.

Maksimum video oynatma çözünürlüğüne göre depolama gereksinimleri şunlardır:

  • 480x360: 98 MB
  • 720x480: 193 MB
  • 1280x720: 606 MB
  • 1920x1080: 1863 MB

Ekran ve depolama

  • Katıştırılmış ekranı olmayan herhangi bir cihazın bir ekrana bağlanması gerekir.
  • Cihazda hafıza kartı yuvası varsa boş bir SD kart takın. CTS'yi geçebilmesini sağlamak için SDHC veya SDXC kapasiteli ultra yüksek hızlı (UHS) veri yolunu destekleyen veya en az hız sınıfı 10 veya daha yüksek olan bir SD 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 sonraki sürümleri çalıştıran cihazlarda, tüm SIM kartların kısaltılmış arama numaralarını (ADN) kaydetme desteği olmalıdır. Telekomünikasyona özel dosyaya (DF Telecom ) sahip GSM ve USIM kartları bu gereksinimi karşılar.

Geliştirici UICC

CTS operatör API testlerini çalıştırmak için cihazın , UICC'yi Hazırlama bölümünde belirtilen gereksinimleri karşılayan CTS operatör ayrıcalıklarına sahip bir SIM kullanması gerekir.

Android cihaz yapılandırması

  1. Cihazı fabrika verilerine sıfırlayın: Ayarlar > Yedekle ve sıfırla > Fabrika verilerine sıfırla .

  2. Cihazınızın dilini İngilizce ( Amerika Birleşik Devletleri ) olarak ayarlayın : Ayarlar > Dil ve giriş > Dil .

  3. Aygıt varsayılan yazı tiplerini özelleştirmeyi destekliyorsa, varsayılan sans-serif yazı tipi ailesini Roboto olarak ayarlayın (AOSP yapılarında kullanılan varsayılan sans-serif yazı tipi ailesi).

  4. Cihazda bir GPS veya Wi-Fi/hücresel ağ özelliği varsa konum ayarını açın: Ayarlar > Konum > Açık .

  5. IPv6'yı destekleyen, DUT'a yalıtılmış bir istemci olarak davranabilen (yukarıdaki Fiziksel ortam bölümüne bakın) ve internet bağlantısı olan bir Wi-Fi ağına bağlanın: Ayarlar > Wi-Fi .

  6. Cihazda herhangi bir kilit deseni veya parola ayarlanmadığından emin olun: Ayarlar > Güvenlik > Ekran kilidi > Yok .

  7. Cihazınızda USB hata ayıklamasını etkinleştirin: Ayarlar > Geliştirici seçenekleri > USB hata ayıklama .

  8. Saati 12 saat biçimine ayarlayın: Ayarlar > Tarih ve saat > 24 saat biçimini kullan > Kapalı .

  9. Cihazı uyanık kalacak şekilde ayarlayın: Ayarlar > Geliştirici seçenekleri > Uyanık Kal > Açık .

  10. Yalnızca Android 5.x ve 4.4.x'te cihazı sahte konumlara izin verecek şekilde ayarlayın: Ayarlar > Geliştirici seçenekleri > Sahte konumlara izin ver > Açık .

  11. Android 4.2 veya sonraki sürümlerde , USB uygulama doğrulamasını kapatın: Ayarlar > Geliştirici seçenekleri > USB üzerinden uygulamaları doğrula > Kapalı .

  12. Tarayıcıyı başlatın ve herhangi bir başlangıç/kurulum ekranını kapatın.

  13. Cihazı test etmek için kullanılacak masaüstü makineyi bir USB kablosu ile bağlayın.

Dosya kurulumu

Cihaza yardımcı uygulamaları yükleyin ve yapılandırın.

  1. Cihazınızı CTS sürümünüze göre ayarlayın:

    • CTS sürümleri 2.1 R2 ila 4.2 R4: Cihazınızı (veya öykünücünüzü) aşağıdakilerle erişilebilirlik testlerini çalıştıracak şekilde ayarlayın: abd install -r android-cts/repository/testcases/CtsDelegatingAccessibilityService.apk

      Cihazda yetkilendirmeyi etkinleştirin: Ayarlar > Erişilebilirlik > Erişilebilirlik > Erişilebilirlik Hizmeti Temsilcisi .

    • CTS 6.x veya önceki sürümleri: android.software.device_admin bildiren cihazlarda, cihazınızı aşağıdakileri kullanarak cihaz yönetim testini çalıştıracak şekilde ayarlayın: adb install -r android-cts/repository/testcases/CtsDeviceAdmin.apk`

      Ayarlar > Güvenlik > Cihaz yöneticilerini seçin , iki android.deviceadmin.cts.CtsDeviceAdminReceiver* cihaz yöneticisini etkinleştirin. android.deviceadmin.cts.CtsDeviceAdminDeactivatedReceiver ve diğer önceden yüklenmiş cihaz yöneticilerinin devre dışı kaldığından emin olun.

  2. CTS medya dosyalarını aşağıdaki şekilde cihaza kopyalayın:

    1. Medya dosyalarının indirildiği ve sıkıştırıldığı yola gidin ( cd ).
    2. Dosya izinlerini değiştirin: chmod u+x copy_media.sh

    3. Gerekli dosyaları kopyalayın:

      • 720x480 çözünürlüğe kadar klipleri kopyalamak için şunu çalıştırın:

        ./copy_media.sh 720x480
        
      • Maksimum çözünürlükten emin değilseniz, tüm dosyaları kopyalayın:

        ./copy_media.sh all
        
      • adb altında birden fazla cihaz varsa, belirli bir cihazın seri seçeneğini ( -s ) sonuna ekleyin. Örneğin, seri 1234567 olan cihaza 720x480'e kadar kopyalamak için şunu çalıştırın:

        ./copy_media.sh 720x480 -s 1234567