A partire dal 2026, per allinearci al nostro modello di sviluppo stabile del trunk e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per la creazione e il contributo ad AOSP, consigliamo di utilizzare android-latest-release anziché aosp-main. Il ramo del manifest android-latest-release farà sempre riferimento alla release più recente inviata ad AOSP. Per saperne di più, vedi Modifiche ad AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Esegui test CTS-V

Lo strumento di verifica della suite di test di compatibilità Android (CTS Verifier) integra la suite di test di compatibilità (CTS). Mentre CTS controlla le API e le funzioni che possono essere automatizzate, CTS Verifier fornisce test per le API e le funzioni che non possono essere testate su un dispositivo fisso senza input o posizionamento manuale, come la qualità audio, il touchscreen, l'accelerometro e la fotocamera.

Requisiti

Prima di eseguire CTS Verifier, assicurati di disporre della seguente attrezzatura:

Dispositivo con Android che ha verificato la compatibilità con le API Android superando CTS. Questo è il dispositivo in fase di test (DUT).
Computer Linux con porta compatibile con USB 2.0. Tutte le connessioni al DUT passano attraverso questa porta.
Secondo dispositivo con Android con un'implementazione nota e compatibile di Bluetooth, Wi-Fi Direct, Wi-Fi Aware, UWB (se il DUT supporta UWB) ed emulazione della scheda host NFC (HCE).
Un router Wi-Fi configurato con nome e password del punto di accesso. Il router deve essere in grado di disconnettersi da internet senza essere spento.

Assicurati di preparare anche i treppiedi, i supporti per dispositivi e le distanze pre-misurate necessarie per i test di misurazione della distanza (prossimità) per UWB, Wi-Fi NAN e Bluetooth RSSI. Per maggiori dettagli, consulta Calibrazione della presenza.

Requisiti UICC per i test NFC

CTS Verifier ha i seguenti casi di test NFC:

Field-off (utilizza i dati delle transazioni da 0x54)
De-select (utilizza i dati delle transazioni da 0x52)
Comando HCI (0025000000) (utilizza i dati delle transazioni da 0x02)

I test degli eventi di transazione richiedono due dispositivi, uno dei quali deve avere SecureElement UICC con le seguenti regole di accesso:

Hash APK di CtsVerifier: 61:ED:37:7E:85:D3:86:A8:DF:EE:6B:86:4B:D8:5B:0B:FA:A5:AF:81
Identificatore dell'applicazione autorizzata (AID) per l'accesso agli eventi NFC: 0xA000000476416E64726F696443545341

Sul lato dell'emulatore, prevediamo che l'evento di transazione porti l'attività corrispondente in primo piano.

Configurazione

Modifica la modalità di navigazione del sistema del dispositivo di test in modalità con tre pulsanti come segue:

quindi apri Impostazioni.
Vai a Sistema > Gesti > Navigazione del sistema.
Se disponibile, seleziona una modalità di navigazione basata su pulsanti, preferibilmente la modalità con tre pulsanti.

Per configurare l'ambiente di test di CTS Verifier:

Sul computer Linux:
1. Esegui il comando seguente prima di installare CTS Verifier per consentire l'accesso alle interfacce non SDK.
```
adb shell settings put global hidden_api_policy 1
```
1. Installa Android Studio.
2. Scarica l'APK di CTS Verifier per la versione di Android da testare.
Collega il DUT al computer Linux.
Da un terminale sul computer Linux, installa CtsVerifier.apk sul DUT:
```
adb install -r -g CtsVerifier.apk
```
Per Android 10 e versioni successive, esegui il comando seguente per concedere all'app l'autorizzazione a creare il report:
```
adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
```
Per Android 11 e versioni successive, esegui il comando seguente per consentire il salvataggio dei report in una directory auto-definita nella directory di primo livello esterna del dispositivo:
```
adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
```
Per Android 13 e versioni successive, esegui il comando seguente per consentire l'accesso all'API di test per CTS Verifier:
```
adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
```
Per Android 14 e versioni successive, esegui il comando seguente per concedere all'app l'autorizzazione ad accendere lo schermo:
```
adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0
```
Verifica che la data e l'ora del sistema del DUT siano impostate correttamente.

Esegui CTS Verifier

Avvia l'app CTS Verifier toccando l'icona CTS Verifier sul DUT.

Figura 1. Icona di CTS Verifier.

L'app mostra diversi set di test disponibili per la verifica manuale.

Figura 2. Menu dei test di CTS Verifier.

Ogni test contiene un insieme di elementi comuni nella parte inferiore dello schermo.

Verificatore della qualità dello streaming video

Figura 3. Schermata di test con elementi di test comuni evidenziati.

Superato (✓). Tocca se il DUT soddisfa i requisiti di test in base alle istruzioni di Informazioni.
Informazioni (?). Tocca per visualizzare le istruzioni di test. Viene visualizzato automaticamente anche la prima volta che viene aperto un test.
Non superato (!). Tocca se il DUT non soddisfa i requisiti di test in base alle istruzioni di Informazioni.

Alcuni test, come la modalità accessorio USB e il test di calibrazione della fotocamera, richiedono una configurazione e istruzioni di test aggiuntive, come descritto nelle sezioni seguenti.

Test della modalità accessorio USB per 8.0 e versioni successive

Test dell'accessorio USB di CTS Verifier

Figura 4. Procedura di test degli accessori USB per 8.0 e versioni successive.

Test dell'accessorio USB di CTS Verifier

Figura 5. Test della modalità accessorio USB per 8.0 e versioni successive.

Test della modalità accessorio USB per 7.x e versioni precedenti

Il test dell'accessorio USB richiede un computer Linux per eseguire il programma della macchina desktop USB (host).

Collega il DUT al computer Linux.
Sul computer, esegui il programma cts-usb-accessory dal pacchetto CTS Verifier:
```
./cts-usb-accessory
```
Attendi che venga visualizzata una finestra di dialogo sul DUT, quindi tocca OK.

Figura 6. Test dell'accessorio USB
Vai al test dell'accessorio USB nell'applicazione CTS Verifier sul DUT.

Sul computer, esamina l'output della console. Output di esempio:

CTS USB Accessory Tester
Found possible Android device (413c:2106) - attempting to switch to accessory
mode...
Failed to read protocol versionfigure3
Found Android device in accessory mode (18d1:2d01)...
[RECV] Message from Android device #0
[SENT] Message from Android accessory #0
[RECV] Message from Android device #1
[SENT] Message from Android accessory #1
[RECV] Message from Android device #2
[SENT] Message from Android accessory #2
[RECV] Message from Android device #3
[SENT] Message from Android accessory #3
[RECV] Message from Android device #4
[SENT] Message from Android accessory #4
[RECV] Message from Android device #5
[SENT] Message from Android accessory #5
[RECV] Message from Android device #6
[SENT] Message from Android accessory #6
[RECV] Message from Android device #7
[SENT] Message from Android accessory #7
[RECV] Message from Android device #8
[SENT] Message from Android accessory #8
[RECV] Message from Android device #9
[SENT] Message from Android accessory #9
[RECV] Message from Android device #10
[SENT] Message from Android accessory #10

Calibra il campo visivo della fotocamera

Utilizza la procedura di calibrazione del campo visivo per determinare rapidamente il campo visivo del dispositivo con una precisione moderata.

Configura l'ambiente di test:
1. Stampa il file PDF del target del pattern di calibrazione su carta di dimensioni 11" x 17" o A3.
2. Monta il pattern stampato su un supporto rigido.
3. Orienta il dispositivo della fotocamera e il target stampato come mostrato nel seguente diagramma:
  
  Figura 7. Target stampato della fotocamera.
Imposta la larghezza del target:
1. Misura la distanza (in centimetri) tra le linee continue sul pattern del target per tenere conto delle imprecisioni di stampa (~38 cm).
2. Avvia l'applicazione di calibrazione.
3. Premi il pulsante di configurazione e seleziona Distanza indicatore.
4. Misura e inserisci la distanza dal pattern del target (~100 cm).
5. Premi il pulsante Indietro per tornare all'anteprima della calibrazione.
Verifica che il dispositivo e il target siano posizionati come mostrato nella figura e che le distanze corrette siano state inserite nella finestra di dialogo di configurazione. L'anteprima mostra l'immagine con una linea verticale sovrapposta; questa linea deve essere allineata alla linea centrale del pattern del target. La griglia trasparente può essere utilizzata con le altre linee verticali per verificare che l'asse ottico sia ortogonale al target.
Esegui il test di calibrazione:
1. Seleziona una risoluzione dell'immagine (utilizzando il selettore in basso a sinistra), quindi tocca lo schermo per scattare una foto. Il test entra in modalità di calibrazione e visualizza la foto con due linee verticali sovrapposte all'immagine.
2. Determina l'accuratezza:
3. Se le linee sono allineate alle linee verticali sul pattern del target entro pochi centimetri, il campo visivo segnalato per la risoluzione selezionata è accurato.
4. Se le linee non sono allineate, il campo visivo segnalato non è accurato. Per correggere questo problema, regola il dispositivo di scorrimento nella parte inferiore dello schermo finché la sovrapposizione non è allineata il più possibile al pattern del target. Quando la sovrapposizione e l'immagine del pattern del target sono allineate, il campo visivo visualizzato è un'approssimazione precisa del valore corretto. Il campo visivo segnalato deve rientrare in un intervallo di 3 gradi rispetto al valore di calibrazione.
5. Premi il pulsante Indietro e ripeti il test di calibrazione per tutte le risoluzioni delle immagini supportate dal DUT.

Esegui CTS Verifier per le modalità alternative

A partire dalle release CTS 10 R6 e CTS 11 R2, CTS Verifier supporta i test necessari per i dispositivi con modalità alternative o per i dispositivi con più di una modalità schermo.

Nella parte superiore della visualizzazione dell'elenco principale in CTS Verifier viene visualizzato un pulsante che consente agli utenti di alternare la modalità di visualizzazione aperta e chiusa. CTS Verifier mostrerà i test necessari per la modalità di visualizzazione selezionata. Per eseguire le modalità alternative in CTS Verifier, è necessario impostare il pulsante sulla modalità di visualizzazione appropriata ed eseguire l'elenco dei test visualizzati.

Interruttore a levetta CTS-V

Figura 8. Attiva/disattiva di CTS Verifier.

I risultati dei test chiusi verranno registrati nello stesso report dei test aperti. Per identificare ogni risultato del test dal test set, viene aggiunto un suffisso a ogni nome del test in modalità chiusa.

<Test result="fail" name="com.android.cts.verifier.deskclock.DeskClockTestsActivity[folded]">
  <RunHistory subtest="CREATE_ALARM[folded]">
    <Run start="1594176663973" end="1594176665841" isAutomated="false" />
  </RunHistory>
</Test>

Esporta risultati

Al termine di tutti i test, puoi salvare i risultati come report e scaricarli su un computer. I nomi dei report vengono contrassegnati automaticamente con l'ora in base all'ora di sistema del DUT.

Per salvare i risultati dei test, tocca l'icona di salvataggio (disco) nella parte superiore dell'elenco delle categorie di test.

Nota: Android 7.0 e versioni successive non includono la funzionalità di anteprima.
Attendi che venga visualizzata una finestra di dialogo che mostra il percorso del report salvato (ad esempio /sdcard/verifierReports/ctsVerifierReport-date-time.zip), quindi annota il percorso.
Collega il DUT al computer Linux.

Dall'installazione di SDK Android sul computer Linux, scarica i report dal dispositivo connesso utilizzando adb shell content read o adb pull CTSVerifierReportPath.

Per Android 7.x e versioni successive, scarica tutti i report utilizzando il comando seguente:
```
adb pull /sdcard/verifierReports
```
Per Android 6.0 e versioni precedenti, scarica tutti i report utilizzando il comando seguente:
```
adb pull /mnt/sdcard/ctsVerifierReports/
```

Per Android 10 e versioni successive, implementando Automotive e i dispositivi in esecuzione come utente secondario, scarica l'ultimo report utilizzando il comando seguente:

adb shell content read --user <var>CURRENT_USER</var> --uri content://com.android.cts.verifier.testresultsprovider/reports/latest > report.zip

Per elencare tutti i report disponibili nel dispositivo connesso:

  adb shell content query --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports
  ```

To download a report from the list, you can specify the Row ID or
filename. For example:

```shell
  adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports/0 > report.zip
  ```

```shell
  adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports ctsVerifierReport-date-time.zip > report.zip
  ```

Per cancellare i risultati superati o non superati, seleziona i risultati nell'app CTS Verifier e seleziona Menu > Cancella.