Google si impegna a promuovere l'equità razziale per le comunità nere. Vedi come.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

Impostazione di CTS

Per eseguire CTS, prepara innanzitutto l'ambiente fisico, il computer desktop e il dispositivo Android che stai utilizzando per i test.

Ambiente fisico

Beacon Bluetooth LE

Se il dispositivo in prova (DUT) supporta Bluetooth LE, posizionare almeno tre beacon Bluetooth LE entro 5 metri dal DUT per il test di scansione Bluetooth LE. Questi beacon non devono essere configurati o emettere nulla di specifico e possono essere di qualsiasi tipo, inclusi iBeacon, Eddystone o persino dispositivi che simulano beacon BLE.

Macchine fotografiche

Quando si esegue la telecamera CTS, utilizzare le normali condizioni di illuminazione con un diagramma di prova (come un motivo a scacchiera). Posizionare il diagramma del modello di prova in base alla distanza minima di messa a fuoco del DUT per assicurarsi che non sia troppo vicino all'obiettivo.

Puntare i sensori della telecamera verso una scena con un'illuminazione sufficiente per consentire ai sensori sottoposti al test di raggiungere e rimanere ai frame target al massimo configurati al secondo (FPS) come specificato in CONTROL_AE_TARGET_FPS_RANGE . Questo vale per tutti i sensori della fotocamera segnalati da getCameraIdList poiché il test getCameraIdList i dispositivi elencati e misura le prestazioni singolarmente.

Se il DUT supporta telecamere esterne, come webcam USB, collegare una telecamera esterna quando si esegue CTS. Altrimenti, i test CTS falliscono.

GPS / GNSS

Se il DUT supporta il sistema di posizionamento globale / sistema di navigazione satellitare globale (GPS / GNSS), fornire un segnale GPS / GNSS al DUT a un livello di segnale adatto per il calcolo della ricezione e della posizione GPS. La parte GPS deve essere conforme a ICD-GPS-200C. Altrimenti, il segnale GPS / GNSS può essere di qualsiasi tipo, incluso un simulatore satellitare o un ripetitore GPS / GNSS di segnali esterni, oppure è possibile posizionare il DUT abbastanza vicino a una finestra in modo che possa ricevere direttamente abbastanza segnale GPS / GNSS.

Wi-Fi e IPv6

I test CTS richiedono una rete Wi-Fi che supporti IPv6, abbia una connessione Internet e possa trattare il DUT come un client isolato. Un client isolato si riferisce a una configurazione in cui il DUT non ha visibilità sui messaggi broadcast / multinetwork su quella sottorete. Ciò si verifica con una configurazione AP Wi-Fi o eseguendo il DUT su una sottorete isolata senza altri dispositivi collegati.

Se non si ha accesso a una rete IPv6 nativa, a una rete di operatore IPv6 o a una VPN per superare alcuni test a seconda di IPv6, è possibile utilizzare un punto di accesso Wi-Fi e un tunnel IPv6. Vedi l' elenco Wikipedia dei broker di tunnel IPv6 .

RTT Wi-Fi

Android include l' API RTT Wi-Fi per una funzionalità Wi-Fi round trip time (RTT) . Ciò consente ai dispositivi di misurare la loro distanza dai punti di accesso con una precisione da 1 a 2 metri, aumentando in modo significativo la precisione della posizione interna. Due dispositivi consigliati che supportano il Wi-Fi RTT sono Google Wifi e il punto di accesso fitlet2 di Compulab (impostato su una larghezza di banda di 40 MHz a 5 GHz).

I punti di accesso devono essere alimentati, ma non richiedono una connessione di rete. Non è necessario che i punti di accesso si trovino accanto al dispositivo di prova, ma si consiglia di trovarsi entro 40 piedi dal DUT. Un punto di accesso è in genere sufficiente.

Installazione della macchina desktop

ADB e AAPT

Prima di eseguire CTS, assicurarsi di aver installato le versioni recenti di Android Debug Bridge (adb) e Android Asset Packaging Tool (AAPT) e di aver aggiunto la posizione di tali strumenti al percorso di sistema del computer.

Per installare ADB, scarica il pacchetto Android SDK Tools per il tuo sistema operativo, aprilo e segui le istruzioni nel file README incluso. Per informazioni sulla risoluzione dei problemi, consultare Installazione degli strumenti SDK autonomi .

Assicurati che adb e aapt siano nel tuo percorso di sistema. Il seguente comando presuppone che tu abbia aperto l'archivio dei pacchetti nella tua home directory:

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

Java Development Kit

Installa la versione corretta di Java Development Kit (JDK). Per Android 7.0 o versioni successive:

Per i dettagli, consultare i requisiti JDK .

File CTS

Scarica e apri i pacchetti CTS dai download della Suite di test di compatibilità corrispondenti alla versione Android dei tuoi dispositivi e a tutte le interfacce binarie dell'applicazione (ABI) supportate dai tuoi dispositivi.

Scarica e apri l'ultima versione dei file multimediali CTS .

Rilevamento del dispositivo

Seguire il passaggio per configurare il sistema per rilevare il dispositivo .

Configurazione del dispositivo Android

Build dell'utente

Un dispositivo compatibile è definito come un dispositivo con una build firmata user / key-release. Sul dispositivo dovrebbe essere in esecuzione un'immagine di sistema basata sulla build dell'utente nota nota (Android 4.0 o versione successiva) da nomi in codice, tag e numeri di build .

Prima proprietà di compilazione a livello di API

Alcuni requisiti CTS dipendono dalla build con cui un dispositivo è stato originariamente spedito. Ad esempio, i dispositivi forniti originariamente con build precedenti potrebbero essere esclusi dai requisiti di sistema che si applicano ai dispositivi forniti con build successive.

Per rendere queste informazioni disponibili per CTS, i produttori di dispositivi avrebbero potuto definire la proprietà build-time ro.product.first_api_level . Il valore di questa proprietà è il primo livello API con cui il dispositivo è stato lanciato commercialmente.

I produttori di dispositivi possono riutilizzare l'implementazione sottostante comune per lanciare un nuovo prodotto come aggiornamento di un prodotto esistente nello stesso gruppo di dispositivi. I produttori di dispositivi possono facoltativamente impostare il livello API del prodotto esistente su ro.product.first_api_level , in modo che vengano applicati i requisiti di aggiornamento per CTS e Treble / VTS.

I produttori di dispositivi possono aggiungere PRODUCT_PROPERTY_OVERRIDES nel loro file device.mk per impostare questa proprietà, come mostrato nell'esempio seguente:

#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

Primo livello API per Android 9 o versioni successive

Per i dispositivi avviati con Android 9 o versioni successive, imposta la proprietà ro.product.first_api_level su un valore valido tra Nome codice, Tag e Numeri di costruzione .

Primo livello API per Android 8.xo inferiore

Per i dispositivi avviati su Android ro.product.first_api_level , ro.product.first_api_level (rimuovi) la proprietà ro.product.first_api_level per la prima build del prodotto. Per tutte le build successive, imposta ro.product.first_api_level sul valore di livello API corretto. Ciò consente alla proprietà di identificare correttamente un nuovo prodotto e conserva le informazioni sul primo livello API del prodotto. Se il flag non è impostato, Android assegna Build.VERSION.SDK_INT a ro.product.first_api_level .

App di shim CTS

Android 7.0 include le seguenti app predefinite (create da questa fonte ), che non contengono alcun codice tranne il manifest:

CTS utilizza queste app per testare privilegi e autorizzazioni. Per superare i test, è necessario precaricare le app nelle directory appropriate sull'immagine di sistema senza firmarle nuovamente.

CTS shim APEX

Android 10 o versioni successive include un formato di pacchetto chiamato APEX . Per scrivere test CTS per le API di gestione APEX (come l'aggiornamento a una nuova versione o il reporting di APEX attivi) è necessario preinstallare un pacchetto CtsShimApex sul dispositivo di destinazione.

CtsShimApex deve essere preinstallato su una partizione /system .

Se la proprietà ro.apex.updatable è impostata su true , CtsShimApex è richiesto per tutti i dispositivi che supportano la gestione dei pacchetti APEX.

Se la proprietà ro.apex.updatable manca o non è impostata, non è necessario preinstallare CtsShimApex su un dispositivo. Il test di validazione shim APEX verifica l'implementazione di CtsShimApex .

Applet di esempio

Android 9 ha introdotto le API Open Mobile. Per i dispositivi che segnalano più di un elemento sicuro, CTS aggiunge casi di test per convalidare il comportamento delle API Open Mobile. Questi casi di test richiedono l'installazione singola di un'applet di esempio nell'elemento Secure Secure (eSE) incorporato del DUT o nella scheda SIM utilizzata dal DUT. L' applet di esempio eSE e l' applet di esempio SIM sono disponibili in AOSP.

Vedere Test CTS per Secure Element per informazioni più dettagliate sui casi di test Open Mobile API e sui casi di controllo Access Control.

Requisiti di conservazione

Gli stress test sui supporti CTS richiedono che i videoclip si /sdcard su una memoria esterna ( /sdcard ). La maggior parte delle clip proviene da Big Buck Bunny , protetto da copyright della Blender Foundation sotto la licenza Creative Commons Attribution 3.0 .

Lo spazio richiesto dipende dalla massima risoluzione di riproduzione video supportata dal dispositivo. Vedere la sezione 5 nel documento Definizione di compatibilità Android per la versione della piattaforma delle risoluzioni richieste).

Si noti che le funzionalità di riproduzione video del DUT sono controllate tramite le API android.media.CamcorderProfile per le versioni precedenti di Android e le API android.media.MediaCodecInfo.CodecCapabilities da Android 5.0.

Ecco i requisiti di archiviazione per la massima risoluzione di riproduzione video:

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

Schermo e memoria

  • Qualsiasi dispositivo che non ha uno schermo incorporato deve essere collegato a uno schermo.
  • Se il dispositivo ha uno slot per scheda di memoria, collegare una scheda SD vuota. Utilizzare una scheda SD che supporti bus ad altissima velocità (UHS) con capacità SDHC o SDXC o una con almeno la classe di velocità 10 o superiore per assicurarsi che possa passare il CTS.
  • Se il dispositivo dispone di slot per schede SIM, collegare una scheda SIM attivata in ciascuno slot. Se il dispositivo supporta SMS, ogni scheda SIM dovrebbe avere il proprio campo numerico popolato.

Sviluppatore UICC

Per eseguire i test API del gestore telefonico CTS, il dispositivo deve disporre di una scheda SIM con regole di privilegio del gestore telefonico. Vedi Preparazione dell'UICC .

Configurazione del dispositivo Android

  1. I dati di fabbrica ripristinano il dispositivo: Impostazioni> Backup e ripristino> Ripristino dati di fabbrica .
  2. Imposta la lingua del dispositivo su Inglese ( Stati Uniti ): Impostazioni> Lingua e input> Lingua .
  3. Attiva l'impostazione della posizione se sul dispositivo è presente una funzione GPS o Wi-Fi / rete cellulare: Impostazioni> Posizione> Attiva.
  4. Connettiti a una rete Wi-Fi che supporta IPv6, può trattare il DUT come un client isolato (vedi Ambiente fisico sopra) e ha una connessione Internet: Impostazioni> Wi-Fi .
  5. Assicurati che sul dispositivo non sia impostato alcun tipo di blocco o password: Impostazioni> Sicurezza> Blocco schermo> Nessuno .
  6. Abilita il debug USB sul tuo dispositivo: Impostazioni> Opzioni sviluppatore> Debug USB .
  7. Impostare l'ora sul formato 12 ore: Impostazioni> Data e ora> Usa formato 24 ore> Disattivo .
  8. Imposta il dispositivo per rimanere sveglio: Impostazioni> Opzioni sviluppatore> Resta sveglio> Attivato .
  9. Solo in Android 5.xe 4.4.x , imposta il dispositivo per consentire posizioni fittizie: Impostazioni> Opzioni sviluppatore> Consenti posizioni fittizie> Attivato .
  10. In Android 4.2 o versioni successive , disattiva la verifica dell'app USB: Impostazioni> Opzioni sviluppatore> Verifica app su USB> Disattivo .
  11. Avviare il browser e chiudere qualsiasi schermata di avvio / configurazione.
  12. Collegare la macchina desktop che verrà utilizzata per testare il dispositivo con un cavo USB.

Installazione del file

Installa e configura le app di supporto sul dispositivo.

  1. Configura il tuo dispositivo in base alla tua versione CTS:
    • CTS versioni da 2.1 R2 a 4.2 R4: configura il tuo dispositivo (o emulatore) per eseguire i test di accessibilità con:
      abd install -r android-cts/repository/testcases/CtsDelegatingAccessibilityService.apk

      Sul dispositivo, abilitare la delega: Impostazioni> Accessibilità> Accessibilità> Delega del servizio di accessibilità .
    • CTS versione 6.xo precedente: sui dispositivi che dichiarano android.software.device_admin , configura il tuo dispositivo per eseguire il test di amministrazione del dispositivo usando:
      adb install -r android-cts/repository/testcases/CtsDeviceAdmin.apk

      In Impostazioni> Sicurezza> Seleziona amministratori dispositivo , abilita i due amministratori dispositivo android.deviceadmin.cts.CtsDeviceAdminReceiver* . Assicurati che android.deviceadmin.cts.CtsDeviceAdminDeactivatedReceiver e tutti gli altri amministratori di dispositivi precaricati rimangano disabilitati.
  2. Copia i file multimediali CTS sul dispositivo come segue:
    1. Passare ( cd ) al percorso in cui i file multimediali vengono scaricati e decompressi.
    2. Modifica le autorizzazioni del file:
      chmod u+x copy_media.sh
    3. Copia i file necessari:
      • Per copiare clip fino a una risoluzione di 720x480, eseguire:
        ./copy_media.sh 720x480
      • Se non sei sicuro della risoluzione massima, copia tutti i file:
        ./copy_media.sh all
      • Se ci sono più dispositivi sotto adb, aggiungi alla fine l'opzione seriale ( -s ) di un dispositivo specifico. Ad esempio, per copiare fino a 720x480 sul dispositivo con seriale 1234567, eseguire:
        ./copy_media.sh 720x480 -s 1234567