DispositivoITest

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

Fornisce un'API affidabile e di livello leggermente superiore a ddmlib IDevice.

Esegue nuovamente i comandi del dispositivo per un numero di volte configurabile e fornisce un'interfaccia di recupero del dispositivo per i dispositivi che non rispondono.

Riepilogo

Classi nidificate

class ITestDevice.ApexInfo

Una semplice classe struct per memorizzare informazioni su un singolo APEX 

class ITestDevice.MountPointInfo

Una semplice classe struct per memorizzare informazioni su un singolo punto di montaggio 

Metodi pubblici

abstract boolean canSwitchToHeadlessSystemUser()

Indica se è consentito passare all'utente SYSTEM headless.

abstract boolean checkConnectivity()

Verifica la connettività di rete del dispositivo.

abstract boolean clearErrorDialogs()

Prova a chiudere le eventuali finestre di dialogo di errore attualmente visualizzate nell'interfaccia utente del dispositivo.

abstract void clearLastConnectedWifiNetwork()

Cancella l'ultima rete Wi-Fi connessa.

abstract boolean connectToWifiNetwork( wifiSsidToPsk)

Si connette a una rete Wi-Fi.

abstract boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

Si connette a una rete Wi-Fi.

abstract boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

Si connette a una rete Wi-Fi.

abstract boolean connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)

Si connette a una rete Wi-Fi.

abstract boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)

Una variante di connectToWifiNetwork(String, String) che si connette solo se il dispositivo attualmente non ha connettività di rete.

abstract boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

Una variante di connectToWifiNetwork(String, String) che si connette solo se il dispositivo attualmente non ha connettività di rete.

abstract int createUser(String name)

Crea un utente con un determinato nome e flag predefiniti pari a 0.

abstract int createUser(String name, boolean guest, boolean ephemeral)

Crea un utente con un determinato nome e i flag forniti

abstract int createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)

Crea un utente con un nome e gli indicatori specificati

abstract int createUserNoThrow(String name)

Crea un utente con un nome e flag predefiniti pari a 0.

abstract void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Rimuove il IDeviceActionReceiver registrato.

abstract void disableKeyguard()

Tenta di disattivare la tastiera.

abstract boolean disableNetworkMonitor()

Disattiva il monitoraggio della rete sul dispositivo.

abstract boolean disconnectFromWifi()

Si disconnette da una rete Wi-Fi.

abstract boolean doesFileExist(String deviceFilePath, int userId)

Metodo di supporto per determinare se il file sul dispositivo esiste per un determinato utente.

abstract File dumpHeap(String process, String devicePath)

Prova a eseguire il dump dell'heap da system_server.

abstract boolean enableNetworkMonitor()

Attiva il monitoraggio della rete sul dispositivo.

abstract getActiveApexes()

Recupera le informazioni sugli APEX attivati sul dispositivo.

abstract getAllSettings(String namespace)

Restituisce le coppie chiave-valore dello spazio dei nomi richiesto.

abstract String getAndroidId(int userId)

Trova e restituisce l'android-id associato a un userId, null se non trovato.

abstract getAndroidIds()

Crea una mappa degli ID Android trovati corrispondenti agli ID utente.

abstract PackageInfo getAppPackageInfo(String packageName)

Recupera le informazioni su un pacchetto installato sul dispositivo.

abstract getAppPackageInfos()

Recupera le informazioni sui pacchetti installati sul dispositivo.

abstract InputStreamSource getBugreport()

Recupera una segnalazione di bug dal dispositivo.

abstract InputStreamSource getBugreportz()

Recupera un bugreportz dal dispositivo.

abstract DeviceFoldableState getCurrentFoldableState()

Restituisce lo stato attuale del dispositivo pieghevole o null se si sono verificati problemi.

abstract int getCurrentUser()

Restituisce l'ID dell'utente corrente in esecuzione.

abstract getFoldableStates()

Restituisce l'elenco degli stati del dispositivo pieghevole.

abstract getInstalledPackageNames()

Recupera i nomi dei pacchetti delle applicazioni presenti sul dispositivo.

abstract String getIpAddress()

Recupera l'indirizzo IP del dispositivo.

abstract KeyguardControllerState getKeyguardState()

Restituisce un oggetto per ottenere lo stato corrente della tastiera protetta o null se non supportato.

abstract Integer getMainUserId()

Restituisce l'ID utente principale.

abstract getMainlineModuleInfo()

Visualizza le informazioni sui moduli principali installati sul dispositivo.

abstract int getMaxNumberOfRunningUsersSupported()

Ottieni il numero massimo di utenti supportati in esecuzione contemporaneamente.

abstract int getMaxNumberOfUsersSupported()

Visualizza il numero massimo di utenti supportati.

abstract TestDeviceOptions getOptions()

Recupera le opzioni di test per il dispositivo.

abstract Integer getPrimaryUserId()

Restituisce l'ID utente principale.

abstract InputStreamSource getScreenshot(String format, boolean rescale)

Acquisisce uno screenshot dal dispositivo.

abstract InputStreamSource getScreenshot(long displayId)

Acquisisce uno screenshot del dispositivo a cui è stato assegnato l'ID istanza.

abstract InputStreamSource getScreenshot(String format)

Acquisisce uno screenshot dal dispositivo.

abstract InputStreamSource getScreenshot()

Acquisisce uno screenshot dal dispositivo.

abstract String getSetting(int userId, String namespace, String key)

Restituisce il valore dell'impostazione richiesta.

abstract String getSetting(String namespace, String key)

Vedi getSetting(int, String, String) e eseguita sull'utente di sistema.

abstract getUninstallablePackageNames()

Recupera i nomi dei pacchetti di applicazioni che possono essere disinstallati.

abstract int getUserFlags(int userId)

Trova e restituisci gli indicatori di un determinato utente.

abstract getUserInfos()

Recupera la mappa di useId a UserInfo sul dispositivo.

abstract int getUserSerialNumber(int userId)

Restituisce il numero di serie associato a userId, se trovato, -10000 in tutti gli altri casi.

abstract boolean hasFeature(String feature)

Controllare se una funzionalità è disponibile su un dispositivo.

abstract String installPackage(File packageFile, boolean reinstall, String... extraArgs)

Installa un pacchetto Android sul dispositivo.

abstract String installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)

Installa un pacchetto Android sul dispositivo.

abstract String installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)

Installa un pacchetto Android sul dispositivo per un determinato utente.

abstract String installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

Installa un pacchetto Android sul dispositivo per un determinato utente.

default String installPackages( packageFiles, boolean reinstall, String... extraArgs)

Installa un'applicazione Android composta da diversi file APK (un pacchetto di suddivisione principale e uno aggiuntivo).

default String installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)

Installa un'applicazione Android composta da diversi file APK (un pacchetto principale e pacchetti suddivisi extra) che si trovano sul dispositivo Android.

default String installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)

Installa un'applicazione Android composta da diversi file APK (un pacchetto principale e pacchetti suddivisi extra) per un determinato utente.

default String installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

Installa un'applicazione Android composta da diversi file APK (un pacchetto principale e pacchetti suddivisi extra) per un determinato utente.

default String installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs)

Installa un'applicazione Android composta da diversi file APK (un pacchetto di suddivisione principale e uno aggiuntivo) presenti sul dispositivo Android.

default String installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)

Installa un'applicazione Android composta da diversi file APK (un pacchetto principale e pacchetti suddivisi extra) che si trovano sul dispositivo Android.

abstract boolean isHeadlessSystemUserMode()

Restituisce se il dispositivo utilizza la modalità utente di sistema headless.

abstract boolean isMainUserPermanentAdmin()

Restituisce se l'utente principale è un amministratore permanente e non può essere eliminato o sottoposto a downgrade allo stato di utente non amministratore.

abstract boolean isMultiUserSupported()

Determina se la funzionalità multiutente è supportata.

abstract boolean isPackageInstalled(String packageName, String userId)

Esegui una query sul dispositivo per un determinato nome del pacchetto e un determinato ID utente per verificare se è attualmente installato o meno per quell'utente.

abstract boolean isPackageInstalled(String packageName)

Esegui una query sul dispositivo per un determinato nome del pacchetto per verificare se è attualmente installato o meno.

abstract boolean isUserRunning(int userId)

Verifica se un determinato utente è in esecuzione.

abstract boolean isUserSecondary(int userId)

Restituisce se l'utente specificato è un utente secondario in base ai relativi flag.

abstract boolean isUserVisible(int userId)

Controlla se l'utente specificato è visibile.

abstract boolean isUserVisibleOnDisplay(int userId, int displayId)

Controlla se l'utente specificato è visibile nella visualizzazione specificata.

abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

Indica se il dispositivo consente agli utenti di essere avviati visibili in background in ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

abstract boolean isVisibleBackgroundUsersSupported()

Restituisce se il dispositivo consente agli utenti di essere avviati in background.

abstract boolean isWifiEnabled()

Verifica che il Wi-Fi sia attivo.

abstract listDisplayIds()

Raccogli l'elenco degli ID dei display disponibili sul dispositivo segnalato da "dumpsys SurfaceFlinger".

abstract listDisplayIdsForStartingVisibleBackgroundUsers()

Recupera l'elenco di display che possono essere utilizzati per start a user visible in the background.

abstract listUsers()

Recupera l'elenco degli utenti sul dispositivo.

abstract boolean logBugreport(String dataName, ITestLogger listener)

Metodo di supporto per inviare una segnalazione di bug e registrarla agli autori di segnalazioni.

default void notifySnapuserd(SnapuserdWaitPhase waitPhase)

Comunica al dispositivo di attendere il completamento di snapuserd.

abstract void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Registra un IDeviceActionReceiver per questo dispositivo.

abstract boolean removeAdmin(String componentName, int userId)

Rimuovi l'amministratore del dispositivo specificato nell'utente specificato e restituisci true se l'operazione ha esito positivo, false altrimenti.

abstract void removeOwners()

Rimuovi tutti i proprietari di profili dei dispositivi esistenti nel modo più semplice possibile.

abstract boolean removeUser(int userId)

Rimuovere un determinato utente dal dispositivo.

abstract boolean setDeviceOwner(String componentName, int userId)

Imposta un componente di amministrazione del dispositivo come proprietario del dispositivo in un determinato utente.

abstract void setSetting(String namespace, String key, String value)

Vedi setSetting(int, String, String, String) e eseguita sull'utente di sistema.

abstract void setSetting(int userId, String namespace, String key, String value)

Aggiungi un valore di impostazione allo spazio dei nomi di un determinato utente.

abstract boolean startUser(int userId)

Avvia un determinato utente in background se è attualmente fermo.

abstract boolean startUser(int userId, boolean waitFlag)

Avvia un determinato utente in background se è attualmente fermo.

abstract boolean startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)

Avvia un determinato utente in background, visibile nella visualizzazione in questione (ovvero consente all'utente di avviare attività in quella visualizzazione).

abstract boolean stopUser(int userId)

Interrompe un determinato utente.

abstract boolean stopUser(int userId, boolean waitFlag, boolean forceFlag)

Interrompere un determinato utente.

abstract boolean switchUser(int userId)

Passa a un altro userId con un timeout predefinito.

abstract boolean switchUser(int userId, long timeout)

Passa a un altro userId con il timeout specificato come scadenza.

abstract Bugreport takeBugreport()

Prende un report di bug e lo restituisce all'interno di un oggetto Bugreport per gestirlo.

abstract String uninstallPackage(String packageName)

Disinstallare un pacchetto Android dal dispositivo.

abstract String uninstallPackageForUser(String packageName, int userId)

Disinstalla un pacchetto Android dal dispositivo per un determinato utente.

default void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

Se previsto, attendi il completamento dello snapshot.

Metodi pubblici

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

Indica se è consentito passare all'utente SYSTEM headless.

Ritorni
boolean

Lanci
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity ()

Verifica la connettività di rete del dispositivo.

Ritorni
boolean true se il dispositivo ha una connessione di rete funzionante, false in eccesso.
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere ritrovata.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

Prova a chiudere le eventuali finestre di dialogo di errore attualmente visualizzate nell'interfaccia utente del dispositivo.

Ritorni
boolean true se non sono presenti finestre di dialogo o se queste sono state chiuse correttamente. false in caso contrario.
Lanci
DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

Cancella l'ultima rete Wi-Fi connessa. Questo metodo deve essere chiamato all'avvio di una nuova chiamata per evitare di connettersi alla rete Wi-Fi utilizzata nel test precedente dopo il riavvio del dispositivo.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Si connette a una rete Wi-Fi.

Attiva il Wi-Fi e si blocca fino a quando non viene stabilita una connessione con una delle reti Wi-Fi indicate nella mappa wifiSsidToPsk. Una volta stabilita la connessione, l'istanza tenterà di ripristinarla dopo ogni riavvio finché non viene chiamata ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork().

Parametri
wifiSsidToPsk : una mappa degli SSID Wi-Fi con le relative password.
Ritorni
boolean true se la connessione alla rete Wi-Fi è andata a buon fine. false altrimenti
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Si connette a una rete Wi-Fi.

Attiva il Wi-Fi e si blocca fino a quando non viene stabilita una connessione con una delle reti Wi-Fi indicate nella mappa wifiSsidToPsk. Una volta stabilita una connessione, l'istanza tenterà di ripristinare la connessione dopo ogni riavvio fino alla chiamata di ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork().

Parametri
wifiSsidToPsk : una mappa degli SSID Wi-Fi con le relative password.
scanSsid boolean: indica se cercare SSID nascosti per questa rete.
Ritorni
boolean true se la connessione alla rete Wi-Fi è andata a buon fine. false altrimenti
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Si connette a una rete Wi-Fi.

Attiva il Wi-Fi e si blocca fino a quando non viene stabilita una connessione alla rete Wi-Fi specificata. Una volta stabilita la connessione, l'istanza tenterà di ripristinarla dopo ogni riavvio fino a quando non viene chiamata ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork().

Parametri
wifiSsid String: l'SSID del Wi-Fi a cui connettersi
wifiPsk String: passphrase PSK o null se non criptata
Ritorni
boolean true se la connessione alla rete Wi-Fi è andata a buon fine. false altrimenti
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

connettitiaallareteWifi

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Si connette a una rete Wi-Fi.

Attiva il Wi-Fi e si blocca fino a quando non viene stabilita una connessione alla rete Wi-Fi specificata. Una volta stabilita la connessione, l'istanza tenterà di ripristinarla dopo ogni riavvio fino a quando non viene chiamata ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork().

Parametri
wifiSsid String: l'SSID del Wi-Fi a cui connettersi
wifiPsk String: passphrase PSK o null se non criptata
scanSsid boolean: indica se cercare SSID nascosti per questa rete.
Ritorni
boolean true se la connessione alla rete Wi-Fi è andata a buon fine. false altrimenti
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Una variante di connectToWifiNetwork(String, String) che si connette solo se il dispositivo attualmente non ha connettività di rete.

Parametri
scanSsid boolean: indica se cercare SSID nascosti per questa rete
Ritorni
boolean true se la connessione alla rete Wi-Fi è andata a buon fine. false altrimenti
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connettitiallareteWifiIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Una variante di connectToWifiNetwork(String, String) che si connette solo se il dispositivo attualmente non ha connettività di rete.

Ritorni
boolean true se la connessione alla rete Wi-Fi è andata a buon fine. false altrimenti
Lanci
com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

createUser

public abstract int createUser (String name)

Crea un utente con un determinato nome e flag predefiniti pari a 0.

Parametri
name String: dell'utente da creare sul dispositivo
Ritorni
int l'intero per l'ID utente creato
Lanci
com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

createUser

public abstract int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

Crea un utente con un nome e gli indicatori specificati

Parametri
name String: dell'utente da creare sul dispositivo
guest boolean: abilita il flag utente --guest durante la creazione
ephemeral boolean: attiva il flag utente --ephemeral durante la creazione
Ritorni
int ID dell'utente creato
Lanci
com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

createUser

public abstract int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

Crea un utente con un nome e gli indicatori specificati

Parametri
name String: dell'utente da creare sul dispositivo
guest boolean: abilita il flag utente --guest durante la creazione
ephemeral boolean: abilita il flag utente --temporaneo durante la creazione
forTesting boolean: attiva il flag di test --for-testing durante la creazione
Ritorni
int ID dell'utente creato
Lanci
com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

Crea un utente con un nome e flag predefiniti pari a 0.

Parametri
name String: dell'utente da creare sul dispositivo
Ritorni
int L'intero per l'ID utente creato o -1 per errore.
Lanci
com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Rimuove la registrazione di IDeviceActionReceiver.

Parametri
deviceActionReceiver IDeviceActionReceiver: un IDeviceActionReceiver che verrà rimosso.

disableKeyguard

public abstract void disableKeyguard ()

Tenta di disattivare la tastiera.

Innanzitutto, attendi che l'invio di input sia pronto. Questo accade all'incirca nello stesso momento in cui il dispositivo segnala BOOT_COMPLETE, apparentemente in modo asincrono, perché l'attuale implementazione del framework presenta occasionalmente una condizione di gara. Viene quindi inviato il comando per chiudere la schermata di blocco (funziona solo su quelle non sicure)

Lanci
DeviceNotAvailableException

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

Disattiva il monitoraggio della rete sul dispositivo.

Ritorni
boolean true se il monitoraggio viene disattivato correttamente. false se non è riuscito.
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

disconnetti daWifi

public abstract boolean disconnectFromWifi ()

Si disconnette da una rete Wi-Fi.

Rimuove tutte le reti dall'elenco delle reti conosciute e disattiva il Wi-Fi.

Ritorni
boolean true se si è disconnesso correttamente dalla rete Wi-Fi. false if disconnect failed.
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

Metodo di supporto per determinare se il file sul dispositivo esiste per un determinato utente.

Parametri
deviceFilePath String: il percorso assoluto del file sul dispositivo da verificare
userId int: l'ID utente in base al quale verificare l'esistenza del file
Ritorni
boolean true se il file esiste, false altrimenti.
Lanci
DeviceNotAvailableException se la connessione con il dispositivo si perde e non può essere recuperata.

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

Prova a eseguire il dump dell'heap da system_server. È responsabilità del chiamante eliminare il file di cui è stato eseguito il dump.

Parametri
process String: il nome del processo del dispositivo su cui eseguire il dump dell'heap.
devicePath String: il percorso sul dispositivo in cui inserire il dump. Deve trattarsi di una località in cui le autorizzazioni lo consentano.
Ritorni
File il ERROR(/File) contenente il report. Null se si è verificato un errore.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Attiva il monitoraggio della rete sul dispositivo.

Ritorni
boolean true se il monitoraggio è stato attivato correttamente. false se non è riuscito.
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

getActiveApexes

public abstract  getActiveApexes ()

Recupera le informazioni sugli APEX attivati sul dispositivo.

Ritorni
Attualmente attivi sul dispositivo: ERROR(/Set) di ApexInfo
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

Restituisce le coppie chiave-valore dello spazio dei nomi richiesto.

Parametri
namespace String: deve essere uno dei valori {"system", "secure", "global"}
Ritorni
la mappa delle coppie chiave-valore. Valore nullo se lo spazio dei nomi non è supportato.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

Trova e restituisce l'id Android associato a un userId, null se non trovato.

Parametri
userId int

Ritorni
String

Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

Crea una mappa degli ID Android trovati corrispondenti agli ID utente. Non è garantito che a ogni ID utente sia associato un ID Android in questa funzione, pertanto alcuni ID utente potrebbero corrispondere a null.

Ritorni
Mappa degli ID Android trovati corrispondenti agli ID utente.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

Recupera le informazioni su un pacchetto installato sul dispositivo.

Parametri
packageName String

Ritorni
PackageInfo PackageInfo o null se non è stato possibile recuperare le informazioni
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

Recupera le informazioni sui pacchetti installati sul dispositivo.

Ritorni
ERROR(/List) di PackageInfo installate sul dispositivo.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreport

public abstract InputStreamSource getBugreport ()

Recupera una segnalazione di bug dal dispositivo.

L'implementazione di questa funzionalità continuerà a funzionare su un dispositivo senza scheda SD (o in cui la scheda SD non è ancora montata).

Ritorni
InputStreamSource Un InputStreamSource che produrrà i contenuti del report di bug su richiesta. In caso di errore, InputStreamSource produrrà un ERROR(/InputStream) vuoto.

getBugreportz

public abstract InputStreamSource getBugreportz ()

Recupera una segnalazione di bug dal dispositivo. Il file bugreport in formato ZIP contiene il file bugreport principale e altri file di log utili per il debug.

Supportato solo per "versione adb" > 1.0.36

Ritorni
InputStreamSource un InputStreamSource del file ZIP contenente il bugreportz, restituisci null in caso di errore.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

Restituisce l'attuale stato pieghevole del dispositivo o nullo se si sono verificati alcuni problemi.

Ritorni
DeviceFoldableState

Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

Restituisce l'ID dell'utente corrente in esecuzione. In caso di errore, restituisce -10000.

Ritorni
int

Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

Restituisce l'elenco degli stati pieghevoli sul dispositivo. Può essere ottenuto con "cmd device_state print-states".

Ritorni
Lanci
com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

Recupera i nomi dei pacchetti delle applicazioni presenti sul dispositivo.

Ritorni
ERROR(/Set) dei String nomi dei pacchetti attualmente installati sul dispositivo.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Recupera l'indirizzo IP del dispositivo.

Ritorni
String l'indirizzo IP del dispositivo o null se il dispositivo non ha un indirizzo IP
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

Restituisce un oggetto per ottenere lo stato corrente della tastiera protetta o null se non supportato.

Ritorni
KeyguardControllerState un KeyguardControllerState contenente uno snapshot dello stato della schermata di blocco e restituisce Null se la query della schermata di blocco non è supportata.
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

getMainUserId

public abstract Integer getMainUserId ()

Restituisce l'ID utente principale.

Ritorni
Integer l'attributo userId dell'utente principale, se presente, e null se non è presente alcun utente principale.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException se l'output del dispositivo non è quello previsto.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

Visualizza le informazioni sui moduli principali installati sul dispositivo.

Ritorni
ERROR(/Set) dei String moduli principali attualmente installati sul dispositivo.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

Ottieni il numero massimo di utenti supportati in esecuzione contemporaneamente. Il valore predefinito è 0.

Ritorni
int un numero intero che indica il numero di utenti che eseguono contemporaneamente
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

Ottieni il numero massimo di utenti supportati. Il valore predefinito è 0.

Ritorni
int un numero intero che indica il numero di utenti supportati
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

Recupera le opzioni di test per il dispositivo.

Ritorni
TestDeviceOptions TestDeviceOptions relativi al dispositivo in test.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Restituisce l'ID utente principale.

Ritorni
Integer l'attributo userId dell'utente principale, se presente, e null se non è presente alcun utente principale.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException se l'output dal dispositivo non è come previsto.
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

Acquisisce uno screenshot dal dispositivo. Ti consigliamo di utilizzare getScreenshot(String) con la codifica JPEG per dimensioni inferiori.

Parametri
format String: supportati PNG, JPEG
rescale boolean: se lo screenshot deve essere ridimensionato per ridurre le dimensioni dell'immagine risultante
Ritorni
InputStreamSource un InputStreamSource dello screenshot nel formato o null se lo screenshot non è riuscito.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

Acquisisce uno screenshot dal dispositivo specificato dall'ID immagine. Il formato è PNG.

DA FARE: estendere le implementazioni precedenti per supportare "format" e "rescale"

Parametri
displayId long: l'ID visualizzatore della schermata da cui acquisire lo screenshot.
Ritorni
InputStreamSource un InputStreamSource dello screenshot in formato o null se lo screenshot non è andato a buon fine.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

Acquisisce uno screenshot dal dispositivo. Ti consigliamo di utilizzare getScreenshot(format) con codifica JPEG per dimensioni inferiori

Parametri
format String: supportati PNG, JPEG
Ritorni
InputStreamSource un InputStreamSource dello screenshot in formato o null se lo screenshot non è andato a buon fine.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

Acquisisce uno screenshot dal dispositivo.

Ritorni
InputStreamSource un InputStreamSource dello screenshot in formato png o null se lo screenshot non è andato a buon fine.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (int userId, 
                String namespace, 
                String key)

Restituisce il valore dell'impostazione richiesta. Lo spazio dei nomi deve essere uno dei seguenti: {"system", "secure", "global"}

Parametri
userId int

namespace String

key String

Ritorni
String Il valore associato a namespace:key di un utente. Null se non trovato.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

Vedi getSetting(int, String, String) e eseguita sull'utente di sistema.

Parametri
namespace String

key String

Ritorni
String

Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

Recupera i nomi dei pacchetti di applicazioni che possono essere disinstallati. Attualmente sono definiti come pacchetti non di sistema e pacchetti di sistema aggiornati.

Ritorni
ERROR(/Set) di nomi di pacchetti String non disinstallabili attualmente installati sul dispositivo.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Flag User

public abstract int getUserFlags (int userId)

Trova e restituisci gli indicatori di un determinato utente. I flag sono definiti nella classe "android.content.pm.UserInfo" in Android Open Source Project.

Parametri
userId int

Ritorni
int gli indicatori associati all'ID utente fornito, se trovato, -10000 in tutti gli altri casi.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

Recupera la mappa di useId a UserInfo sul dispositivo. Viene generato DeviceRuntimeException se l'output del dispositivo non è quello previsto.

Ritorni
l'elenco di oggetti UserInfo.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

Restituisce il numero di serie associato a userId, se trovato, -10000 in tutti gli altri casi.

Parametri
userId int

Ritorni
int

Lanci
com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

hasFeature

public abstract boolean hasFeature (String feature)

Controllare se una funzionalità è disponibile su un dispositivo.

Parametri
feature String: il formato deve essere "feature:" o "" direttamente.
Ritorni
boolean Vero se la funzionalità viene trovata, falso in caso contrario.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installPackage

public abstract String installPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

Installa un pacchetto Android sul dispositivo.

Parametri
packageFile File: il file APK da installare
reinstall boolean: true se deve essere eseguita una reinstallazione
extraArgs String: argomenti extra facoltativi da passare. Per le opzioni disponibili, consulta "adb shell pm -h".
Ritorni
String un String con un codice di errore o null se l'operazione è riuscita.
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

installPackage

public abstract String installPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Installa un pacchetto Android sul dispositivo.

Nota: solo i casi d'uso che richiedono il controllo esplicito della concessione dell'autorizzazione di runtime al momento dell'installazione devono chiamare questa funzione.

Parametri
packageFile File: il file APK da installare
reinstall boolean: true se deve essere eseguita una reinstallazione
grantPermissions boolean: se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione
extraArgs String: argomenti extra facoltativi da passare. Vedi "adb shell pm -h" per le opzioni disponibili.
Ritorni
String un String con un codice di errore o null se l'operazione è riuscita.
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.
UnsupportedOperationException se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

installPackageForUser

public abstract String installPackageForUser (File packageFile, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Installa un pacchetto Android sul dispositivo per un determinato utente.

Parametri
packageFile File: il file APK da installare
reinstall boolean: true se deve essere eseguita una reinstallazione
userId int: l'ID utente intero per il quale eseguire l'installazione.
extraArgs String: argomenti extra facoltativi da passare. Per le opzioni disponibili, consulta "adb shell pm -h".
Ritorni
String un String con un codice di errore o null se l'operazione è riuscita.
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

installPackageForUser

public abstract String installPackageForUser (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Installa un pacchetto Android sul dispositivo per un determinato utente.

Nota: solo i casi d'uso che richiedono il controllo esplicito della concessione dell'autorizzazione di runtime al momento dell'installazione devono chiamare questa funzione.

Parametri
packageFile File: il file APK da installare
reinstall boolean: true se deve essere eseguita una reinstallazione
grantPermissions boolean: se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione
userId int: l'ID utente intero per il quale eseguire l'installazione.
extraArgs String: argomenti extra facoltativi da passare. Per le opzioni disponibili, consulta "adb shell pm -h".
Ritorni
String un String con un codice di errore o null se l'operazione è riuscita.
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.
UnsupportedOperationException se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

installPackages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                String... extraArgs)

Installa un'applicazione Android composta da diversi file APK (un pacchetto principale e pacchetti suddivisi extra). Per informazioni su come suddividere l'APK in più file, consulta la pagina "https://developer.android.com/studio/build/configure-apk-splits".

Parametri
packageFiles : i file APK locali
reinstall boolean: true se deve essere eseguita una reinstallazione
extraArgs String: argomenti extra facoltativi da passare. Per le opzioni disponibili, consulta "adb shell pm -h".
Ritorni
String un String con un codice di errore o null se l'operazione è riuscita.
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.
UnsupportedOperationException se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

installPackages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Installa un'applicazione Android composta da diversi file APK (un pacchetto principale e pacchetti suddivisi extra) che si trovano sul dispositivo Android. Consulta la pagina "https://developer.android.com/studio/build/configure-apk-splits" per scoprire come suddividere l'APK in più file.

Nota: solo i casi d'uso che richiedono il controllo esplicito della concessione dell'autorizzazione di runtime al momento dell'installazione devono chiamare questa funzione.

Parametri
packageFiles : i percorsi dei file APK remoti da installare
reinstall boolean: true se deve essere eseguita una reinstallazione
grantPermissions boolean: se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione
extraArgs String: argomenti extra facoltativi da passare. Vedi "adb shell pm -h" per le opzioni disponibili.
Ritorni
String un String con un codice di errore o null se l'operazione è riuscita.
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.
UnsupportedOperationException se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Installa un'applicazione Android composta da diversi file APK (un pacchetto di suddivisione principale e uno aggiuntivo) per un determinato utente. Consulta la pagina "https://developer.android.com/studio/build/configure-apk-splits" su come suddividere l'APK in più file.

Parametri
packageFiles : i file APK locali
reinstall boolean: true se deve essere eseguita una reinstallazione
userId int: l'ID utente intero per il quale eseguire l'installazione.
extraArgs String: argomenti extra facoltativi da passare. Per le opzioni disponibili, consulta "adb shell pm -h".
Ritorni
String un String con un codice di errore o null se l'operazione è riuscita.
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.
UnsupportedOperationException se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Installa un'applicazione Android composta da diversi file APK (un pacchetto principale e pacchetti suddivisi extra) per un determinato utente. Consulta la pagina "https://developer.android.com/studio/build/configure-apk-splits" su come suddividere l'APK in più file.

Nota: solo i casi d'uso che richiedono il controllo esplicito della concessione dell'autorizzazione di runtime al momento dell'installazione devono chiamare questa funzione.

Parametri
packageFiles : i file APK locali
reinstall boolean: true se deve essere eseguita una reinstallazione
grantPermissions boolean: se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione
userId int: l'ID utente intero per il quale eseguire l'installazione.
extraArgs String: argomenti extra facoltativi da passare. Per le opzioni disponibili, consulta "adb shell pm -h".
Ritorni
String un String con un codice di errore o null se l'operazione è riuscita.
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.
UnsupportedOperationException se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                String... extraArgs)

Installa un'applicazione Android composta da diversi file APK (un pacchetto principale e pacchetti suddivisi extra) che si trovano sul dispositivo Android. Consulta la pagina "https://developer.android.com/studio/build/configure-apk-splits" per scoprire come suddividere l'APK in più file.

Parametri
remoteApkPaths : i percorsi dei file APK remoti
reinstall boolean: true se deve essere eseguita una reinstallazione
extraArgs String: argomenti extra facoltativi da passare. Per le opzioni disponibili, consulta "adb shell pm -h".
Ritorni
String String con un codice di errore o null in caso di esito positivo.
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.
UnsupportedOperationException se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Installa un'applicazione Android composta da diversi file APK (un pacchetto principale e pacchetti suddivisi extra) che si trovano sul dispositivo Android. Consulta la pagina "https://developer.android.com/studio/build/configure-apk-splits" per scoprire come suddividere l'APK in più file.

Nota: solo i casi d'uso che richiedono il controllo esplicito della concessione dell'autorizzazione di runtime al momento dell'installazione devono chiamare questa funzione.

Parametri
remoteApkPaths : i percorsi dei file APK remoti
reinstall boolean: true se è necessario eseguire una reinstallazione
grantPermissions boolean: se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione
extraArgs String: argomenti extra facoltativi da passare. Vedi "adb shell pm -h" per le opzioni disponibili.
Ritorni
String un String con un codice di errore o null se l'operazione è riuscita.
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.
UnsupportedOperationException se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

Indica se il dispositivo utilizza la modalità utente di sistema headless.

Ritorni
boolean

Lanci
DeviceNotAvailableException

èAmministratorePermanenteUtentePrincipale

public abstract boolean isMainUserPermanentAdmin ()

Restituisce se l'utente principale è un amministratore permanente e non può essere eliminato o sottoposto a downgrade allo stato di utente non amministratore.

Ritorni
boolean

Lanci
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

Determina se la funzionalità multiutente è supportata.

Ritorni
boolean true se è supportato il multiutente, false in caso contrario
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

Esegui una query sul dispositivo per un determinato nome del pacchetto e un determinato ID utente per verificare se è attualmente installato o meno per quell'utente.

Parametri
packageName String: il pacchetto di cui stiamo controllando l'installazione.
userId String: l'ID utente per cui stiamo controllando l'installazione del pacchetto. Se nullo, verrà utilizzato lo zero dell'utente principale.
Ritorni
boolean True se il pacchetto è segnalato come installato. Falso negli altri casi.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

Esegui una query sul dispositivo per un determinato nome del pacchetto per verificare se è attualmente installato o meno.

Parametri
packageName String

Ritorni
boolean True se il pacchetto è segnalato come installato. Falso negli altri casi.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

Verifica se un determinato utente è in esecuzione.

Parametri
userId int

Ritorni
boolean True se l'utente è in esecuzione, false in tutti gli altri casi.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

Restituisce se l'utente specificato è un utente secondario in base ai relativi flag.

Parametri
userId int

Ritorni
boolean true se l'utente è secondario, false in caso contrario.
Lanci
com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

isUserVisible

public abstract boolean isUserVisible (int userId)

Controlla se l'utente specificato è visibile.

Un utente "visibile" è un utente che interagisce con l'utente "umano" e quindi è in grado di avviare attività di lancio (in genere nella visualizzazione predefinita).

Parametri
userId int

Ritorni
boolean

Lanci
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Controlla se l'utente è visibile sul display specificato.

Un utente "visibile" è un utente che interagisce con l'utente "umano" e quindi è in grado di avviare attività di lancio in quella visualizzazione.

Parametri
userId int

displayId int

Ritorni
boolean

Lanci
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Indica se il dispositivo consente agli utenti di essere avviati visibili in background in ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

In questo caso, puoi chiamare startVisibleBackgroundUser(int, int, boolean), passando un display restituito da listDisplayIdsForStartingVisibleBackgroundUsers() (che deve includere ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

Ritorni
boolean

Lanci
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

Restituisce se il dispositivo consente agli utenti di essere avviati in background.

In questo caso, puoi chiamare startVisibleBackgroundUser(int, int, boolean), passando un visualizzatore restituito da listDisplayIdsForStartingVisibleBackgroundUsers().

Ritorni
boolean

Lanci
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Verifica che il Wi-Fi sia attivo.

Controlla se il Wi-Fi è attivo sul dispositivo. Utile per verificare lo stato del Wi-Fi prima dei test che non devono essere eseguiti con il Wi-Fi, ad esempio i test dei dati mobili.

Ritorni
boolean true se il Wi-Fi è attivo. false se disattivato
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

listDisplayIds

public abstract  listDisplayIds ()

Raccogliere l'elenco degli ID display disponibili sul dispositivo, come indicato da "dumpsys SurfaceFlinger".

Ritorni
L'elenco delle visualizzazioni. Il valore predefinito restituisce sempre il valore visualizzato predefinito 0.
Lanci
com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

listDisplayIdsForStartingVisibilityBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

Recupera l'elenco di display che possono essere utilizzati per start a user visible in the background.

Ritorni
Lanci
DeviceNotAvailableException

listUsers

public abstract  listUsers ()

Recupera l'elenco di utenti presenti sul dispositivo. Viene generato DeviceRuntimeException se l'output del dispositivo non è come previsto.

Ritorni
l'elenco degli ID utente.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Metodo di supporto per acquisire una segnalazione di bug e registrarla per i reporter.

Parametri
dataName String: il nome con cui verrà segnalata la segnalazione di bug.
listener ITestLogger: un ITestLogger per registrare il report di bug.
Ritorni
boolean Vero se il logging è riuscito, falso in caso contrario.

notificaSnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Comunica al dispositivo di attendere il completamento di snapuserd.

Parametri
waitPhase SnapuserdWaitPhase

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registra un IDeviceActionReceiver per questo dispositivo.

Tutti i IDeviceActionReceiver registrati riceveranno una notifica prima dell'inizio e al termine di un'azione del dispositivo.

Parametri
deviceActionReceiver IDeviceActionReceiver: un IDeviceActionReceiver che verrà registrato.

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

Rimuovi l'amministratore del dispositivo specificato nell'utente specificato e restituisci true se l'operazione ha esito positivo, false altrimenti.

Parametri
componentName String: amministratore del dispositivo da rimuovere.
userId int: paese in cui risiede l'amministratore del dispositivo.
Ritorni
boolean True se ha esito positivo, falso in caso contrario.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

rimuoviProprietari

public abstract void removeOwners ()

Rimuovi tutti i proprietari di profili esistenti del dispositivo con il massimo impegno.

Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeUser

public abstract boolean removeUser (int userId)

Rimuovere un determinato utente dal dispositivo.

Parametri
userId int: dell'utente da rimuovere
Ritorni
boolean true se è stato possibile rimuovere l'utente, false in caso contrario.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

Imposta un componente di amministrazione del dispositivo come proprietario del dispositivo in un determinato utente.

Parametri
componentName String: dell'amministratore del dispositivo come proprietario.
userId int: dell'utente in cui risiede il proprietario del dispositivo.
Ritorni
boolean True se ha esito positivo, falso in caso contrario.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

public abstract void setSetting (String namespace, 
                String key, 
                String value)

Vedi setSetting(int, String, String, String) e eseguita sull'utente di sistema.

Parametri
namespace String

key String

value String

Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

public abstract void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

Aggiungi un valore di impostazione allo spazio dei nomi di un determinato utente. Alcune impostazioni saranno disponibili solo dopo un riavvio. Lo spazio dei nomi deve essere uno dei seguenti: {"system", "secure", "global"}

Parametri
userId int

namespace String

key String

value String

Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId)

Avvia un determinato utente in background se è attualmente fermo. Se l'utente è già in esecuzione in background, questo metodo è un NOOP.

Parametri
userId int: dell'utente da avviare in background
Ritorni
boolean true se l'utente è stato avviato correttamente in background.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

Avvia un determinato utente in background se è attualmente fermo. Se l'utente è già in esecuzione in background, questo metodo è un NOOP. È possibile fornire un flag aggiuntivo per attendere che l'operazione abbia effetto.

Parametri
userId int: dell'utente da avviare in background
waitFlag boolean: attenderà che l'utente venga avviato e sbloccato.
Ritorni
boolean true se l'utente è stato avviato correttamente in background.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

public abstract boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

Avvia un determinato utente in background, visibile sul display specificato (ad esempio, consentendo all'utente di avviare attività in quel display).

NOTA : questo comando non verifica se l'utente esiste, se la visualizzazione è disponibile, device supports such feature e così via.

Parametri
userId int: dell'utente da avviare in background
displayId int: display su cui iniziare a mostrare l'utente
waitFlag boolean: il comando attenderà che l'utente venga avviato e sbloccato.
Ritorni
boolean true se l'utente è stato avviato correttamente e visualizzato in background.
Lanci
DeviceNotAvailableException

Utente bloccato

public abstract boolean stopUser (int userId)

Interrompe un determinato utente. Se l'utente è già fermo, questo metodo è un NOOP. Impossibile interrompere l'utente corrente e di sistema.

Parametri
userId int: dell'utente da interrompere.
Ritorni
boolean true se l'utente è stato interrotto correttamente.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Utente bloccato

public abstract boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

Interrompere un determinato utente. È possibile fornire flag aggiuntivi per attendere l'applicazione dell'operazione e forzare l'interruzione dell'utente. Impossibile interrompere l'utente corrente e quello di sistema.

Parametri
userId int: dell'utente da interrompere.
waitFlag boolean: il comando attenderà finché l'utente non si fermerà.
forceFlag boolean: l'utente verrà interrotto forzatamente.
Ritorni
boolean true se l'utente è stato interrotto correttamente.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId)

Passa a un altro userId con un timeout predefinito. switchUser(int, long).

Parametri
userId int

Ritorni
boolean True se il nuovo userId corrisponde al provider userId. Falso negli altri casi.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

Passa a un altro userId con il timeout specificato come scadenza. Tentativo di disattivare la schermata di blocco dopo la modifica dell'utente.

Parametri
userId int

timeout long: l'attesa prima di restituire false per lo scambio utente non è riuscita.
Ritorni
boolean True se il nuovo userId corrisponde al provider userId. Falso negli altri casi.
Lanci
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

Prende un report di bug e lo restituisce all'interno di un oggetto Bugreport per gestirlo. Restituisci nullo in caso di problemi. Il file a cui viene fatto riferimento nell'oggetto Bugreport deve essere cancellato tramite Bugreport.close().

Ritorni
Bugreport

disinstalla il pacchetto

public abstract String uninstallPackage (String packageName)

Disinstalla un pacchetto Android dal dispositivo.

Parametri
packageName String: il pacchetto Android da disinstallare
Ritorni
String String con un codice di errore o null in caso di esito positivo.
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

Disinstalla un pacchetto Android dal dispositivo per un determinato utente.

Parametri
packageName String: il pacchetto Android da disinstallare
userId int: l'ID utente intero per il quale eseguire la disinstallazione.
Ritorni
String un String con un codice di errore o null se l'operazione è riuscita.
Lanci
DeviceNotAvailableException Se la connessione con il dispositivo viene persa e non può essere recuperata.

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Se previsto, attendi il completamento di snapuserd.

Parametri
currentPhase SnapuserdWaitPhase

Lanci
DeviceNotAvailableException