ITDispositivo

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

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

Riprova i comandi del dispositivo per un numero configurabile e fornisce un'interfaccia di ripristino del dispositivo per i dispositivi che non rispondono.

Riepilogo

Classi nidificate

class ITestDevice.ApexInfo

Una semplice classe struct per archiviare informazioni su un singolo APEX

class ITestDevice.MountPointInfo

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

Metodi pubblici

abstract boolean canSwitchToHeadlessSystemUser ()

Restituisce se è consentito passare all'utente SYSTEM senza testa.

abstract boolean checkConnectivity ()

Verificare che il dispositivo disponga di connettività di rete.

abstract boolean clearErrorDialogs ()

Tentativo di eliminare eventuali finestre di dialogo di errore attualmente visualizzate sull'interfaccia utente del dispositivo.

abstract void clearLastConnectedWifiNetwork ()

Cancella l'ultima rete Wi-Fi connessa.

abstract boolean connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)

Si connette a una rete Wi-Fi.

abstract boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

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 dispone di 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 dispone di connettività di rete.

abstract int createUser (String name)

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

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

Crea un utente con un determinato nome e i flag forniti

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

Crea un utente con un determinato nome e i flag forniti

abstract int createUserNoThrow (String name)

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

abstract void deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Rimuove l' IDeviceActionReceiver registrato.

abstract void disableKeyguard ()

Tenta di disabilitare il blocco della tastiera.

abstract boolean disableNetworkMonitor ()

Disabilita il monitoraggio della rete sul dispositivo.

abstract boolean disconnectFromWifi ()

Si disconnette da una rete wifi.

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)

Tentativo di eseguire il dump dell'heap da system_server.

abstract boolean enableNetworkMonitor ()

Abilita il monitoraggio della rete sul dispositivo.

abstract getActiveApexes ()

Recupera le informazioni sugli APEX attivati ​​sul dispositivo.

abstract getAllSettings (String namespace)

Restituisce coppie chiave-valore dello spazio dei nomi richiesto.

abstract String getAndroidId (int userId)

Trova e restituisce l'id android associato a uno userId, nullo se non trovato.

abstract getAndroidIds ()

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

abstract PackageInfo getAppPackageInfo (String packageName)

Recupera informazioni su un pacchetto installato sul dispositivo.

abstract getAppPackageInfos ()

Recupera le informazioni dei 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 pieghevole corrente del dispositivo o null se si sono verificati problemi.

abstract int getCurrentUser ()

Restituisce l'id dell'utente attualmente in esecuzione.

abstract getFoldableStates ()

Restituisce l'elenco degli stati ripiegabili sul dispositivo.

abstract getInstalledPackageNames ()

Recupera i nomi dei pacchetti dell'applicazione presenti sul dispositivo.

abstract String getIpAddress ()

Ottiene l'indirizzo IP del dispositivo.

abstract KeyguardControllerState getKeyguardState ()

Restituisce un oggetto per ottenere lo stato corrente del keyguard o null se non supportato.

abstract Integer getMainUserId ()

Restituisce l'ID utente principale.

abstract getMainlineModuleInfo ()

Ottieni le informazioni sui moduli mainline installati sul dispositivo.

abstract int getMaxNumberOfRunningUsersSupported ()

Ottieni il numero massimo di utenti in esecuzione simultanei supportati.

abstract int getMaxNumberOfUsersSupported ()

Ottieni 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 ()

Acquisisce uno screenshot dal dispositivo.

abstract InputStreamSource getScreenshot (String format, boolean rescale)

Acquisisce uno screenshot dal dispositivo.

abstract InputStreamSource getScreenshot (String format)

Acquisisce uno screenshot dal dispositivo.

abstract InputStreamSource getScreenshot (long displayId)

Acquisisce uno screenshot dal dispositivo a cui è stato assegnato l'ID display.

abstract String getSetting (String namespace, String key)

Vedere getSetting(int, String, String) ed eseguito sull'utente di sistema.

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

Restituisce il valore dell'impostazione richiesta.

abstract getUninstallablePackageNames ()

Recupera i nomi dei pacchetti dell'applicazione che possono essere disinstallati.

abstract int getUserFlags (int userId)

Trova e restituisce i flag di un dato utente.

abstract getUserInfos ()

Ottiene la mappa di useId per UserInfo nel dispositivo.

abstract int getUserSerialNumber (int userId)

Restituisce il numero seriale associato allo userId se trovato, -10000 negli altri casi.

abstract boolean hasFeature (String feature)

Controlla se una funzione è 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, boolean grantPermissions, int userId, String... extraArgs)

Installa un pacchetto Android sul dispositivo per un determinato utente.

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

Installa un pacchetto Android sul dispositivo per un determinato utente.

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

Installa un'applicazione Android composta da diversi file APK (un pacchetto principale e uno diviso in più).

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

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

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

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

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

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

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

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

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

Installa un'applicazione Android composta da diversi file APK (un pacchetto principale e uno diviso 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 non amministratore.

abstract boolean isMultiUserSupported ()

Determina se è supportato il multiutente.

abstract boolean isPackageInstalled (String packageName)

Interroga il dispositivo per un determinato nome di pacchetto per verificare se è attualmente installato o meno.

abstract boolean isPackageInstalled (String packageName, String userId)

Interroga il dispositivo per un determinato nome di pacchetto e un determinato ID utente per verificare se è attualmente installato o meno per quell'utente.

abstract boolean isUserRunning (int userId)

Controlla se un determinato utente è in esecuzione.

abstract boolean isUserSecondary (int userId)

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

abstract boolean isUserVisible (int userId)

Verifica se l'utente specificato è visibile.

abstract boolean isUserVisibleOnDisplay (int userId, int displayId)

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

abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Restituisce 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 visibili in background.

abstract boolean isWifiEnabled ()

Verifica se il Wi-Fi è abilitato.

abstract listDisplayIds ()

Raccogli l'elenco degli ID display disponibili sul dispositivo come riportato da "dumpsys SurfaceFlinger".

abstract listDisplayIdsForStartingVisibleBackgroundUsers ()

Ottiene l'elenco delle schermate che possono essere utilizzate per start a user visible in the background .

abstract listUsers ()

Ottiene l'elenco degli utenti nel dispositivo.

abstract boolean logBugreport (String dataName, ITestLogger listener)

Metodo di supporto per prendere un bugreport e registrarlo ai reporter.

abstract void registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Registra un IDeviceActionReceiver per questo dispositivo.

abstract boolean removeAdmin (String componentName, int userId)

Rimuovi l'amministratore del dispositivo specificato in un determinato utente e restituisci true se ha esito positivo, false in caso contrario.

abstract void removeOwners ()

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

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)

Vedere setSetting(int, String, String, String) ed eseguito 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 interrotto.

abstract boolean startUser (int userId, boolean waitFlag)

Avvia un determinato utente in background se è attualmente interrotto.

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

Avvia un dato utente in background, visibile nel dato display (cioè, permettendo all'utente di lanciare attività in quel display).

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

Arrestare un determinato utente.

abstract boolean stopUser (int userId)

Arresta un determinato utente.

abstract boolean switchUser (int userId)

Passa a un altro ID utente con un timeout predefinito.

abstract boolean switchUser (int userId, long timeout)

Passa a un altro ID utente con il timeout fornito come scadenza.

abstract Bugreport takeBugreport ()

Prendi un bugreport e lo restituisce all'interno di un oggetto Bugreport per gestirlo.

abstract String uninstallPackage (String packageName)

Disinstalla un pacchetto Android dal dispositivo.

abstract String uninstallPackageForUser (String packageName, int userId)

Disinstalla un pacchetto Android dal dispositivo per un determinato utente.

Metodi pubblici

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

Restituisce se è consentito passare all'utente SYSTEM senza testa.

ritorna
boolean

Getta
DeviceNotAvailableException

checkConnettività

public abstract boolean checkConnectivity ()

Verificare che il dispositivo disponga di connettività di rete.

ritorna
boolean true se il dispositivo dispone di una connessione di rete funzionante, false overwise.

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

Tentativo di eliminare eventuali finestre di dialogo di errore attualmente visualizzate sull'interfaccia utente del dispositivo.

ritorna
boolean true se non erano presenti finestre di dialogo o le finestre di dialogo sono state cancellate correttamente. false altrimenti.

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

Cancella l'ultima rete Wi-Fi connessa. Questo dovrebbe essere chiamato quando si avvia 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, 
                boolean scanSsid)

Si connette a una rete Wi-Fi.

Attiva il wifi e si blocca fino a quando non viene stabilita una connessione con una delle reti wifi fornite nella mappa wifiSsidToPsk. Una volta stabilita una connessione, l'istanza proverà a ripristinarla dopo ogni riavvio finché non viene chiamato ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork() .

Parametri
wifiSsidToPsk : una mappa degli SSID wifi alle password.

scanSsid boolean : se cercare gli SSID nascosti per questa rete.

ritorna
boolean true se connesso correttamente alla rete Wi-Fi. false altrimenti

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Si connette a una rete Wi-Fi.

Attiva il wifi e si blocca fino a quando non viene stabilita una connessione con una delle reti wifi fornite nella mappa wifiSsidToPsk. Una volta stabilita una connessione, l'istanza proverà a ripristinarla dopo ogni riavvio finché non viene chiamato ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork() .

Parametri
wifiSsidToPsk : una mappa degli SSID wifi alle password.

ritorna
boolean true se connesso correttamente alla rete Wi-Fi. false altrimenti

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

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 corretta alla rete Wi-Fi specificata. Una volta stabilita una connessione, l'istanza proverà a ripristinarla dopo ogni riavvio finché non viene chiamato ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork() .

Parametri
wifiSsid String : l'ssid wifi a cui connettersi

wifiPsk String : passphrase PSK o null se non crittografato

ritorna
boolean true se connesso correttamente alla rete Wi-Fi. false altrimenti

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

connectToWifiNetwork

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 corretta alla rete Wi-Fi specificata. Una volta stabilita una connessione, l'istanza proverà a ripristinarla dopo ogni riavvio finché non viene chiamato ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork() .

Parametri
wifiSsid String : l'ssid wifi a cui connettersi

wifiPsk String : passphrase PSK o null se non crittografato

scanSsid boolean : se cercare l'SSID nascosto per questa rete.

ritorna
boolean true se connesso correttamente alla rete Wi-Fi. false altrimenti

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

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 dispone di connettività di rete.

Parametri
scanSsid boolean : se cercare l'SSID nascosto per questa rete

ritorna
boolean true se connesso correttamente alla rete Wi-Fi. false altrimenti

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

ritorna
boolean true se connesso correttamente alla rete Wi-Fi. false altrimenti

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

creare un utente

public abstract int createUser (String name)

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

Parametri
name String : dell'utente da creare sul dispositivo

ritorna
int il numero intero per l'ID utente creato

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

creare un utente

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

Crea un utente con un determinato nome e i flag forniti

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 --ephemeral durante la creazione

forTesting boolean : abilita il flag di test --for-testing durante la creazione

ritorna
int id dell'utente creato

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

creare un utente

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

Crea un utente con un determinato nome e i flag forniti

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 --ephemeral durante la creazione

ritorna
int id dell'utente creato

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

Parametri
name String : dell'utente da creare sul dispositivo

ritorna
int il numero intero per l'ID utente creato o -1 per errore.

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deregistrareDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Rimuove l' IDeviceActionReceiver registrato.

Parametri
deviceActionReceiver IDeviceActionReceiver : un IDeviceActionReceiver che verrà rimosso.

disabilitareKeyguard

public abstract void disableKeyguard ()

Tenta di disabilitare il blocco della tastiera.

Per prima cosa attendi che l'invio di input sia pronto, ciò accade più o meno nello stesso momento in cui il dispositivo segnala BOOT_COMPLETE, apparentemente in modo asincrono, perché l'attuale implementazione del framework ha condizioni di competizione occasionali. Quindi viene inviato il comando per eliminare il blocco della tastiera (funziona solo su quelli non sicuri)

Getta
DeviceNotAvailableException

disabilita NetworkMonitor

public abstract boolean disableNetworkMonitor ()

Disabilita il monitoraggio della rete sul dispositivo.

ritorna
boolean true se il monitoraggio viene disabilitato correttamente. false se fallisce.

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

disconnettiDaWifi

public abstract boolean disconnectFromWifi ()

Si disconnette da una rete wifi.

Rimuove tutte le reti dall'elenco delle reti conosciute e disabilita il wifi.

ritorna
boolean true se disconnesso correttamente dalla rete Wi-Fi. false se la disconnessione non è riuscita.

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

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 controllare

userId int : l'ID utente rispetto al quale verificare l'esistenza del file

ritorna
boolean true se il file esiste, false in caso contrario.

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

Tentativo di eseguire il dump dell'heap da system_server. È responsabilità del chiamante ripulire il file scaricato.

Parametri
process String : il nome del processo del dispositivo su cui eseguire il dumpheap.

devicePath String : il percorso sul dispositivo dove inserire il dump. Questa deve essere una posizione in cui le autorizzazioni lo consentono.

ritorna
File l' ERROR(/File) contenente il report. Null se qualcosa fallisce.

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

abilitaNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Abilita il monitoraggio della rete sul dispositivo.

ritorna
boolean true se il monitoraggio è abilitato correttamente. false se fallisce.

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

getActiveApex

public abstract  getActiveApexes ()

Recupera le informazioni sugli APEX attivati ​​sul dispositivo.

ritorna
ERROR(/Set) di ApexInfo attualmente attivato sul dispositivo

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getTutte le impostazioni

public abstract  getAllSettings (String namespace)

Restituisce coppie chiave-valore dello spazio dei nomi richiesto.

Parametri
namespace String : deve essere uno tra {"system", "secure", "global"}

ritorna
la mappa delle coppie chiave-valore. Null se lo spazio dei nomi non è supportato.

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

Trova e restituisce l'id android associato a uno userId, nullo se non trovato.

Parametri
userId int

ritorna
String

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

Crea una mappa degli ID Android trovati corrispondenti agli ID utente. Non vi è alcuna garanzia che ogni ID utente trovi un ID Android associato a questa funzione, quindi alcuni ID utente potrebbero corrispondere a null.

ritorna
Mappa degli ID Android trovati corrispondenti agli ID utente.

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

Recupera informazioni su un pacchetto installato sul dispositivo.

Parametri
packageName String

ritorna
PackageInfo PackageInfo o null se non è stato possibile recuperare le informazioni

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

Recupera le informazioni dei pacchetti installati sul dispositivo.

ritorna
ERROR(/List) di PackageInfo s installati sul dispositivo.

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreport

public abstract InputStreamSource getBugreport ()

Recupera una segnalazione di bug dal dispositivo.

L'implementazione di questo è garantito per continuare a funzionare su un dispositivo senza una sdcard (o dove la sdcard non è ancora montata).

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

Recupera un bugreportz dal dispositivo. Il bugreport in formato zip contiene il bugreport principale e altri file di log utili per il debug.

Supportato solo per "versione adb" > 1.0.36

ritorna
InputStreamSource un InputStreamSource del file zip contenente il bugreportz, restituisce null in caso di errore.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

ritorna
DeviceFoldableState

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

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

ritorna
int

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

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

ritorna

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

Recupera i nomi dei pacchetti dell'applicazione presenti sul dispositivo.

ritorna
ERROR(/Set) di String nomi dei pacchetti attualmente installati sul dispositivo.

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Ottiene l'indirizzo IP del dispositivo.

ritorna
String l'indirizzo IP del dispositivo o null se il dispositivo non ha un indirizzo IP

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

Restituisce un oggetto per ottenere lo stato corrente del keyguard o null se non supportato.

ritorna
KeyguardControllerState un KeyguardControllerState contenente un'istantanea dello stato del keyguard e restituisce Null se la query Keyguard non è supportata.

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

getMainUserId

public abstract Integer getMainUserId ()

Restituisce l'ID utente principale.

ritorna
Integer lo userId dell'utente principale se ce n'è uno e null se non c'è nessun utente principale.

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException se l'output dal dispositivo non è come previsto.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

Ottieni le informazioni sui moduli mainline installati sul dispositivo.

ritorna
ERROR(/Set) dei moduli della linea principale String attualmente installati sul dispositivo.

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

ritorna
int un numero intero che indica il numero di utenti in esecuzione contemporaneamente

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

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

ritorna
int un numero intero che indica il numero di utenti supportati

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

Recupera le opzioni di test per il dispositivo.

ritorna
TestDeviceOptions TestDeviceOptions relative al dispositivo sottoposto a test.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Restituisce l'ID utente principale.

ritorna
Integer lo userId dell'utente primario se ce n'è uno e null se non c'è nessun utente primario.

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException se l'output dal dispositivo non è come previsto.
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

Acquisisce uno screenshot dal dispositivo.

ritorna
InputStreamSource un InputStreamSource dello screenshot in formato png, oppure null se lo screenshot non è andato a buon fine.

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

Acquisisce uno screenshot dal dispositivo. Si consiglia di utilizzare invece getScreenshot(String) con la codifica JPEG per dimensioni inferiori.

Parametri
format String : PNG, JPEG supportati

rescale boolean : se lo screenshot deve essere ridimensionato per ridurre le dimensioni dell'immagine risultante

ritorna
InputStreamSource un InputStreamSource dello screenshot in formato, o null se lo screenshot non è andato a buon fine.

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

Acquisisce uno screenshot dal dispositivo. Si consiglia di utilizzare getScreenshot(format) invece con la codifica JPEG per dimensioni inferiori

Parametri
format String : PNG, JPEG supportati

ritorna
InputStreamSource un InputStreamSource dello screenshot in formato, o null se lo screenshot non è andato a buon fine.

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

Acquisisce uno screenshot dal dispositivo a cui è stato assegnato l'ID display. Il formato è PNG.

TODO: estendere le implementazioni sopra per supportare 'format' e 'rescale'

Parametri
displayId long : l'id di visualizzazione dello schermo da cui ottenere lo screenshot.

ritorna
InputStreamSource un InputStreamSource dello screenshot in formato, o null se lo screenshot non è andato a buon fine.

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

Vedere getSetting(int, String, String) ed eseguito sull'utente di sistema.

Parametri
namespace String

key String

ritorna
String

Getta
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 tra: {"system", "secure", "global"}

Parametri
userId int

namespace String

key String

ritorna
String il valore associato allo spazio dei nomi:chiave di un utente. Null se non trovato.

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

Recupera i nomi dei pacchetti dell'applicazione che possono essere disinstallati. Questo è attualmente definito come pacchetti non di sistema e pacchetti di sistema aggiornati.

ritorna
ERROR(/Set) dei nomi dei pacchetti String non installabili attualmente installati sul dispositivo.

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

Trova e restituisce i flag di un dato utente. I flag sono definiti nella classe "android.content.pm.UserInfo" nel progetto Android Open Source.

Parametri
userId int

ritorna
int i flag associati allo userId fornito se trovato, -10000 negli altri casi.

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

Ottiene la mappa di useId per UserInfo nel dispositivo. Genera DeviceRuntimeException se l'output dal dispositivo non è come previsto.

ritorna
l'elenco degli oggetti UserInfo.

Getta
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

Restituisce il numero seriale associato allo userId se trovato, -10000 negli altri casi.

Parametri
userId int

ritorna
int

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

hasFeature

public abstract boolean hasFeature (String feature)

Controlla se una funzione è disponibile su un dispositivo.

Parametri
feature String : quale formato dovrebbe essere "feature: " O " "direttamente.

ritorna
boolean Vero se viene trovata la caratteristica, falso in caso contrario.

Getta
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 aggiuntivi facoltativi da passare. Vedere 'adb shell pm -h' per le opzioni disponibili.

ritorna
String una String con un codice di errore o null in caso di successo.

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

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 dovrebbero 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 aggiuntivi facoltativi da passare. Vedere 'adb shell pm -h' per le opzioni disponibili.

ritorna
String una String con un codice di errore o null in caso di successo.

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.
UnsupportedOperationException se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

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 dovrebbero 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 cui eseguire l'installazione.

extraArgs String : argomenti aggiuntivi facoltativi da passare. Vedere 'adb shell pm -h' per le opzioni disponibili.

ritorna
String una String con un codice di errore o null in caso di successo.

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.
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 cui eseguire l'installazione.

extraArgs String : argomenti aggiuntivi facoltativi da passare. Vedere 'adb shell pm -h' per le opzioni disponibili.

ritorna
String una String con un codice di errore o null in caso di successo.

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

installPacchetti

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

Installa un'applicazione Android composta da diversi file APK (un pacchetto principale e uno diviso in più). Vedi "https://developer.android.com/studio/build/configure-apk-splits" su come dividere l'apk in più file.

Parametri
packageFiles : i file apk locali

reinstall boolean : true se deve essere eseguita una reinstallazione

extraArgs String : argomenti aggiuntivi facoltativi da passare. Vedere 'adb shell pm -h' per le opzioni disponibili.

ritorna
String una String con un codice di errore o null in caso di successo.

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.
UnsupportedOperationException se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

installPacchetti

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

Installa un'applicazione Android composta da diversi file APK (un pacchetto principale e uno diviso extra) che si trovano sul dispositivo Android. Vedi "https://developer.android.com/studio/build/configure-apk-splits" su come dividere 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 dovrebbero chiamare questa funzione.

Parametri
packageFiles : i percorsi del file apk remoto 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 aggiuntivi facoltativi da passare. Vedere 'adb shell pm -h' per le opzioni disponibili.

ritorna
String una String con un codice di errore o null in caso di successo.

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.
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 uno diviso extra) per un determinato utente. Vedi "https://developer.android.com/studio/build/configure-apk-splits" su come dividere 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 dovrebbero 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 cui eseguire l'installazione.

extraArgs String : argomenti aggiuntivi facoltativi da passare. Vedere 'adb shell pm -h' per le opzioni disponibili.

ritorna
String una String con un codice di errore o null in caso di successo.

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.
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 principale e uno diviso extra) per un determinato utente. Vedi "https://developer.android.com/studio/build/configure-apk-splits" su come dividere 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 cui eseguire l'installazione.

extraArgs String : argomenti aggiuntivi facoltativi da passare. Vedere 'adb shell pm -h' per le opzioni disponibili.

ritorna
String una String con un codice di errore o null in caso di successo.

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.
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 uno diviso extra) che si trovano sul dispositivo Android. Vedi "https://developer.android.com/studio/build/configure-apk-splits" su come dividere 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 aggiuntivi facoltativi da passare. Vedere 'adb shell pm -h' per le opzioni disponibili.

ritorna
String una String con un codice di errore o null in caso di successo.

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.
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 uno diviso extra) che si trovano sul dispositivo Android. Vedi "https://developer.android.com/studio/build/configure-apk-splits" su come dividere 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 dovrebbero chiamare questa funzione.

Parametri
remoteApkPaths : i percorsi dei file apk remoti

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 aggiuntivi facoltativi da passare. Vedere 'adb shell pm -h' per le opzioni disponibili.

ritorna
String una String con un codice di errore o null in caso di successo.

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.
UnsupportedOperationException se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

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

ritorna
boolean

Getta
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

ritorna
boolean

Getta
DeviceNotAvailableException

è multiutente supportato

public abstract boolean isMultiUserSupported ()

Determina se è supportato il multiutente.

ritorna
boolean true se multiutente è supportato, false in caso contrario

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

Interroga il dispositivo per un determinato nome di pacchetto per verificare se è attualmente installato o meno.

Parametri
packageName String

ritorna
boolean True se il pacchetto viene segnalato come installato. Falso altrimenti.

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

Interroga il dispositivo per un determinato nome di pacchetto e un determinato ID utente per verificare se è attualmente installato o meno per quell'utente.

Parametri
packageName String : il pacchetto che stiamo controllando se è installato.

userId String : l'ID utente per cui stiamo controllando il pacchetto è installato. Se null, verrà utilizzato l'utente primario zero.

ritorna
boolean True se il pacchetto viene segnalato come installato. Falso altrimenti.

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

Controlla se un determinato utente è in esecuzione.

Parametri
userId int

ritorna
boolean True se l'utente è in esecuzione, false negli altri casi.

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

Parametri
userId int

ritorna
boolean true se l'utente è secondario, false in caso contrario.

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserVisible

public abstract boolean isUserVisible (int userId)

Verifica se l'utente specificato è visibile.

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

Parametri
userId int

ritorna
boolean

Getta
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

Parametri
userId int

displayId int

ritorna
boolean

Getta
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

ritorna
boolean

Getta
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

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

ritorna
boolean

Getta
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Verifica se il Wi-Fi è abilitato.

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

ritorna
boolean true se il Wi-Fi è abilitato. false se disabilitato

Getta
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

listDisplayIds

public abstract  listDisplayIds ()

Raccogli l'elenco degli ID display disponibili sul dispositivo come riportato da "dumpsys SurfaceFlinger".

ritorna
L'elenco dei display. Default restituisce sempre la visualizzazione predefinita 0.

Getta
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

Ottiene l'elenco delle schermate che possono essere utilizzate per start a user visible in the background .

ritorna

Getta
DeviceNotAvailableException

listUtenti

public abstract  listUsers ()

Ottiene l'elenco degli utenti nel dispositivo. Genera DeviceRuntimeException se l'output dal dispositivo non è come previsto.

ritorna
l'elenco degli ID utente.

Getta
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Metodo di supporto per prendere un bugreport e registrarlo ai reporter.

Parametri
dataName String : nome con il quale verrà segnalato il bugreport.

listener ITestLogger : un ITestLogger per registrare il bugreport.

ritorna
boolean True se la registrazione ha avuto successo, false in caso contrario.

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registra un IDeviceActionReceiver per questo dispositivo.

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

Parametri
deviceActionReceiver IDeviceActionReceiver : un IDeviceActionReceiver che verrà registrato.

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

Remove given device admin in given user and return true if it is successful, false otherwise.

Parametri
componentName String : of device admin to be removed.

userId int : of user that the device admin lives in.

ritorna
boolean True if it is successful, false otherwise.

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

Remove all existing device profile owners with the best effort.

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeUser

public abstract boolean removeUser (int userId)

Remove a given user from the device.

Parametri
userId int : of the user to remove

ritorna
boolean true if we were successful in removing the user, false otherwise.

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

Set a device admin component as device owner in given user.

Parametri
componentName String : of device admin to be device owner.

userId int : of the user that the device owner lives in.

ritorna
boolean True if it is successful, false otherwise.

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

See setSetting(int, String, String, String) and performed on system user.

Parametri
namespace String

key String

value String

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

Add a setting value to the namespace of a given user. Some settings will only be available after a reboot. namespace must be one of: {"system", "secure", "global"}

Parametri
userId int

namespace String

key String

value String

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId)

Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP.

Parametri
userId int : of the user to start in the background

ritorna
boolean true if the user was successfully started in the background.

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP. Possible to provide extra flag to wait for the operation to have effect.

Parametri
userId int : of the user to start in the background

waitFlag boolean : will make the command wait until user is started and unlocked.

ritorna
boolean true if the user was successfully started in the background.

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

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

Starts a given user in the background, visible in the given display (ie, allowing the user to launch activities in that display).

NOTE: this command doesn't check if the user exists, display is available, device supports such feature , etc.

Parametri
userId int : of the user to start in the background

displayId int : display to start user visible on

waitFlag boolean : will make the command wait until user is started and unlocked.

ritorna
boolean true if the user was successfully started visible in the background.

Throws
DeviceNotAvailableException

stopUser

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

Stop a given user. Possible to provide extra flags to wait for the operation to have effect, and force terminate the user. Cannot stop current and system user.

Parametri
userId int : of the user to stop.

waitFlag boolean : will make the command wait until user is stopped.

forceFlag boolean : will force stop the user.

ritorna
boolean true if the user was successfully stopped.

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

Stops a given user. If the user is already stopped, this method is a NOOP. Cannot stop current and system user.

Parametri
userId int : of the user to stop.

ritorna
boolean true if the user was successfully stopped.

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId)

Switch to another userId with a default timeout. switchUser(int, long) .

Parametri
userId int

ritorna
boolean True if the new userId matches the userId provider. False otherwise.

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

Switch to another userId with the provided timeout as deadline. Attempt to disable keyguard after user change is successful.

Parametri
userId int

timeout long : to wait before returning false for switch-user failed.

ritorna
boolean True if the new userId matches the userId provider. False otherwise.

Throws
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

Take a bugreport and returns it inside a Bugreport object to handle it. Return null in case of issue. File referenced in the Bugreport object need to be cleaned via Bugreport.close() .

ritorna
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

Uninstall an Android package from device.

Parametri
packageName String : the Android package to uninstall

ritorna
String a String with an error code, or null if success.

Throws
DeviceNotAvailableException if connection with device is lost and cannot be recovered.

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

Uninstall an Android package from device for a given user.

Parametri
packageName String : the Android package to uninstall

userId int : the integer user id to uninstall for.

ritorna
String a String with an error code, or null if success.

Throws
DeviceNotAvailableException if connection with device is lost and cannot be recovered.