DispositivoITest

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

Sottoclassi indirette note IManagedTestDevice, LocalAndroidVirtualDevice, ManagedRemoteDevice, NativeDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice, TestDevice IManagedTestDevice Un ITestDevice il cui ciclo di vita è gestito.  LocalAndroidVirtualDevice La classe per i dispositivi virtuali locali in esecuzione sull'host TradeFed.  ManagedRemoteDevice Un dispositivo in esecuzione all'interno di una macchina virtuale da noi gestita da remoto tramite un'istanza Tradefed all'interno la VM.  Dispositivo nativo Implementazione predefinita di ITestDevice dispositivi Android non full stack.  NestedRemoteDevice Rappresentazione del dispositivo in esecuzione all'interno di una VM Cuttlefish remota.  DispositivoAndroidRemote Implementazione di un ITestDevice per un dispositivo Android full stack connesso tramite ADB Connect.  RemoteAndroidVirtualDevice Estende il comportamento di RemoteAndroidDevice per un dispositivo Android full stack in esecuzione in Google Compute Engine (Gce).  Dispositivo di test Implementazione di un ITestDevice per un dispositivo Android full stack

---

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

Nuovi comandi del dispositivo per un numero configurabile e fornisce un recupero 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 le informazioni su un singolo punto di montaggio

Metodi pubblici
abstract boolean	canSwitchToHeadlessSystemUser() Indica se è consentito passare all'utente SYSTEM headless.
abstract boolean	checkConnectivity() Verifica la connettività di rete del dispositivo.
abstract boolean	clearErrorDialogs() Prova a chiudere le eventuali finestre di dialogo di errore attualmente visualizzate nell'interfaccia utente del dispositivo.
abstract void	clearLastConnectedWifiNetwork() Cancella l'ultima rete Wi-Fi connessa.
abstract boolean	connectToWifiNetwork( wifiSsidToPsk) Si connette a una rete Wi-Fi.
abstract boolean	connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid) Si connette a una rete Wi-Fi.
abstract boolean	connectToWifiNetwork(String wifiSsid, String wifiPsk) Si connette a una rete Wi-Fi.
abstract boolean	connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid) Si connette a una rete Wi-Fi.
abstract boolean	connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid) Una variante di connectToWifiNetwork(String, String) che si connette solo se il dispositivo attualmente non 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 pari a 0.
abstract int	createUser(String name, boolean guest, boolean ephemeral) Crea un utente con un determinato nome e i flag forniti
abstract int	createUser(String name, boolean guest, boolean ephemeral, boolean forTesting) Crea un utente con un determinato nome e i flag forniti
abstract int	createUserNoThrow(String name) Crea un utente con un determinato nome e flag predefiniti pari a 0.
abstract void	deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver) Rimuove la registrazione di IDeviceActionReceiver.
abstract void	disableKeyguard() Tenta di disattivare il blocco della tastiera.
abstract boolean	disableNetworkMonitor() Disattiva il monitoraggio della rete sul dispositivo.
abstract boolean	disconnectFromWifi() Si disconnette da una rete Wi-Fi.
abstract boolean	doesFileExist(String deviceFilePath, int userId) Metodo di supporto per determinare se esiste un file sul dispositivo per un determinato utente.
abstract File	dumpHeap(String process, String devicePath) Tenta 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 restituisci l'android-id associato a un userId, null se non trovato.
abstract	getAndroidIds() Crea una mappa degli ID Android trovati con ID utente corrispondenti.
abstract PackageInfo	getAppPackageInfo(String packageName) Recupera informazioni su un pacchetto installato sul dispositivo.
abstract	getAppPackageInfos() Recupera informazioni sui pacchetti installati sul dispositivo.
abstract InputStreamSource	getBugreport() Recupera una segnalazione di bug dal dispositivo.
abstract InputStreamSource	getBugreportz() Recupera una segnalazione di bug dal dispositivo.
abstract DeviceFoldableState	getCurrentFoldableState() Restituisce l'attuale stato pieghevole del dispositivo o nullo se si sono verificati alcuni problemi.
abstract int	getCurrentUser() Restituisce l'ID dell'utente corrente in esecuzione.
abstract	getFoldableStates() Restituisce l'elenco degli stati pieghevoli sul dispositivo.
abstract	getInstalledPackageNames() Recupera i nomi dei pacchetti dell'applicazione presenti sul dispositivo.
abstract String	getIpAddress() Recupera l'indirizzo IP del dispositivo.
abstract KeyguardControllerState	getKeyguardState() Restituisci un oggetto per ottenere lo stato attuale del blocco della tastiera o null se non supportato.
abstract Integer	getMainUserId() Restituisce l'ID utente principale.
abstract	getMainlineModuleInfo() Recupera le informazioni sui moduli di linea principali installati sul dispositivo.
abstract int	getMaxNumberOfRunningUsersSupported() Ottieni il numero massimo di utenti supportati in esecuzione contemporaneamente.
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(String format, boolean rescale) Acquisisce uno screenshot dal dispositivo.
abstract InputStreamSource	getScreenshot(String format) Acquisisce uno screenshot dal dispositivo.
abstract InputStreamSource	getScreenshot(long displayId) Recupera uno screenshot dall'ID display del dispositivo specificato.
abstract InputStreamSource	getScreenshot() Acquisisce uno screenshot dal dispositivo.
abstract String	getSetting(int userId, String namespace, String key) Restituisce il valore dell'impostazione richiesta.
abstract String	getSetting(String namespace, String key) Vedi getSetting(int, String, String) ed eseguita sull'utente del sistema.
abstract	getUninstallablePackageNames() Recupera i nomi dei pacchetti dell'applicazione che possono essere disinstallati.
abstract int	getUserFlags(int userId) Trova e restituisci i flag di un determinato utente.
abstract	getUserInfos() Recupera la mappa di useId per UserInfo sul dispositivo.
abstract int	getUserSerialNumber(int userId) Restituisce il numero di serie associato allo userId, se trovato, -10000 in tutti gli altri casi.
abstract boolean	hasFeature(String feature) Controlla se una funzionalità è disponibile su un dispositivo.
abstract String	installPackage(File packageFile, boolean reinstall, String... extraArgs) Installa un pacchetto Android sul dispositivo.
abstract String	installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Installa un pacchetto Android sul dispositivo.
abstract String	installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs) Installa un pacchetto Android sul dispositivo di un determinato utente.
abstract String	installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Installa un pacchetto Android sul dispositivo di un determinato utente.
default String	installPackages( packageFiles, boolean reinstall, String... extraArgs) Installa un'applicazione Android composta da diversi file APK (un pacchetto di suddivisione principale e uno aggiuntivo).
default String	installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) Installa un'applicazione Android composta da diversi file APK (un pacchetto di suddivisione principale e uno aggiuntivo) presenti sul dispositivo Android.
default String	installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs) Installa un'applicazione Android composta da diversi file APK (un pacchetto di suddivisione principale e uno aggiuntivo) per un determinato utente.
default String	installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Installa un'applicazione Android composta da diversi file APK (un pacchetto di suddivisione principale e uno aggiuntivo) per un determinato utente.
default String	installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs) Installa un'applicazione Android composta da diversi file APK (un pacchetto di suddivisione principale e uno aggiuntivo) presenti sul dispositivo Android.
default String	installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) Installa un'applicazione Android composta da diversi file APK (un pacchetto di suddivisione principale e uno aggiuntivo) presenti sul dispositivo Android.
abstract boolean	isHeadlessSystemUserMode() Indica se il dispositivo utilizza la modalità utente di sistema headless.
abstract boolean	isMainUserPermanentAdmin() Indica se l'utente principale è un amministratore permanente e non può essere eliminato o eseguito il downgrade a non amministratore.
abstract boolean	isMultiUserSupported() Determina se la funzionalità multiutente è supportata.
abstract boolean	isPackageInstalled(String packageName, String userId) Esegui una query sul dispositivo per trovare un dato nome pacchetto e un dato ID utente per verificare se al momento installato o meno per quell'utente.
abstract boolean	isPackageInstalled(String packageName) Esegui una query sul dispositivo per trovare un determinato nome di pacchetto per verificare se il pacchetto è attualmente installato o meno.
abstract boolean	isUserRunning(int userId) Verificare se un determinato utente è in esecuzione.
abstract boolean	isUserSecondary(int userId) Indica se l'utente specificato è un utente secondario in base ai flag.
abstract boolean	isUserVisible(int userId) Controlla se l'utente specificato è visibile.
abstract boolean	isUserVisibleOnDisplay(int userId, int displayId) Controlla se l'utente è visibile sul display specificato.
abstract boolean	isVisibleBackgroundUsersOnDefaultDisplaySupported() Indica se il dispositivo consente agli utenti di essere avviati visibili in background in ERROR(/java.android.view.Display#DEFAULT_DISPLAY).
abstract boolean	isVisibleBackgroundUsersSupported() Indica se il dispositivo consente agli utenti di essere avviati visibili in background.
abstract boolean	isWifiEnabled() Verifica che il Wi-Fi sia attivo.
abstract	listDisplayIds() Raccogli l'elenco degli ID dei display disponibili sul dispositivo segnalato da "dumpsys SurfaceFlinger".
abstract	listDisplayIdsForStartingVisibleBackgroundUsers() Recupera l'elenco di display che possono essere utilizzati per start a user visible in the background.
abstract	listUsers() Recupera l'elenco di utenti presenti sul dispositivo.
abstract boolean	logBugreport(String dataName, ITestLogger listener) Metodo di supporto per inviare una segnalazione di bug e registrarla agli autori di segnalazioni.
default void	notifySnapuserd(SnapuserdWaitPhase waitPhase) Invia una notifica al dispositivo affinché attenda il completamento dello snapshot.
abstract void	registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver) Registra un IDeviceActionReceiver per questo dispositivo.
abstract boolean	removeAdmin(String componentName, int userId) Rimuovi l'amministratore del dispositivo specificato per l'utente e restituisci true se l'operazione ha esito positivo, false in caso contrario.
abstract void	removeOwners() Rimuovi tutti i proprietari di profili esistenti del dispositivo con il massimo impegno.
abstract boolean	removeUser(int userId) Rimuovere un determinato utente dal dispositivo.
abstract boolean	setDeviceOwner(String componentName, int userId) Imposta un componente di amministrazione del dispositivo come proprietario del dispositivo in un determinato utente.
abstract void	setSetting(String namespace, String key, String value) Vedi setSetting(int, String, String, String) ed eseguita sull'utente del 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 al momento è arrestato.
abstract boolean	startUser(int userId, boolean waitFlag) Avvia un determinato utente in background se al momento è arrestato.
abstract boolean	startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag) Avvia un determinato utente in background, visibile sul display specificato (ad esempio, consentendo all'utente per avviare attività in quel display).
abstract boolean	stopUser(int userId) Arresta un determinato utente.
abstract boolean	stopUser(int userId, boolean waitFlag, boolean forceFlag) Interrompere un determinato utente.
abstract boolean	switchUser(int userId) Passa a un altro ID utente con un timeout predefinito.
abstract boolean	switchUser(int userId, long timeout) Passa a un altro userId con il timeout fornito come scadenza.
abstract Bugreport	takeBugreport() Prendi una segnalazione di bug e restituila all'interno di un oggetto Bugreport per gestirla.
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.
default void	waitForSnapuserd(SnapuserdWaitPhase currentPhase) Se previsto, attendi il completamento dello snapshot.

Metodi pubblici

CANNOT TRANSLATE

public abstract boolean canSwitchToHeadlessSystemUser ()

Indica se è consentito passare all'utente SYSTEM headless.

Ritorni
boolean

Lanci
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity ()

Verifica la connettività di rete del dispositivo.

Ritorni
boolean	true se il dispositivo ha una connessione di rete funzionante, false in modo eccessivo.

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.

Finestra di dialogo di errore

public abstract boolean clearErrorDialogs ()

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

Ritorni
boolean	true se non erano presenti finestre di dialogo o se sono state cancellate correttamente. false in caso contrario.

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.

cancellaUltimaReteWifiConnessa

public abstract void clearLastConnectedWifiNetwork ()

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

connettitiaallareteWifi

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Si connette a una rete Wi-Fi.

Attiva il Wi-Fi e si blocca finché non viene stabilita una connessione con una rete Wi-Fi reti specificate nella mappa wifiSsidToPsk. Dopo aver stabilito una connessione, l'istanza proverà a Ripristina la connessione dopo ogni riavvio fino al giorno ITestDevice#disconnectFromWifi() oppure ITestDevice#clearLastConnectedWifiNetwork() ha chiamato.

Parametri
wifiSsidToPsk	: una mappa degli SSID delle reti Wi-Fi alle password.

Ritorni
boolean	true in caso di connessione alla rete Wi-Fi. false altrimenti

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.

connettitiaallareteWifi

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Si connette a una rete Wi-Fi.

Attiva il Wi-Fi e si blocca finché non viene stabilita una connessione con una rete Wi-Fi reti specificate nella mappa wifiSsidToPsk. Dopo aver stabilito una connessione, l'istanza proverà a Ripristina la connessione dopo ogni riavvio fino al giorno ITestDevice#disconnectFromWifi() oppure ITestDevice#clearLastConnectedWifiNetwork() ha chiamato.

Parametri
wifiSsidToPsk	: una mappa degli SSID delle reti Wi-Fi alle password.
scanSsid	boolean: indica se cercare gli SSID nascosti per questa rete.

Ritorni
boolean	true in caso di connessione alla rete Wi-Fi. false altrimenti

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.

connettitiaallareteWifi

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Si connette a una rete Wi-Fi.

Attiva il Wi-Fi e si blocca finché non viene stabilita una connessione alla rete Wi-Fi specificata. Una volta stabilita una connessione, l'istanza proverà a ripristinare la connessione dopo ogni riavvio fino al giorno ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork() ha chiamato.

Parametri
wifiSsid	String: l'SSD Wi-Fi a cui connetterti
wifiPsk	String: passphrase PSK o null se non criptata

Ritorni
boolean	true in caso di connessione alla rete Wi-Fi. false altrimenti

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.

connettitiaallareteWifi

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

Si connette a una rete Wi-Fi.

Attiva il Wi-Fi e si blocca finché non viene stabilita una connessione alla rete Wi-Fi specificata. Una volta stabilita una connessione, l'istanza proverà a ripristinare la connessione dopo ogni riavvio fino al giorno ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork() ha chiamato.

Parametri
wifiSsid	String: l'SSD Wi-Fi a cui connetterti
wifiPsk	String: passphrase PSK o null se non criptata
scanSsid	boolean: indica se cercare l'SSID nascosto per questa rete.

Ritorni
boolean	true in caso di connessione alla rete Wi-Fi. false altrimenti

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.

connettitiallareteWifiIfNeeded

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

Ritorni
boolean	true in caso di connessione alla rete Wi-Fi. false altrimenti

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

connettitiallareteWifiIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

Ritorni
boolean	true in caso di connessione alla rete Wi-Fi. false altrimenti

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

CreaUtente

public abstract int createUser (String name)

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

Parametri
name	String: dell'utente da creare sul dispositivo

Ritorni
int	Il numero intero per l'ID utente creato

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

CreaUtente

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: attiva il flag utente --guest durante la creazione
ephemeral	boolean: abilita il flag utente --temporaneo durante la creazione

Ritorni
int	ID dell'utente creato

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

CreaUtente

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: attiva il flag utente --guest durante la creazione
ephemeral	boolean: abilita il flag utente --temporaneo durante la creazione
forTesting	boolean: abilita il flag di test --for-testing durante la creazione

Ritorni
int	ID dell'utente creato

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

CreaUtenteNoThrow

public abstract int createUserNoThrow (String name)

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

Parametri
name	String: dell'utente da creare sul dispositivo

Ritorni
int	Il numero intero per l'ID utente creato o -1 per l'errore.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

annullaregistrazioneDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Rimuove la registrazione di IDeviceActionReceiver.

Parametri
deviceActionReceiver	IDeviceActionReceiver: un IDeviceActionReceiver che verrà rimosso.

disattiva KeyGuard

public abstract void disableKeyguard ()

Tenta di disattivare il blocco della tastiera.

Prima di tutto attendi che l'invio di input sia pronto, questo avviene più o meno nello stesso momento in cui dispositivo segnala BOOT_COMPLETE, apparentemente in modo asincrono, perché il framework attuale l'implementazione presenta race condizione occasionali. Viene quindi inviato un comando per ignorare il blocco tastiera (funziona solo su quelle non sicure)

Lanci
DeviceNotAvailableException

disattivareNetworkMonitor

public abstract boolean disableNetworkMonitor ()

Disattiva il monitoraggio della rete sul dispositivo.

Ritorni
boolean	true se il monitoraggio è disabilitato correttamente. false se l'operazione non riesce.

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.

disconnetti daWifi

public abstract boolean disconnectFromWifi ()

Si disconnette da una rete Wi-Fi.

Rimuove tutte le reti dall'elenco di reti note e disattiva il Wi-Fi.

Ritorni
boolean	true in caso di disconnessione dalla rete Wi-Fi. false se la disconnessione non è riuscita.

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.

fileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

Parametri
deviceFilePath	String: il percorso assoluto del file sul dispositivo da verificare
userId	int: l'ID utente in base al quale verificare l'esistenza del file

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

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

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

Parametri
process	String: il nome del processo del dispositivo su cui eseguire il dump dell'heap.
devicePath	String: il percorso sul dispositivo in cui posizionare il dump. Deve essere una posizione in cui se le autorizzazioni lo consentono.

Ritorni
File	ERROR(/File) contenente il report. Null se si è verificato un errore.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

abilitaNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Abilita il monitoraggio della rete sul dispositivo.

Ritorni
boolean	true se il monitoraggio è abilitato correttamente. false se l'operazione non riesce.

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.

getActiveApexes

public abstract  getActiveApexes ()

Recupera le informazioni sugli APEX attivati sul dispositivo.

Ritorni
	Attualmente attivi sul dispositivo: ERROR(/Set) di ApexInfo

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

Restituisce coppie chiave-valore dello spazio dei nomi richiesto.

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

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

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

Parametri
userId	int

Ritorni
String

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getAndroidId

public abstract  getAndroidIds ()

Crea una mappa degli ID Android trovati con ID utente corrispondenti. Non esiste alcuna assicurazione che ogni utente id troverà un ID Android associato in questa funzione, pertanto alcuni ID utente potrebbero corrispondere a un valore nullo.

Ritorni
	Mappa di ID Android corrispondenti a ID utente.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

Recupera informazioni su un pacchetto installato sul dispositivo.

Parametri
packageName	String

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

Recupera informazioni sui pacchetti installati sul dispositivo.

Ritorni
	ERROR(/List) di PackageInfo installati sul dispositivo.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getBugreport

public abstract InputStreamSource getBugreport ()

Recupera una segnalazione di bug dal dispositivo.

L'implementazione di questa funzionalità garantisce che il dispositivo continui a funzionare su un dispositivo privo di scheda SD (o nel punto in cui la scheda SD non è ancora montata).

Ritorni
InputStreamSource	Un InputStreamSource che produrrà i contenuti della segnalazione di bug on demand. Nella in caso di errore, InputStreamSource produrrà un ERROR(/InputStream) vuoto.

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

Supportata solo per la "versione adb" > 1,0.36

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

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

Ritorni
DeviceFoldableState

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

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

Ritorni
int

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

Restituisce l'elenco degli stati pieghevoli sul dispositivo. Può essere ottenuto con "cmd device_state" stati di stampa".

Ritorni

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getInstallaPackageNames

public abstract  getInstalledPackageNames ()

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

Ritorni
	ERROR(/Set) nomi di pacchetti su String attualmente installati sul dispositivo.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Recupera l'indirizzo IP del dispositivo.

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

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

Restituisci un oggetto per ottenere lo stato attuale del blocco della tastiera o null se non supportato.

Ritorni
KeyguardControllerState	un elemento KeyguardControllerState contenente uno snapshot dello stato del blocco tastiera e restituisce Null se la query Keyguard non è supportata.

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.

getMainUserId

public abstract Integer getMainUserId ()

Restituisce l'ID utente principale.

Ritorni
Integer	l'ID utente dell'utente principale, se presente, e nullo, se non esiste un utente principale.

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

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

Recupera le informazioni sui moduli di linea principali installati sul dispositivo.

Ritorni
	ERROR(/Set) di String moduli di linea principali attualmente installati sul dispositivo.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

Ritorni
int	un numero intero che indica il numero di utenti che eseguono contemporaneamente

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

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

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getOpzioni

public abstract TestDeviceOptions getOptions ()

Recupera le opzioni di test per il dispositivo.

Ritorni
TestDeviceOptions	TestDeviceOptions relativi al dispositivo sottoposto a test.

IDUtentePrincipale

public abstract Integer getPrimaryUserId ()

Restituisce l'ID utente principale.

Ritorni
Integer	l'ID utente dell'utente principale, se presente, e nullo, se non esiste un utente principale.

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

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

Acquisisce uno screenshot dal dispositivo. È consigliabile usare invece getScreenshot(String) con codifica JPEG per dimensioni inferiori.

Parametri
format	String: PNG, JPEG supportato
rescale	boolean: se lo screenshot deve essere ridimensionato per ridurre le dimensioni dell'immagine risultante

Ritorni
InputStreamSource	una InputStreamSource dello screenshot in formato o null se screenshot non riuscito.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

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

Parametri
format	String: PNG, JPEG supportato

Ritorni
InputStreamSource	una InputStreamSource dello screenshot in formato o null se lo screenshot non è riuscito.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

Recupera uno screenshot dall'ID display del dispositivo specificato. Il formato è PNG.

DA FARE: estendi le implementazioni precedenti per supportare il "formato" e poi scalare

Parametri
displayId	long: l'ID di visualizzazione dello schermo da cui recuperare lo screenshot.

Ritorni
InputStreamSource	InputStreamSource dello screenshot in formato o null se screenshot non riuscito.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

Acquisisce uno screenshot dal dispositivo.

Ritorni
InputStreamSource	Una InputStreamSource dello screenshot in formato PNG o null se lo screenshot non è riuscito.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getImpostazione

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

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

Parametri
userId	int
namespace	String
key	String

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getImpostazione

public abstract String getSetting (String namespace, 
                String key)

Vedi getSetting(int, String, String) ed eseguita sull'utente del sistema.

Parametri
namespace	String
key	String

Ritorni
String

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

getDisinstallaablePackageNames

public abstract  getUninstallablePackageNames ()

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

Ritorni
	ERROR(/Set) dei nomi di pacchetti String disinstallabili attualmente installati nell' dispositivo.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

Flag User

public abstract int getUserFlags (int userId)

Trova e restituisci i flag di un determinato utente. I flag sono definiti in "android.content.pm.UserInfo" nel progetto open source Android.

Parametri
userId	int

Ritorni
int	i flag associati allo userId fornito, se trovato, -10000 in tutti gli altri casi.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

OttieniInfoUtente

public abstract  getUserInfos ()

Recupera la mappa di useId per UserInfo sul dispositivo. Se l'output dal dispositivo non è quello previsto, verrà generato DeviceRuntimeException.

Ritorni
	l'elenco di oggetti UserInfo.

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

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

Parametri
userId	int

Ritorni
int

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

hasFeature

public abstract boolean hasFeature (String feature)

Controlla se una funzionalità è disponibile su un dispositivo.

Parametri
feature	String: quale formato deve essere "feature:" o "" .

Ritorni
boolean	True se la caratteristica viene trovata, false in caso contrario.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
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 è necessario eseguire una reinstallazione
extraArgs	String: argomenti aggiuntivi facoltativi da passare. Vedi "adb shell pm -h" per disponibili le opzioni di CPU e memoria disponibili.

Ritorni
String	String con un codice di errore o null in caso di esito positivo.

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.

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 la data e l'ora di installazione devono chiamare questa funzione.

Parametri
packageFile	File: il file APK da installare
reinstall	boolean: true se è necessario eseguire una reinstallazione
grantPermissions	boolean: se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione
extraArgs	String: argomenti aggiuntivi facoltativi da passare. Vedi "adb shell pm -h" per disponibile le opzioni di CPU e memoria disponibili.

Ritorni
String	String con un codice di errore o null in caso di esito positivo.

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.
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 di un determinato utente.

Parametri
packageFile	File: il file APK da installare
reinstall	boolean: true se è necessario eseguire una reinstallazione
userId	int: l'ID utente intero per il quale eseguire l'installazione.
extraArgs	String: argomenti aggiuntivi facoltativi da passare. Vedi "adb shell pm -h" per disponibile le opzioni di CPU e memoria disponibili.

Ritorni
String	String con un codice di errore o null in caso di esito positivo.

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.

installPackageForUser

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

Installa un pacchetto Android sul dispositivo di un determinato utente.

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

Parametri
packageFile	File: il file APK da installare
reinstall	boolean: true se è necessario eseguire una reinstallazione
grantPermissions	boolean: se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione
userId	int: l'ID utente intero per il quale eseguire l'installazione.
extraArgs	String: argomenti aggiuntivi facoltativi da passare. Vedi "adb shell pm -h" per disponibile le opzioni di CPU e memoria disponibili.

Ritorni
String	String con un codice di errore o null in caso di esito positivo.

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.
UnsupportedOperationException	se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

installPackages

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

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

Parametri
packageFiles	: i file apk locali
reinstall	boolean: true se è necessario eseguire una reinstallazione
extraArgs	String: argomenti aggiuntivi facoltativi da passare. Vedi "adb shell pm -h" per disponibili le opzioni di CPU e memoria disponibili.

Ritorni
String	String con un codice di errore o null in caso di esito positivo.

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.
UnsupportedOperationException	se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

installPackages

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

Installa un'applicazione Android composta da diversi file APK (un pacchetto di suddivisione principale e uno aggiuntivo) presenti sul dispositivo Android. Consulta "https://developer.android.com/studio/build/configure-apk-splits" su come dividere l'APK diversi file.

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

Parametri
packageFiles	: i percorsi dei file APK remoti da installare
reinstall	boolean: true se è necessario eseguire una reinstallazione
grantPermissions	boolean: se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione
extraArgs	String: argomenti aggiuntivi facoltativi da passare. Vedi "adb shell pm -h" per disponibile le opzioni di CPU e memoria disponibili.

Ritorni
String	String con un codice di errore o null in caso di esito positivo.

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.
UnsupportedOperationException	se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

installPackagesForUser

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

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

Parametri
packageFiles	: i file apk locali
reinstall	boolean: true se è necessario eseguire una reinstallazione
userId	int: l'ID utente intero per il quale eseguire l'installazione.
extraArgs	String: argomenti aggiuntivi facoltativi da passare. Vedi "adb shell pm -h" per disponibile le opzioni di CPU e memoria disponibili.

Ritorni
String	String con un codice di errore o null in caso di esito positivo.

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.
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 di suddivisione principale e uno aggiuntivo) per un determinato utente. Vedi "https://developer.android.com/studio/build/configure-apk-splits" attivo 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 la data e l'ora di installazione devono chiamare questa funzione.

Parametri
packageFiles	: i file apk locali
reinstall	boolean: true se è necessario eseguire una reinstallazione
grantPermissions	boolean: se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione
userId	int: l'ID utente intero per il quale eseguire l'installazione.
extraArgs	String: argomenti aggiuntivi facoltativi da passare. Vedi "adb shell pm -h" per disponibile le opzioni di CPU e memoria disponibili.

Ritorni
String	String con un codice di errore o null in caso di esito positivo.

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.
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 di suddivisione principale e uno aggiuntivo) presenti sul dispositivo Android. Consulta "https://developer.android.com/studio/build/configure-apk-splits" su come dividere l'APK diversi file.

Parametri
remoteApkPaths	: i percorsi dei file apk remoti
reinstall	boolean: true se è necessario eseguire una reinstallazione
extraArgs	String: argomenti aggiuntivi facoltativi da passare. Vedi "adb shell pm -h" per disponibili le opzioni di CPU e memoria disponibili.

Ritorni
String	String con un codice di errore o null in caso di esito positivo.

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.
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 di suddivisione principale e uno aggiuntivo) presenti sul dispositivo Android. Consulta "https://developer.android.com/studio/build/configure-apk-splits" su come dividere l'APK diversi file.

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

Parametri
remoteApkPaths	: i percorsi dei file apk remoti
reinstall	boolean: true se è necessario eseguire una reinstallazione
grantPermissions	boolean: se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione
extraArgs	String: argomenti aggiuntivi facoltativi da passare. Vedi "adb shell pm -h" per disponibile le opzioni di CPU e memoria disponibili.

Ritorni
String	String con un codice di errore o null in caso di esito positivo.

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.
UnsupportedOperationException	se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

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

Ritorni
boolean

Lanci
DeviceNotAvailableException

èAmministratorePermanenteUtentePrincipale

public abstract boolean isMainUserPermanentAdmin ()

Indica se l'utente principale è un amministratore permanente e non può essere eliminato o eseguito il downgrade a non amministratore.

Ritorni
boolean

Lanci
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

Determina se la funzionalità multiutente è supportata.

Ritorni
boolean	true se la funzionalità multiutente è supportata, false negli altri casi

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

èPacchettoInstallato

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

Esegui una query sul dispositivo per trovare un dato nome pacchetto e un dato ID utente per verificare se al momento installato o meno per quell'utente.

Parametri
packageName	String: il pacchetto che stiamo controllando se è installato.
userId	String: l'ID utente per il quale stiamo controllando l'installazione del pacchetto. Se nullo, l'utente principale 0.

Ritorni
boolean	True se il pacchetto è segnalato come installato. Falso negli altri casi.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

èPacchettoInstallato

public abstract boolean isPackageInstalled (String packageName)

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

Parametri
packageName	String

Ritorni
boolean	True se il pacchetto è segnalato come installato. Falso negli altri casi.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

èIn esecuzioneUtente

public abstract boolean isUserRunning (int userId)

Verificare se un determinato utente è in esecuzione.

Parametri
userId	int

Ritorni
boolean	True se l'utente è in esecuzione, falso negli altri casi.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

èUtenteSecondario

public abstract boolean isUserSecondary (int userId)

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

Parametri
userId	int

Ritorni
boolean	true se l'utente è secondario, false negli altri casi.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

UtenteVisibile

public abstract boolean isUserVisible (int userId)

Controlla se l'utente specificato è visibile.

Un "visibile" l'utente è un utente che sta interagendo con l'"umano" all'utente e, di conseguenza, può avviare attività di avvio (di solito, nella visualizzazione predefinita).

Parametri
userId	int

Ritorni
boolean

Lanci
DeviceNotAvailableException

UtenteVisibileSuDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Controlla se l'utente è visibile sul display specificato.

Un "visibile" l'utente è un utente che sta interagendo con l'"umano" all'utente e, di conseguenza, può avviare attività di lancio in quel display.

Parametri
userId	int
displayId	int

Ritorni
boolean

Lanci
DeviceNotAvailableException

isVisibileBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

Ritorni
boolean

Lanci
DeviceNotAvailableException

èVisibileUtentiSfondoSupportato

public abstract boolean isVisibleBackgroundUsersSupported ()

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

In caso affermativo, potresti chiamare startVisibleBackgroundUser(int, int, boolean), superando un display restituito da listDisplayIdsForStartingVisibleBackgroundUsers().

Ritorni
boolean

Lanci
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Verifica che il Wi-Fi sia attivo.

Controlla se il Wi-Fi è attivo sul dispositivo. Utile per dichiarare lo stato del Wi-Fi prima di testare non deve funzionare con Wi-Fi, ad esempio test dei dati mobili.

Ritorni
boolean	true se il Wi-Fi è attivo. false se disattivato

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.

listDisplayId

public abstract  listDisplayIds ()

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

Ritorni
	L'elenco delle visualizzazioni. L'impostazione predefinita restituisce sempre 0 come visualizzazione predefinita.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

listDisplayIdsForStartingVisibilityBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Ritorni

Lanci
DeviceNotAvailableException

elencoUtenti

public abstract  listUsers ()

Recupera l'elenco di utenti presenti sul dispositivo. Se output verrà generato DeviceRuntimeException dal dispositivo non è come previsto.

Ritorni
	l'elenco degli ID utente.

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

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

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

Parametri
dataName	String: nome con cui verrà segnalata la segnalazione di bug.
listener	ITestLogger: un ITestLogger per registrare la segnalazione di bug.

Ritorni
boolean	True se il logging è riuscito, false in caso contrario.

avvisaSnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Invia una notifica al dispositivo affinché attenda il completamento dello snapshot.

Parametri
waitPhase	SnapuserdWaitPhase

registriDispositivoAzioneRicevitore

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registra un IDeviceActionReceiver per questo dispositivo.

Tutti gli utenti IDeviceActionReceiver registrati riceveranno una notifica prima di un'azione del dispositivo l'avvio e il termine dell'azione sul dispositivo.

Parametri
deviceActionReceiver	IDeviceActionReceiver: un IDeviceActionReceiver che verrà registrato.

rimuovereAmministratore

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

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

Ritorni
boolean	True se ha esito positivo, falso in caso contrario.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

rimuoviProprietari

public abstract void removeOwners ()

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

rimuovereUtente

public abstract boolean removeUser (int userId)

Rimuovere un determinato utente dal dispositivo.

Parametri
userId	int: dell'utente da rimuovere

Ritorni
boolean	true se la rimozione dell'utente è riuscita, false in caso contrario.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

impostaProprietarioDispositivo

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

Parametri
componentName	String: dell'amministratore del dispositivo come proprietario.
userId	int: dell'utente in cui risiede il proprietario del dispositivo.

Ritorni
boolean	True se ha esito positivo, falso in caso contrario.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

impostazioniImpostazione

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

Vedi setSetting(int, String, String, String) ed eseguita sull'utente del sistema.

Parametri
namespace	String
key	String
value	String

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

impostazioniImpostazione

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

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

Parametri
userId	int
namespace	String
key	String
value	String

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

UtenteInizio

public abstract boolean startUser (int userId)

Avvia un determinato utente in background se al momento è arrestato. Se l'utente è già in esecuzione in background, questo metodo è un NOOP.

Parametri
userId	int: dell'utente con cui iniziare in background

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

UtenteInizio

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

Parametri
userId	int: dell'utente con cui iniziare in background
waitFlag	boolean: attenderà che l'utente venga avviato e sbloccato.

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

inizioVisibileUtenteSfondo

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

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

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

Parametri
userId	int: dell'utente con cui iniziare in background
displayId	int: display su cui l'utente può essere visibile
waitFlag	boolean: attenderà che l'utente venga avviato e sbloccato.

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

Lanci
DeviceNotAvailableException

Utente bloccato

public abstract boolean stopUser (int userId)

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

Parametri
userId	int: dell'utente da interrompere.

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

Utente bloccato

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

Interrompere un determinato utente. È possibile fornire flag aggiuntivi per attendere l'efficacia dell'operazione. e forzare la chiusura dell'utente. Impossibile interrompere l'utente corrente e di sistema.

Parametri
userId	int: dell'utente da interrompere.
waitFlag	boolean: attenderà finché l'utente non verrà arrestato.
forceFlag	boolean: forza l'interruzione dell'utente.

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

cambiautente

public abstract boolean switchUser (int userId)

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

Parametri
userId	int

Ritorni
boolean	True se il nuovo userId corrisponde al provider userId. Falso negli altri casi.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

cambiautente

public abstract boolean switchUser (int userId, 
                long timeout)

Passa a un altro userId con il timeout fornito come scadenza. Tentativo di disattivare 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.

Ritorni
boolean	True se il nuovo userId corrisponde al provider userId. Falso negli altri casi.

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
DeviceNotAvailableException

prendereBugreport

public abstract Bugreport takeBugreport ()

Prendi una segnalazione di bug e restituila all'interno di un oggetto Bugreport per gestirla. Restituisce null in caso di problemi. Il file a cui viene fatto riferimento nell'oggetto Bugreport deve essere cancellato tramite Bugreport.close().

Ritorni
Bugreport

disinstalla il pacchetto

public abstract String uninstallPackage (String packageName)

Disinstalla un pacchetto Android dal dispositivo.

Parametri
packageName	String: il pacchetto Android da disinstallare

Ritorni
String	String con un codice di errore o null in caso di esito positivo.

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.

disinstallaPacchettoPerUtente

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

Disinstalla un pacchetto Android dal dispositivo per un determinato utente.

Parametri
packageName	String: il pacchetto Android da disinstallare
userId	int: l'ID utente intero per il quale eseguire la disinstallazione.

Ritorni
String	String con un codice di errore o null in caso di esito positivo.

Lanci
DeviceNotAvailableException	se la connessione con il dispositivo si interrompe e non può essere recuperato.

attendeSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Se previsto, attendi il completamento dello snapshot.

Parametri
currentPhase	SnapuserdWaitPhase

Lanci
DeviceNotAvailableException