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
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ı
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,
CtsShimApexAPEX paket yönetimi destekleyen tüm cihazlar için gereklidir.
Eğer
ro.apex.updatableözellik eksik veya ayarlanmazsa,
CtsShimApexbir 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
| android12-x86 sürümü|
altında
| android12-kol-CtsShim.apk|
altında
android12-arm-CtsShimPriv.apk
| android12-x86-CtsShim.apk|
altında
android12-x86-CtsShimPriv.apk
|Android 11|| android11-kol bırakma|
altında
| android11-x86 sürümü|
altında
| android11-arm-CtsShim.apk|
altında
android11-arm-CtsShimPriv.apk
| android11-x86-CtsShim.apk|
altında
android11-x86-CtsShimPriv.apk
|Android 10|| android10 sürümü|
altında
| android10-arm-CtsShim.apk|
altında
android10-arm-CtsShimPriv.apk
| android10-x86-CtsShim.apk|
altında
android10-x86-CtsShimPriv.apk
|Android 9, O ve O-MR1||Yok||Yok|| arm-CtsShim.apk|
altında
arm-CtsShimPriv.apk
| x86-CtsShim.apk|
altında
x86-CtsShimPriv.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ı
Fabrika verilerine cihazı sıfırlamak: Ayarlar> & Yedekleme sıfırlama> Fabrika verilerine sıfırla.
Ayarlar> Dil ve giriş> Dil: İngilizce (ABD) için cihazınızın dilini ayarlayın.
Cihaz destekleri varsayılan yazı tiplerini özelleştirme varsayılan ayar
sans-serifyazı tipi ailesini
Roboto(varsayılan
sans-serifAOSP inşa kullanılan yazı tipi ailesi).
Ayarlar> Konum> Açık: cihazda GPS veya Wi-Fi / hücresel ağ özellik varsa konum ayarını açın.
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.
Ayarlar> Güvenlik> Ekran kilidi> Hiçbiri: Emin hiçbir kilit deseni veya şifre cihazda açık olduğundan emin olun.
Ayarlar> Geliştirici seçenekleri> USB hata ayıklama: Cihazınızın USB hata ayıklama etkinleştirme.
12 saat formatında zamanı ayarlayın: Ayarlar> Tarih ve saat> kullan 24 saat formatı> Kapalı.
Açık> Ayarlar> Geliştirici seçenekleri> Stay Awake: uyanık kalmak için cihazı ayarlayın.
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.
> 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.
Tarayıcıyı başlatın ve herhangi bir başlangıç/kurulum ekranını kapatın.
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.
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.CtsDeviceAdminDeactivatedReceiverve diğer herhangi bir önceden yüklenmiş cihaz yöneticisi devre dışı kalır.
CTS medya dosyalarını aşağıdaki gibi cihaza kopyalayın:
- Gezinti (
cdmedya dosyalarını indirip fermuarını edilir yoluna).
Dosya izinlerini değiştirin:
chmod u+x copy_media.sh
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
-ssonuna 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
- Gezinti (