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.

Ulaşmak ve belirtilen en yapılandırılmış hedef saniyedeki kare sayısı (FPS) kalmasına test edilen sensörler imkan vermek için yeterli aydınlatma ile bir sahne için kamera sensörleri Noktadan CONTROL_AE_TARGET_FPS_RANGE . Bu rapor tüm kamera sensörleri için geçerlidir getCameraIdList tek tek listelenmiş cihazlar ve önlemler performansı üzerinde deney dolaşır olarak.

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.

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 alabilmesi için 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ğlanmadan 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 Bkz IPv6 tünel broker listesini .

Kablosuz RTT

Android içerir Kablosuz RTT API for a Wi-Fi gidiş-dönüş süresi (RTT) yeteneği. Bu, cihazların erişim noktalarına olan mesafelerini 1 ila 2 metrelik bir doğrulukla ölçmesine olanak tanıyarak iç mekan konum doğruluğunu önemli ölçüde artırır. Kablosuz RTT'yi destekleyen iki tavsiye cihazlardır tarihinde Wifi ve Compulab en fitlet2 erişim noktası (5 GHz 40 MHz bant genişliğine ayarlanı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 çalıştırmadan önce, her iki son sürümlerini yüklemiş sağlamak Android Debug Bridge (adb) ve Aracı (AAPT) Packaging Android Varlık ve makinenizin sistem yoluna bu araçların yerini ekledi.

ADB yüklemek için, karşıdan Android SDK Tool , işletim sisteminiz için paket açın ve README dosyasında yönergeleri izleyin. Sorun giderme bilgileri için bkz Stand-alone SDK Araçlarının Kurulması .

Emin olun adb ve aapt sistem yolunda bulunmaktadır. 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

Doğru sürümünü yükleyin Java Development Kit (JDK) .

  • 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 bkz JDK gereksinimleri .

CTS dosyaları

Yükleme ve gelen CTS paketlerini açmak Uyumluluk Testi Suite İndirme cihazlarınızın Android sürümü ve tüm uygulama ikili arayüzleri (ABI) cihazlarınızın desteklediği bulundu.

İndirin ve en son sürümünü açmak CTS medya dosyaları .

Cihaz algılama

İçin adımı takip cihazınızı algılamak için sisteminizi kurmak .

hafıza sınırı

Sen test çalışması sırasında mevcut maksimum belleği artırmak isteyebilirsiniz cts-tradfed senaryo. Bakınız örnek CL Daha fazla bilgi için.

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 gelen uyumlu kullanıcı yapı (Android 4.0 veya daha yüksek) olduğu bilinen dayalı bir sistem görüntüsü çalışıyor olması gerekir codenames, Etiketler ve Yapı Numaraları .

İ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 gönderilen cihazlar için geçerli olan sistem gereksinimlerinden hariç tutulabilir.

CTS'ye bu bilgiler kullanılabilir hale getirmek için, cihaz üreticileri birikmesi zaman özelliği tanımlı olabilirdi ro.product.first_api_level . 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 mevcut ürünün API düzeyi ayarlayabilirsiniz ro.product.first_api_level yükseltme gereksinimleri CTS ve Tiz / VTS için uygulanır böylece.

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

#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 üstü ile başlatılan cihazlar için ayarlanmış ro.product.first_api_level arasında geçerli bir değere özelliği codenames, Etiketler ve Yapı Numaraları .

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

Android 8.x veya alt unset (kaldır) başlatıldı cihazlar için ro.product.first_api_level ürünün ilk yapı için özellik. Sonraki tüm set kurar İçin ro.product.first_api_level doğru API seviyesi değerine. 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 ayarlanmazsa, Android atar Build.VERSION.SDK_INT için ro.product.first_api_level .

CTS şim paketleri

Android 10 veya daha yüksek adında bir paket formatını içermektedir APEX . Eğer bir önceden kurmalısınız (yeni bir sürüme güncelleme veya aktif kret raporlama gibi) APEX yönetimi API'leri için CTS testleri çalıştırmak için CtsShimApex bir üzerinde paket /system bölümü.

APEX kıskı doğrulama testi uygulanmasını doğrular CtsShimApex .

ro.apex.updatable gereksinimler

  • Eğer ro.apex.updatable özelliği ayarlandığında true , CtsShimApex APEX paket yönetimi destekleyen tüm cihazlar için gereklidir.

  • Eğer ro.apex.updatable özellik eksik veya ayarlanmazsa, CtsShimApex bir cihazda önceden yüklenmiş için gerekli değildir.

APEX kıskı doğrulama testi uygulanmasını doğrular CtsShimApex .

CtsShim Preinstalls ve ön yüklemeler

Android 11 ile başlayarak, CtsShimApex (inşa iki önceden oluşturulmuş uygulamaları içeren yapı kaynağı manifest'te haricinde herhangi bir kod içermeyen). CTS, ayrıcalıkları ve izinleri test etmek için bu uygulamaları kullanır.

Cihaz (olduğunu APEX paket yönetimi desteklemiyorsa ro.apex.updatable veya cihaz versiyon 10 veya daha düşük çalışıyorsa özellik eksik veya ayarlanmamış), iki önceden oluşturulmuş uygulamalar önceden yüklenmiş olması gerekir sistem ayrı.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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 SİM örnek uygulaması AOSP bulunabilir.

Bkz Güvenlik Unsuru için CTS Testi Açık Mobil API test durumları ve Erişim Kontrolü testi durumları hakkında daha fazla ayrıntılı bilgi için bkz.

Depolama gereksinimleri

CTS medya testler harici depolama (olmak video klipleri gerektiren stres /sdcard ). Kliplerin çoğu gelmektedir Big Buck Bunny altında Blender Vakfı tarafından telif hakkı, Creative Commons Attribution 3.0 lisansı .

Gerekli alan, cihaz tarafından desteklenen maksimum video oynatma çözünürlüğüne bağlıdır. Bölümüne 5 Bkz Android Uyumluluk Tanımı belgenin gerekli kararların platformu versiyonu için.

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 özel dosyası (DF Telecom) ile GSM ve USIM kartları bu gereksinimi karşılamak.

Geliştirici UICC

CTS taşıyıcı API testler için cihaz CTS taşıyıcı ayrıcalıkları belirtilen şartları yerine sahip bir SIM kullanması gerekir UICC hazırlanması .

Android cihaz yapılandırması

  1. Fabrika verilerine cihazı sıfırlamak: Ayarlar> & Yedekleme sıfırlama> Fabrika verilerine sıfırla.

  2. Ayarlar> Dil ve giriş> Dil: İngilizce (ABD) için cihazınızın dilini ayarlayın.

  3. Cihaz destekleri varsayılan yazı tiplerini özelleştirme varsayılan ayar sans-serif yazı tipi ailesini Roboto (varsayılan sans-serif AOSP inşa kullanılan yazı tipi ailesi).

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

  5. Destekler IPv6, izole bir istemci olarak DUT tedavi edebileceğini bir Wi-Fi ağına bağlayın (bkz Fiziksel ortam üzerinde) ve bir internet bağlantısı vardır: Ayarlar> Wi-Fi.

  6. Ayarlar> Güvenlik> Ekran kilidi> Hiçbiri: Emin hiçbir kilit deseni veya şifre cihazda açık olduğundan emin olun.

  7. Ayarlar> Geliştirici seçenekleri> USB hata ayıklama: Cihazınızın USB hata ayıklama etkinleştirme.

  8. 12 saat formatında zamanı ayarlayın: Ayarlar> Tarih ve saat> kullan 24 saat formatı> Kapalı.

  9. Açık> Ayarlar> Geliştirici seçenekleri> Stay Awake: uyanık kalmak için cihazı ayarlayın.

  10. Ayarlar> Geliştirici seçenekleri>> On Sahte konumlara izin ver: yalnızca Android 5.x ve 4.4.x yılında sahte yerleri sağlamak için cihazı ayarlayın.

  11. > Ayarlar> Geliştirici seçenekleri> USB üzerinden Kapalı Uygulamaları doğrulama: Android 4.2 veya daha yüksek olarak, USB Uygulama doğrulama kapatın.

  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 kablosuyla 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 versiyonları 4.2 R4 ile 2.1 R2: ile erişilebilirlik testler Cihazınızı (veya emülatör) kurma abd install -r android-cts/repository/testcases/CtsDelegatingAccessibilityService.apk

      Cihazda, heyet etkinleştirmek: Ayarlar> Erişilebilirlik> Erişilebilirlik> Yetkilendiren Erişilebilirlik Hizmeti.

    • CTS versiyonları 6.x veya düşürmek: declare o cihazlarda android.software.device_admin : kullanarak cihaz yönetimi testi çalıştırmak için cihazınızın kurulumunu adb install -r android-cts/repository/testcases/CtsDeviceAdmin.apk`

      Ayarlar> Güvenlik> Cihaz seçin yöneticileri, iki etkinleştirmek android.deviceadmin.cts.CtsDeviceAdminReceiver* Cihaz yöneticilerini. Emin olun android.deviceadmin.cts.CtsDeviceAdminDeactivatedReceiver ve diğer herhangi bir önceden yüklenmiş cihaz yöneticisi devre dışı kalır.

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

    1. Gezinti ( cd medya dosyalarını indirip fermuarını edilir yoluna).
    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, seri seçeneği (eklemek -s sonuna belirli bir cihazın). Örneğin, seri 1234567 olan cihaza 720x480'e kadar kopyalamak için şunu çalıştırın:

        ./copy_media.sh 720x480 -s 1234567