DispositivoITest

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

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