Dispositivo di prova

public class TestDevice
extends NativeDevice

java.lang.Oggetto
↳	com.android.tradefed.device.NativeDevice
	↳	com.android.tradefed.device.TestDevice

Sottoclassi dirette conosciute ManagedRemoteDevice , NestedRemoteDevice , RemoteAndroidDevice Dispositivo remoto gestito Un dispositivo in esecuzione all'interno di una macchina virtuale che gestiamo in remoto tramite un'istanza Tradefed all'interno della VM. NestedRemoteDevice Rappresentazione del dispositivo in esecuzione all'interno di una VM Cuttlefish remota. Dispositivo Android remoto Implementazione di un ITestDevice per un dispositivo Android full stack connesso tramite adb connect.

Sottoclassi indirette note LocalAndroidVirtualDevice , RemoteAndroidVirtualDevice LocalAndroidVirtualDevice La classe per i dispositivi virtuali locali in esecuzione sull'host TradeFed. Dispositivo virtuale Android remoto Estende il comportamento di RemoteAndroidDevice per un dispositivo Android full stack in esecuzione in Google Compute Engine (Gce).

---

Implementazione di un ITestDevice per un dispositivo Android full stack

Riepilogo

Classi nidificate
class	TestDevice.MicrodroidBuilder Un builder utilizzato per creare un Microdroid TestDevice.

Campi
public static final String	DISMISS_KEYGUARD_CMD Comandi che possono essere utilizzati per eliminare lo scudo tastiera.

Costruttori pubblici
TestDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Metodi pubblici
boolean	clearErrorDialogs () Tentativo di eliminare eventuali finestre di dialogo di errore attualmente visualizzate sull'interfaccia utente del dispositivo.
int	createUser (String name) Crea un utente con un determinato nome e flag predefiniti 0.
int	createUser (String name, boolean guest, boolean ephemeral) Crea un utente con un determinato nome e i flag forniti
int	createUserNoThrow (String name) Crea un utente con un determinato nome e flag predefiniti 0.
void	disableKeyguard () Tenta di disabilitare il blocco della tastiera.
boolean	doesFileExist (String deviceFilePath) Metodo di supporto per determinare se il file sul dispositivo esiste.
boolean	doesFileExist (String deviceFilePath, int userId) Metodo di supporto per determinare se il file sul dispositivo esiste per un determinato utente.
File	dumpHeap (String process, String devicePath) Tentativo di eseguire il dump dell'heap da system_server.
	getActiveApexes () Recupera le informazioni sugli APEX attivati ​​sul dispositivo.
	getAllSettings (String namespace) Restituisce coppie chiave-valore dello spazio dei nomi richiesto.
String	getAndroidId (int userId) Trova e restituisce l'id android associato a uno userId, nullo se non trovato.
	getAndroidIds () Crea una mappa degli ID Android trovati corrispondenti agli ID utente.
PackageInfo	getAppPackageInfo (String packageName) Recupera informazioni su un pacchetto installato sul dispositivo.
	getAppPackageInfos () Recupera le informazioni dei pacchetti installati sul dispositivo.
DeviceFoldableState	getCurrentFoldableState () Restituisce lo stato pieghevole corrente del dispositivo o null se si sono verificati problemi.
int	getCurrentUser () Restituisce l'id dell'utente attualmente in esecuzione.
	getFoldableStates () Restituisce l'elenco degli stati ripiegabili sul dispositivo.
	getInstalledPackageNames () Recupera i nomi dei pacchetti dell'applicazione presenti sul dispositivo.
KeyguardControllerState	getKeyguardState () Restituisce un oggetto per ottenere lo stato corrente del keyguard o null se non supportato.
	getMainlineModuleInfo () Ottieni le informazioni sui moduli mainline installati sul dispositivo.
int	getMaxNumberOfRunningUsersSupported () Ottieni il numero massimo di utenti in esecuzione simultanei supportati.
int	getMaxNumberOfUsersSupported () Ottieni il numero massimo di utenti supportati.
Process	getMicrodroidProcess ()
Integer	getPrimaryUserId () Restituisce l'ID utente principale.
InputStreamSource	getScreenshot () Acquisisce uno screenshot dal dispositivo.
InputStreamSource	getScreenshot (String format, boolean rescale) Acquisisce uno screenshot dal dispositivo.
InputStreamSource	getScreenshot (String format) Acquisisce uno screenshot dal dispositivo.
InputStreamSource	getScreenshot (long displayId) Acquisisce uno screenshot dal dispositivo a cui è stato assegnato l'ID display.
String	getSetting (String namespace, String key) Vedere getSetting(int, String, String) ed eseguito sull'utente di sistema.
String	getSetting (int userId, String namespace, String key) Restituisce il valore dell'impostazione richiesta.
	getUninstallablePackageNames () Recupera i nomi dei pacchetti dell'applicazione che possono essere disinstallati.
int	getUserFlags (int userId) Trova e restituisce i flag di un dato utente.
	getUserInfos () Ottiene la mappa di useId per UserInfo nel dispositivo.
int	getUserSerialNumber (int userId) Restituisce il numero seriale associato allo userId se trovato, -10000 negli altri casi.
boolean	hasFeature (String feature) Controlla se una funzione è disponibile su un dispositivo.
String	installPackage (File packageFile, boolean reinstall, String... extraArgs) Installa un pacchetto Android sul dispositivo.
String	installPackage (File packageFile, File certFile, boolean reinstall, String... extraArgs) Installa un pacchetto Android sul dispositivo.
String	installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Installa un pacchetto Android sul dispositivo.
String	installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Installa un pacchetto Android sul dispositivo per un determinato utente.
String	installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs) Installa un pacchetto Android sul dispositivo per un determinato utente.
String	installPackages ( packageFiles, boolean reinstall, String... extraArgs) installPackages ( packageFiles, boolean reinstall, String... extraArgs)
String	installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)
String	installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
String	installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs)
String	installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)
String	installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs)
boolean	isAppEnumerationSupported () Controlla se la piattaforma sul dispositivo supporta l'enumerazione delle app
boolean	isMultiUserSupported () Determina se è supportato il multiutente.
boolean	isPackageInstalled (String packageName) Interroga il dispositivo per un determinato nome di pacchetto per verificare se è attualmente installato o meno.
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.
boolean	isUserRunning (int userId) Controlla se un determinato utente è in esecuzione.
boolean	isUserSecondary (int userId) Restituisce se l'utente specificato è un utente secondario in base ai suoi flag.
	listDisplayIds () Raccogli l'elenco degli ID display disponibili sul dispositivo come riportato da "dumpsys SurfaceFlinger".
	listUsers () Ottiene l'elenco degli utenti nel dispositivo.
void	postInvocationTearDown (Throwable exception) Passaggi aggiuntivi per la pulizia richiesta specifica del dispositivo che verrà eseguita al termine della chiamata.
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.
void	removeOwners () Rimuovi tutti i proprietari di profili del dispositivo esistenti con il massimo sforzo.
boolean	removeUser (int userId) Rimuovere un determinato utente dal dispositivo.
boolean	setDeviceOwner (String componentName, int userId) Imposta un componente di amministrazione del dispositivo come proprietario del dispositivo in un determinato utente.
void	setSetting (String namespace, String key, String value) Vedere setSetting(int, String, String, String) ed eseguito sull'utente di sistema.
void	setSetting (int userId, String namespace, String key, String value) Aggiungi un valore di impostazione allo spazio dei nomi di un determinato utente.
void	shutdownMicrodroid ( ITestDevice microdroidDevice) Spegne il dispositivo microdroid, se esiste.
boolean	startUser (int userId) Avvia un determinato utente in background se è attualmente interrotto.
boolean	startUser (int userId, boolean waitFlag) Avvia un determinato utente in background se è attualmente interrotto.
boolean	stopUser (int userId, boolean waitFlag, boolean forceFlag) Arrestare un determinato utente.
boolean	stopUser (int userId) Arresta un determinato utente.
boolean	supportsMicrodroid () Verifica le condizioni preliminari per eseguire un microdroid.
boolean	supportsMicrodroid (boolean protectedVm) Verifica le condizioni preliminari per eseguire un microdroid.
boolean	switchUser (int userId) Passa a un altro ID utente con un timeout predefinito.
boolean	switchUser (int userId, long timeout) Passa a un altro ID utente con il timeout fornito come scadenza.
String	uninstallPackage (String packageName) Disinstalla un pacchetto Android dal dispositivo.
String	uninstallPackageForUser (String packageName, int userId) Disinstalla un pacchetto Android dal dispositivo per un determinato utente.

Metodi protetti
AaptParser	createParser (File appFile)
void	doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason) Esegui un riavvio adb.
long	getCheckNewUserSleep () Esposto per il test.
long	getHostCurrentTime () Esposto per il test
void	prePostBootSetup () Consente a ogni tipo di dispositivo (AndroidNativeDevice, TestDevice) di eseguire l'override di questo metodo per una specifica configurazione post-avvio.

Campi

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

Comandi che possono essere utilizzati per eliminare lo scudo tastiera.

Costruttori pubblici

Dispositivo di prova

public TestDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

Metodi pubblici

clearErrorDialogs

public 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

creare un utente

public 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
DeviceNotAvailableException

creare un utente

public 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
DeviceNotAvailableException

createUserNoThrow

public 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
DeviceNotAvailableException

disabilitareKeyguard

public 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

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

Parametri
deviceFilePath	String : il percorso assoluto del file sul dispositivo da controllare

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

Getta
DeviceNotAvailableException

doesFileExist

public 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

dumpHeap

public 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 rapporto. Null se qualcosa fallisce.

Getta
DeviceNotAvailableException

getActiveApex

public  getActiveApexes ()

Recupera le informazioni sugli APEX attivati ​​sul dispositivo.

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

Getta
DeviceNotAvailableException

getTutte le impostazioni

public  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
DeviceNotAvailableException

getAndroidId

public String getAndroidId (int userId)

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

Parametri
userId	int

ritorna
String

Getta
DeviceNotAvailableException

getAndroidIds

public  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
DeviceNotAvailableException

getAppPackageInfo

public 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
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

Recupera le informazioni dei pacchetti installati sul dispositivo.

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

Getta
DeviceNotAvailableException

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

ritorna
DeviceFoldableState

Getta
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

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

ritorna
int

Getta
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

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

ritorna

Getta
DeviceNotAvailableException

getInstalledPackageNames

public  getInstalledPackageNames ()

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

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

Getta
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

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

Getta
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Ottieni le informazioni sui moduli mainline installati sul dispositivo.

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

Getta
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public 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
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public 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
DeviceNotAvailableException

getMicrodroidProcess

public Process getMicrodroidProcess ()

ritorna
Process	Restituisce il processo del Microdroid VM. Se TestDevice non è un Microdroid, restituisce null.

getPrimaryUserId

public 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
DeviceNotAvailableException

getScreenshot

public 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
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

Acquisisce uno screenshot dal dispositivo. Si consiglia di utilizzare 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
DeviceNotAvailableException

getScreenshot

public 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
DeviceNotAvailableException

getScreenshot

public 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
DeviceNotAvailableException

getSetting

public 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
DeviceNotAvailableException

getSetting

public 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
DeviceNotAvailableException

getUninstallablePackageNames

public  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
DeviceNotAvailableException

getUserFlags

public 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
DeviceNotAvailableException

getUserInfos

public  getUserInfos ()

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

ritorna
	l'elenco degli oggetti UserInfo.

Getta
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

Parametri
userId	int

ritorna
int

Getta
DeviceNotAvailableException

hasFeature

public 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
DeviceNotAvailableException

installPackage

public 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

installPackage

public String installPackage (File packageFile, 
                File certFile, 
                boolean reinstall, 
                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
certFile	File : true se deve essere eseguita una reinstallazione
reinstall	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

installPackage

public 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

installPackageForUser

public 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

installPackageForUser

public 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

installPacchetti

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

Parametri
packageFiles
reinstall	boolean
extraArgs	String

ritorna
String

Getta
DeviceNotAvailableException

installPacchetti

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

Parametri
packageFiles
reinstall	boolean
grantPermissions	boolean
extraArgs	String

ritorna
String

Getta
DeviceNotAvailableException

installPackagesForUser

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

Parametri
packageFiles
reinstall	boolean
grantPermissions	boolean
userId	int
extraArgs	String

ritorna
String

Getta
DeviceNotAvailableException

installPackagesForUser

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

Parametri
packageFiles
reinstall	boolean
userId	int
extraArgs	String

ritorna
String

Getta
DeviceNotAvailableException

installRemotePackages

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

Parametri
remoteApkPaths
reinstall	boolean
grantPermissions	boolean
extraArgs	String

ritorna
String

Getta
DeviceNotAvailableException

installRemotePackages

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

Parametri
remoteApkPaths
reinstall	boolean
extraArgs	String

ritorna
String

Getta
DeviceNotAvailableException

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

Controlla se la piattaforma sul dispositivo supporta l'enumerazione delle app

ritorna
boolean	True se l'enumerazione delle app è supportata, false in caso contrario

Getta
DeviceNotAvailableException

è multiutente supportato

public boolean isMultiUserSupported ()

Determina se è supportato il multiutente.

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

Getta
DeviceNotAvailableException

isPackageInstalled

public 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
DeviceNotAvailableException

isPackageInstalled

public 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
DeviceNotAvailableException

isUserRunning

public 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
DeviceNotAvailableException

isUserSecondary

public 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
DeviceNotAvailableException

listDisplayIds

public  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
DeviceNotAvailableException

listUtenti

public  listUsers ()

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

ritorna
	l'elenco degli ID utente.

Getta
DeviceNotAvailableException

postInvocazioneTearDown

public void postInvocationTearDown (Throwable exception)

Passaggi aggiuntivi per la pulizia richiesta specifica del dispositivo che verrà eseguita al termine della chiamata.

Parametri
exception	Throwable : se presente, l'eccezione finale generata dall'errore di chiamata.

removeAdmin

public 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.

Parametri
componentName	String : dell'amministratore del dispositivo da rimuovere.
userId	int : dell'utente in cui risiede l'amministratore del dispositivo.

ritorna
boolean	Vero se ha successo, falso altrimenti.

Getta
DeviceNotAvailableException

removeOwners

public void removeOwners ()

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

Getta
DeviceNotAvailableException

removeUser

public boolean removeUser (int userId)

Rimuovere un determinato utente dal dispositivo.

Parametri
userId	int : dell'utente da rimuovere

ritorna
boolean	true se siamo riusciti a rimuovere l'utente, false in caso contrario.

Getta
DeviceNotAvailableException

setDeviceOwner

public 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 del dispositivo.
userId	int : dell'utente in cui risiede il proprietario del dispositivo.

ritorna
boolean	Vero se ha successo, falso altrimenti.

Getta
DeviceNotAvailableException

setSetting

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

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

Parametri
namespace	String
key	String
value	String

Getta
DeviceNotAvailableException

setSetting

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

Parametri
userId	int
namespace	String
key	String
value	String

Getta
DeviceNotAvailableException

arresto Microdroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

Spegne il dispositivo microdroid, se esiste.

Parametri
microdroidDevice	ITestDevice

Getta
DeviceNotAvailableException

startUser

public boolean startUser (int userId)

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

Parametri
userId	int : dell'utente da avviare in background

ritorna
boolean	true se l'utente è stato avviato correttamente in background.

Getta
DeviceNotAvailableException

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

Avvia un determinato utente in background se è attualmente interrotto. 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 : farà attendere il comando finché l'utente non viene avviato e sbloccato.

ritorna
boolean	true se l'utente è stato avviato correttamente in background.

Getta
DeviceNotAvailableException

stopUser

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

Arrestare un determinato utente. È possibile fornire flag aggiuntivi per attendere che l'operazione abbia effetto e forzare l'interruzione dell'utente. Impossibile arrestare l'utente corrente e di sistema.

Parametri
userId	int : dell'utente da interrompere.
waitFlag	boolean : farà attendere il comando finché l'utente non viene arrestato.
forceFlag	boolean : forzerà l'arresto dell'utente.

ritorna
boolean	true se l'utente è stato arrestato correttamente.

Getta
DeviceNotAvailableException

stopUser

public boolean stopUser (int userId)

Arresta un determinato utente. Se l'utente è già stato arrestato, questo metodo è un NOOP. Impossibile arrestare l'utente corrente e di sistema.

Parametri
userId	int : dell'utente da interrompere.

ritorna
boolean	true se l'utente è stato arrestato correttamente.

Getta
DeviceNotAvailableException

supporta Microdroid

public boolean supportsMicrodroid ()

Verifica le condizioni preliminari per eseguire un microdroid.

ritorna
boolean	restituisce true se le precondizioni sono soddisfatte, false in caso contrario.

supporta Microdroid

public boolean supportsMicrodroid (boolean protectedVm)

Verifica le condizioni preliminari per eseguire un microdroid.

Parametri
protectedVm	boolean : true se il microdroid deve essere eseguito su una VM protetta.

ritorna
boolean	restituisce true se le precondizioni sono soddisfatte, false in caso contrario.

cambia utente

public boolean switchUser (int userId)

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

Parametri
userId	int

ritorna
boolean	True se il nuovo ID utente corrisponde al provider di ID utente. Falso altrimenti.

Getta
DeviceNotAvailableException

cambia utente

public boolean switchUser (int userId, 
                long timeout)

Passa a un altro ID utente con il timeout fornito come scadenza. Tentativo di disabilitare il blocco della tastiera dopo che la modifica dell'utente è andata a buon fine.

Parametri
userId	int
timeout	long : attendere prima di restituire false per cambio utente non riuscito.

ritorna
boolean	True se il nuovo ID utente corrisponde al provider di ID utente. Falso altrimenti.

Getta
DeviceNotAvailableException

uninstallPackage

public String uninstallPackage (String packageName)

Disinstalla un pacchetto Android dal dispositivo.

Parametri
packageName	String : il pacchetto Android da disinstallare

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

Getta
DeviceNotAvailableException

uninstallPackageForUser

public 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 cui eseguire la disinstallazione.

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

Getta
DeviceNotAvailableException

Metodi protetti

createParser

protected AaptParser createParser (File appFile)

Parametri
appFile	File

ritorna
AaptParser

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

Esegui un riavvio adb.

Parametri
rebootMode	NativeDevice.RebootMode : una modalità di questo riavvio.
reason	String : per questo riavvio.

Getta
DeviceNotAvailableException

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

Esposto per il test.

ritorna
long

getHostCurrentTime

protected long getHostCurrentTime ()

Esposto per il test

ritorna
long

prePostBootSetup

protected void prePostBootSetup ()

Consente a ogni tipo di dispositivo (AndroidNativeDevice, TestDevice) di eseguire l'override di questo metodo per una specifica configurazione post-avvio.

Getta
DeviceNotAvailableException