NativeDevice

public class NativeDevice
extends Object implements IManagedTestDevice , IConfigurationReceiver , ITestLoggerReceiver

java.lang.Object
com.android.tradefed.device.NativeDevice


Implementazione predefinita di un ITestDevice Dispositivi Android con stack non completo.

Riepilogo

Classi nidificate

class NativeDevice.AdbAction

Un ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) per l'esecuzione del comando "adb ...." del sistema operativo.

class NativeDevice.AdbShellAction

class NativeDevice.RebootDeviceAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) per il riavvio di un dispositivo.

Costanti

int INVALID_USER_ID

Valore restituito per qualsiasi ID utente non valido/non trovato: UserHandle ha definito il valore -10000

long MAX_HOST_DEVICE_TIME_OFFSET

int MAX_RETRY_ATTEMPTS

il numero predefinito di tentativi di esecuzione del comando

Campi

public static final String DEBUGFS_PATH

protected static final String SD_CARD

protected static final String STORAGE_EMULATED

protected TestDeviceOptions mOptions

protected final IDeviceStateMonitor mStateMonitor

Costruttori pubblici

NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Crea un TestDevice .

Metodi pubblici

void batchPrefetchStartupBuildProps ()

Microottimizzazione (circa 400 millis) precaricando tutti gli oggetti di scena di cui abbiamo bisogno anziché chiamare "adb getprop" per ognuno di essi.

boolean canSwitchToHeadlessSystemUser ()

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

boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Controlla se una funzionalità è attualmente supportata o meno dato un livello minimo supportato.

boolean checkConnectivity ()

Verifica che il dispositivo disponga di connettività di rete.

boolean clearErrorDialogs ()

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

void clearLastConnectedWifiNetwork ()

Cancella l'ultima rete Wi-Fi connessa.

void clearLogcat ()

Elimina tutti i dati logcat accumulati.

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

Si connette a una rete Wi-Fi.

boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

Si connette a una rete Wi-Fi.

boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

Si connette a una rete Wi-Fi.f

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

Si connette a una rete Wi-Fi.

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.

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.

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

Crea un utente con un determinato nome e i flag forniti

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

Crea un utente con un determinato nome e i flag forniti

int createUser (String name)

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

int createUserNoThrow (String name)

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

void deleteFile (String deviceFilePath)

Metodo di supporto per eliminare un file o una directory sul dispositivo.

void deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Rimuove l' IDeviceActionReceiver registrato.

boolean deviceSoftRestarted ( ProcessInfo prevSystemServerProcess)

Metodo di supporto per verificare se il dispositivo è stato riavviato gradualmente confrontando l'attuale system_server con il precedente system_server ProcessInfo .

boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)

Metodo di supporto per verificare se il dispositivo è stato riavviato gradualmente dall'ora UTC dall'epoca dal dispositivo e dal relativo ERROR(/TimeUnit) .

boolean disableAdbRoot ()

Disattiva adb root.

void disableKeyguard ()

Tenta di disattivare lo scudo tastiera.

boolean disableNetworkMonitor ()

Disabilita il monitoraggio della rete sul dispositivo.

boolean disconnectFromWifi ()

Si disconnette da una rete Wi-Fi.

boolean doesFileExist (String deviceFilePath, int userId)

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

boolean doesFileExist (String deviceFilePath)

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

File dumpHeap (String process, String devicePath)

Tentativo di scaricare l'heap da system_server.

boolean enableAdbRoot ()

Attiva adb root.

boolean enableNetworkMonitor ()

Abilita il monitoraggio della rete sul dispositivo.

String executeAdbCommand (long timeout, String... cmdArgs)

Metodo di supporto che esegue un comando adb come comando di sistema con un timeout specificato.

String executeAdbCommand (long timeout, envMap, String... cmdArgs) executeAdbCommand (long timeout, envMap, String... cmdArgs)

Metodo di supporto che esegue un comando adb come comando di sistema con un timeout specificato.

String executeAdbCommand (String... cmdArgs)

Metodo di supporto che esegue un comando adb come comando di sistema.

CommandResult executeFastbootCommand (String... cmdArgs)

Metodo di supporto che esegue un comando fastboot come comando di sistema con un timeout predefinito di 2 minuti.

CommandResult executeFastbootCommand (long timeout, String... cmdArgs)

Metodo di supporto che esegue un comando fastboot come comando di sistema.

CommandResult executeLongFastbootCommand (String... cmdArgs)

Metodo di supporto che esegue un comando fastboot di lunga durata come comando di sistema.

CommandResult executeLongFastbootCommand ( envVarMap, String... cmdArgs) executeLongFastbootCommand ( envVarMap, String... cmdArgs)

Metodo di supporto che esegue un comando fastboot di lunga durata come comando di sistema con variabili di ambiente di sistema.

String executeShellCommand (String command)

Metodo helper che esegue un comando shell adb e restituisce l'output come String .

void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)

Esegue un comando della shell adb, con più parametri per controllare il comportamento del comando.

void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)

Esegue un comando della shell adb, con più parametri per controllare il comportamento del comando.

void executeShellCommand (String command, IShellOutputReceiver receiver)

Esegue il comando della shell adb specificato, riprovando più volte se il comando fallisce.

CommandResult executeShellV2Command (String cmd)

Metodo di supporto che esegue un comando della shell adb e restituisce i risultati come CommandResult correttamente popolato con l'output dello stato del comando, stdout e stderr.

CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)

Metodo di supporto che esegue un comando della shell adb e restituisce i risultati come CommandResult popolato correttamente con l'output dello stato del comando e stderr.

CommandResult executeShellV2Command (String cmd, File pipeAsInput)

Metodo di supporto che esegue un comando della shell adb e restituisce i risultati come CommandResult correttamente popolato con l'output dello stato del comando, stdout e stderr.

CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

Esegue un comando della shell adb, con più parametri per controllare il comportamento del comando.

CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)

Esegue un comando della shell adb, con più parametri per controllare il comportamento del comando.

CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

Esegue un comando della shell adb, con più parametri per controllare il comportamento del comando.

CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

Esegue un comando della shell adb, con più parametri per controllare il comportamento del comando.

CommandResult fastbootWipePartition (String partition)

Metodo di supporto che cancella una partizione per il dispositivo.

getActiveApexes ()

Recupera le informazioni sugli APEX attivati ​​sul dispositivo.

getAllSettings (String namespace)

Restituisce coppie chiave-valore dello spazio dei nomi richiesto.

DeviceAllocationState getAllocationState ()

Restituisce lo stato di allocazione corrente del dispositivo

String getAndroidId (int userId)

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

getAndroidIds ()

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

int getApiLevel ()

Ottieni il livello API del dispositivo.

PackageInfo getAppPackageInfo (String packageName)

Recupera informazioni su un pacchetto installato sul dispositivo.

getAppPackageInfos ()

Recupera le informazioni sui pacchetti installati sul dispositivo.

String getBasebandVersion ()

Metodo pratico per ottenere la versione in banda base (radio) di questo dispositivo.

Integer getBattery ()

Restituisce il livello corrente della batteria di un dispositivo o Null se il livello della batteria non è disponibile.

boolean getBooleanProperty (String name, boolean defaultValue)

Restituisce il valore booleano della proprietà specificata.

getBootHistory ()

Il metodo di supporto raccoglie la mappa della cronologia di avvio con l'ora di avvio e il motivo dell'avvio.

getBootHistorySince (long utcEpochTime, TimeUnit timeUnit)

Il metodo di supporto raccoglie la mappa della cronologia di avvio con l'ora di avvio e il motivo dell'avvio dal momento specificato dall'epoca dal dispositivo e dall'unità di tempo specificata.

String getBootloaderVersion ()

Metodo conveniente per ottenere la versione bootloader di questo dispositivo.

InputStreamSource getBugreport ()

Recupera una segnalazione di bug dal dispositivo.

InputStreamSource getBugreportz ()

Recupera una segnalazione di bug dal dispositivo.

String getBuildAlias ()

Recupera l'alias della build attualmente in esecuzione sul dispositivo.

String getBuildFlavor ()

Recupera la versione di build per il dispositivo.

String getBuildId ()

Recupera la build attualmente in esecuzione sul dispositivo.

String getBuildSigningKeys ()

Restituisce il tipo di chiave utilizzato per firmare l'immagine del dispositivo

In genere i dispositivi Android possono essere firmati con chiavi di test (come in AOSP) o chiavi di rilascio (controllate dai singoli produttori di dispositivi)

DeviceDescriptor getCachedDeviceDescriptor ()

Restituisce un DeviceDescriptor memorizzato nella cache se il dispositivo è allocato, altrimenti restituisce il DeviceDescriptor corrente.

DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Restituisce un DeviceDescriptor memorizzato nella cache se il dispositivo è allocato, altrimenti restituisce il DeviceDescriptor corrente.

String[] getChildren (String path)

Alternativa all'utilizzo IFileEntry che a volte non funziona a causa delle autorizzazioni.

AbstractConnection getConnection ()

La connessione corrente associata al dispositivo.

DeviceFoldableState getCurrentFoldableState ()

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

int getCurrentUser ()

Restituisce l'id dell'utente attualmente in esecuzione.

String getDeviceClass ()

Ottieni la classe del dispositivo.

long getDeviceDate ()

Restituisce la data del dispositivo in millisecondi dall'epoca.

DeviceDescriptor getDeviceDescriptor ()

Restituisce un DeviceDescriptor dalle informazioni sul dispositivo per ottenere informazioni su di esso senza passare l'oggetto dispositivo effettivo.

DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Restituisce un DeviceDescriptor dalle informazioni sul dispositivo per ottenere informazioni su di esso senza passare l'oggetto dispositivo effettivo.

TestDeviceState getDeviceState ()

Ottieni lo stato del dispositivo.

long getDeviceTimeOffset (Date date)

Aiutante per ottenere la differenza oraria tra il dispositivo e un determinato ERROR(/Date) .

InputStreamSource getEmulatorOutput ()

Ottieni il flusso dell'emulatore stdout e stderr

Process getEmulatorProcess ()

Restituisce il Process corrispondente a questo emulatore.

final File getExecuteShellCommandLog ()

Il log che contiene tutti i log executeShellCommand(String) .

long getExternalStoreFreeSpace ()

Metodo di supporto per determinare la quantità di spazio libero nella memoria esterna del dispositivo.

String getFastbootPath ()

Restituisce il percorso del binario fastboot utilizzato.

String getFastbootProductType ()

Metodo pratico per ottenere il tipo di prodotto di questo dispositivo quando è in modalità di avvio rapido.

String getFastbootProductVariant ()

Metodo pratico per ottenere il tipo di prodotto di questo dispositivo quando è in modalità di avvio rapido.

String getFastbootSerialNumber ()

Restituisce il numero di serie della modalità fastboot.

String getFastbootVariable (String variableName)

Recupera il valore della variabile fastboot specificato dal dispositivo.

String getFastbootVersion ()

Restituisce la stringa della versione del binario fastboot utilizzato.

IFileEntry getFileEntry (String path)

Recupera un riferimento a un file remoto sul dispositivo.

IFileEntry getFileEntry (FileListingService.FileEntry entry)

Helper non ufficiale per ottenere un FileEntry da un percorso non root.

getFoldableStates ()

Restituisce l'elenco degli stati pieghevoli nel dispositivo.

IDevice getIDevice ()

Restituisce un riferimento IDevice ddmlib associato.

getInstalledPackageNames ()

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

long getIntProperty (String name, long defaultValue)

Restituisce il valore intero della proprietà specificata dal dispositivo.

String getIpAddress ()

Ottiene l'indirizzo IP del dispositivo.

KeyguardControllerState getKeyguardState ()

Restituisce un oggetto per ottenere lo stato corrente dello scudo tastiera o null se non supportato.

long getLastExpectedRebootTimeMillis ()

Restituisce l'ultima volta che le API Tradefed hanno attivato un riavvio in millisecondi da EPOCH restituito da System.currentTimeMillis() .

int getLaunchApiLevel ()

Ottieni il primo livello API avviato del dispositivo.

InputStreamSource getLogcat ()

Acquisisce un flusso di snapshot dei dati logcat.

InputStreamSource getLogcat (int maxBytes)

Acquisisce un flusso di snapshot degli ultimi maxBytes di dati logcat acquisiti.

InputStreamSource getLogcatDump ()

Ottieni un dump del logcat corrente per il dispositivo.

InputStreamSource getLogcatSince (long date)

Acquisisce un flusso di snapshot dei dati logcat acquisiti a partire dalla data fornita.

String getMacAddress ()

Restituisce l'indirizzo MAC del dispositivo, null se non riesce a eseguire la query dal dispositivo.

Integer getMainUserId ()

Restituisce l'ID utente principale.

getMainlineModuleInfo ()

Ottieni informazioni sui moduli della linea principale installati sul dispositivo.

int getMaxNumberOfRunningUsersSupported ()

Ottieni il numero massimo di utenti supportati con esecuzione simultanea.

int getMaxNumberOfUsersSupported ()

Ottieni il numero massimo di utenti supportati.

Process getMicrodroidProcess ()
IDeviceStateMonitor getMonitor ()

Restituisce l' IDeviceStateMonitor associato al dispositivo.

String getMountPoint (String mountName)

Restituisce un punto di montaggio.

ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

Restituisce un MountPointInfo corrispondente al percorso del punto di montaggio specificato, o null se quel percorso non ha nulla montato o altrimenti non appare in /proc/mounts come punto di montaggio.

getMountPointInfo ()

Restituisce una versione analizzata delle informazioni in /proc/mounts sul dispositivo

TestDeviceOptions getOptions ()

Recupera le opzioni di test per il dispositivo.

long getPartitionFreeSpace (String partition)

Metodo di supporto per determinare la quantità di spazio libero sulla partizione del dispositivo.

Integer getPrimaryUserId ()

Restituisce l'ID utente principale.

ProcessInfo getProcessByName (String processName)

Il metodo helper esegue il comando "pidof" e "stat" e restituisce l'oggetto ProcessInfo con PID e l'ora di inizio del processo specificato.

String getProcessPid (String process)

Restituisce il pid del servizio oppure null se qualcosa è andato storto.

String getProductType ()

Metodo pratico per ottenere il tipo di prodotto di questo dispositivo.

String getProductVariant ()

Metodo conveniente per ottenere la variante di prodotto di questo dispositivo.

String getProperty (String name)

Recupera il valore della proprietà specificato dal dispositivo.

ITestDevice.RecoveryMode getRecoveryMode ()

Ottieni la modalità di ripristino corrente utilizzata per il dispositivo.

InputStreamSource getScreenshot (String format)

Cattura uno screenshot dal dispositivo.

InputStreamSource getScreenshot (long displayId)

Cattura uno screenshot dal dispositivo a cui è stato fornito l'ID di visualizzazione.

InputStreamSource getScreenshot (String format, boolean rescale)

Cattura uno screenshot dal dispositivo.

InputStreamSource getScreenshot ()

Cattura uno screenshot dal dispositivo.

String getSerialNumber ()

Metodo pratico per ottenere il numero di serie di questo dispositivo.

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

Restituisce il valore dell'impostazione richiesta.

String getSetting (String namespace, String key)

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

String getSimOperator ()

Restituire l'operatore della carta SIM o null se non disponibile o se il dispositivo non è disponibile.

String getSimState ()

Restituisce lo stato della scheda SIM o nullo se non disponibile o il dispositivo non è disponibile.

getTombstones ()

Recupera e restituisce l'elenco delle lapidi dai dispositivi.

long getTotalMemory ()

Restituisce la dimensione totale della memoria fisica in byte o -1 in caso di errore interno

getUninstallablePackageNames ()

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

boolean getUseFastbootErase ()

Scopri se utilizzare la cancellazione rapida o il formato di avvio rapido per cancellare una partizione sul dispositivo.

int getUserFlags (int userId)

Trova e restituisce i flag di un determinato utente.

getUserInfos ()

Ottiene la mappa di useId in UserInfo nel dispositivo.

int getUserSerialNumber (int userId)

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

IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

Elabora il DeviceEvent specificato.

Elabora DeviceEvent, che può o meno far passare il dispositivo a un nuovo stato di allocazione.

boolean hasFeature (String feature)

Controlla se una funzionalità è disponibile su un dispositivo.

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

Installa un pacchetto Android sul dispositivo.

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

Installa un pacchetto Android sul dispositivo.

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

Installa un pacchetto Android sul dispositivo per un determinato utente.

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

Installa un pacchetto Android sul dispositivo per un determinato utente.

void invalidatePropertyCache ()
boolean isAdbRoot ()

boolean isAdbTcp ()
boolean isAppEnumerationSupported ()

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

boolean isBypassLowTargetSdkBlockSupported ()

Controlla se la piattaforma sul dispositivo supporta il bypass del blocco SDK con target basso nelle installazioni di app

boolean isDebugfsMounted ()

Controlla se debugfs è montato.

boolean isDeviceEncrypted ()

Restituisce se il dispositivo è crittografato.

boolean isDirectory (String path)

Restituisce True se il percorso sul dispositivo è una directory, false altrimenti.

boolean isEnableAdbRoot ()
boolean isEncryptionSupported ()

Restituisce se la crittografia è supportata sul dispositivo.

boolean isExecutable (String fullPath)

Restituisce True se il percorso del file sul dispositivo è un file eseguibile, false altrimenti.

boolean isFastbootEnabled ()

Ritorna se l'avvio rapido è disponibile per il dispositivo.

boolean isHeadless ()

Restituisce vero se il dispositivo è senza testa (senza schermo), falso altrimenti.

boolean isHeadlessSystemUserMode ()

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

boolean isMainUserPermanentAdmin ()

Indica se l'utente principale è un amministratore permanente e non può essere eliminato o declassato allo stato non amministratore.

boolean isMultiUserSupported ()

Determina se è supportato il multiutente.

boolean isPackageInstalled (String packageName, String userId)

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

boolean isPackageInstalled (String packageName)

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

boolean isRuntimePermissionSupported ()

Controlla se la piattaforma sul dispositivo supporta la concessione delle autorizzazioni di runtime

boolean isStateBootloaderOrFastbootd ()

Restituisce true se il dispositivo è in TestDeviceState#FASTBOOT o TestDeviceState.FASTBOOTD .

boolean isUserRunning (int userId)

Controlla se un determinato utente è in esecuzione.

boolean isUserSecondary (int userId)

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

boolean isUserVisible (int userId)

Controlla se l'utente specificato è visibile.

boolean isUserVisibleOnDisplay (int userId, int displayId)

Controlla se l'utente specificato è visibile nel display specificato.

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

boolean isVisibleBackgroundUsersSupported ()

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

boolean isWifiEnabled ()

Verifica se il Wi-Fi è abilitato.

listDisplayIds ()

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

listDisplayIdsForStartingVisibleBackgroundUsers ()

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

listUsers ()

Ottiene l'elenco degli utenti nel dispositivo.

boolean logAnrs ( ITestLogger logger)

Raccoglie e registra gli ANR dal dispositivo.

boolean logBugreport (String dataName, ITestLogger listener)

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

void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)

Registra un messaggio nel logcat del dispositivo.

void mountDebugfs ()

Monta debugf.

void nonBlockingReboot ()

Emette un comando per riavviare il dispositivo e ritorna al completamento del comando e quando il dispositivo non è più visibile ad adb.

void postAdbRootAction ()

Sostituisci se il dispositivo necessita di alcune azioni specifiche da eseguire dopo adb root e prima che il dispositivo sia di nuovo online.

void postAdbUnrootAction ()

Sostituisci se il dispositivo necessita di alcune azioni specifiche da eseguire dopo l'annullamento del root di adb e prima che il dispositivo sia di nuovo online.

void postBootSetup ()

Eseguire le istruzioni per configurare il dispositivo per testarlo dopo ogni avvio.

void postInvocationTearDown (Throwable exception)

Passaggi aggiuntivi per la pulizia richiesta specifica del dispositivo che verranno eseguiti al termine della chiamata.

void preInvocationSetup ( IBuildInfo info, MultiMap <String, String> attributes)

Passaggi aggiuntivi per la configurazione richiesta specifica del dispositivo che verranno eseguiti sul dispositivo prima del flusso di chiamata.

boolean pullDir (String deviceFilePath, File localDir)

Estrae ricorsivamente il contenuto della directory dal dispositivo.

boolean pullFile (String remoteFilePath, File localFile)

Recupera un file dal dispositivo.

File pullFile (String remoteFilePath, int userId)

Recupera un file dal dispositivo, lo archivia in un ERROR(/File) temporaneo locale e restituisce quel File .

File pullFile (String remoteFilePath)

Recupera un file dal dispositivo, lo archivia in un ERROR(/File) temporaneo locale e restituisce quel File .

boolean pullFile (String remoteFilePath, File localFile, int userId)

Recupera un file dal dispositivo.

String pullFileContents (String remoteFilePath)

Recupera un file dal dispositivo e restituisce il contenuto.

File pullFileFromExternal (String remoteFilePath)

Un metodo pratico per recuperare un file dalla memoria esterna del dispositivo, memorizzarlo in un ERROR(/File) temporaneo locale e restituire un riferimento a quel File .

boolean pushDir (File localFileDir, String deviceFilePath, excludedDirectories) pushDir (File localFileDir, String deviceFilePath, excludedDirectories)

Invia ricorsivamente i contenuti della directory al dispositivo escludendo alcune directory filtrate.

boolean pushDir (File localFileDir, String deviceFilePath)

Invia ricorsivamente il contenuto della directory al dispositivo.

boolean pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)

Variante di pushFile(File, String) che può facoltativamente prendere in considerazione la valutazione della necessità per il fornitore di contenuti.

boolean pushFile (File localFile, String remoteFilePath)

Invia un file al dispositivo.

boolean pushString (String contents, String remoteFilePath)

Invia il file creato da una stringa al dispositivo

void reboot (String reason)

Riavvia il dispositivo in modalità adb con reason indicato per persistere durante il riavvio.

void reboot ()

Riavvia il dispositivo in modalità adb.

void rebootIntoBootloader ()

Riavvia il dispositivo in modalità bootloader.

void rebootIntoFastbootd ()

Riavvia il dispositivo in modalità fastbootd.

void rebootIntoRecovery ()

Riavvia il dispositivo in modalità di ripristino adb.

void rebootIntoSideload ()

Riavvia il dispositivo in modalità sideload adb (nota che questa è una modalità speciale in fase di ripristino)

Si blocca finché il dispositivo non entra in modalità sideload

void rebootIntoSideload (boolean autoReboot)

Riavvia il dispositivo in modalità sideload adb (nota che questa è una modalità speciale in fase di ripristino)

Si blocca finché il dispositivo non entra in modalità sideload

void rebootUntilOnline ()

Un'alternativa a reboot() che si blocca solo finché il dispositivo non è online, ovvero visibile ad adb.

void rebootUntilOnline (String reason)

Un'alternativa a reboot() che si blocca solo finché il dispositivo non è online, ovvero visibile ad adb.

void rebootUserspace ()

Riavvia solo la parte dello spazio utente del dispositivo.

void rebootUserspaceUntilOnline ()

Un'alternativa a rebootUserspace() ()} che si blocca solo finché il dispositivo non è online, ovvero visibile ad adb.

boolean recoverDevice ()

Tenta di ripristinare la comunicazione del dispositivo.

void registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Registra un IDeviceActionReceiver per questo dispositivo.

void remountSystemReadOnly ()

Rendi di sola lettura la partizione di sistema sul dispositivo.

void remountSystemWritable ()

Rendere scrivibile la partizione di sistema sul dispositivo.

void remountVendorReadOnly ()

Rendi di sola lettura la partizione del fornitore sul dispositivo.

void remountVendorWritable ()

Rendere scrivibile la partizione del fornitore sul dispositivo.

boolean removeAdmin (String componentName, int userId)

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

void removeOwners ()

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

boolean removeUser (int userId)

Rimuovi un determinato utente dal dispositivo.

void resetContentProviderSetup ()

Reimpostare il flag per la configurazione del fornitore di contenuti per attivarlo nuovamente.

boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)

Metodo pratico per eseguire ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) con uno o più ascoltatori passati come parametri.

boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners)

Esegue test della strumentazione e fornisce il ripristino del dispositivo.

boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners)

Uguale ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) ma esegue il test per il dato utente.

boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)

Uguale a ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) ma esegue il test per un determinato utente.

void setConfiguration ( IConfiguration configuration)

Inietta la IConfiguration in uso.

final void setConnectionAvdInfo ( GceAvdInfo avdInfo)
void setDate (Date date)

Imposta la data sul dispositivo

Nota: l'impostazione della data sul dispositivo richiede root

boolean setDeviceOwner (String componentName, int userId)

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

void setDeviceState ( TestDeviceState deviceState)

Aggiorna lo stato del dispositivo.

void setEmulatorOutputStream ( SizeLimitedOutputStream output)

Per l'emulatore impostare SizeLimitedOutputStream per registrare l'output

void setEmulatorProcess (Process p)

Imposta Process , quando questo dispositivo è un emulatore.

void setFastbootEnabled (boolean fastbootEnabled)

Imposta l'opzione di avvio rapido per il dispositivo.

void setFastbootPath (String fastbootPath)

Imposta il percorso del binario di avvio rapido da utilizzare.

void setIDevice (IDevice newDevice)

Aggiorna l'IDevice associato a questo ITestDevice.

void setLogStartDelay (int delay)

Imposta il tempo in ms di attesa prima di avviare l'acquisizione di logcat per un dispositivo online.

void setOptions ( TestDeviceOptions options)

Imposta TestDeviceOptions per il dispositivo

boolean setProperty (String propKey, String propValue)

Imposta il valore della proprietà specificata sul dispositivo.

void setRecovery ( IDeviceRecovery recovery)

Imposta IDeviceRecovery da utilizzare per questo dispositivo.

void setRecoveryMode ( ITestDevice.RecoveryMode mode)

Imposta la modalità di ripristino corrente da utilizzare per il dispositivo.

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

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

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

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

void setTestLogger ( ITestLogger testLogger)

Inserisce l'istanza ITestLogger

void setUseFastbootErase (boolean useFastbootErase)

Imposta se utilizzare la cancellazione rapida o il formato di avvio rapido per cancellare una partizione sul dispositivo.

void startLogcat ()

Inizia ad acquisire l'output di logcat dal dispositivo in background.

boolean startUser (int userId)

Avvia un determinato utente in background se è attualmente arrestato.

boolean startUser (int userId, boolean waitFlag)

Avvia un determinato utente in background se è attualmente arrestato.

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

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

void stopEmulatorOutput ()

Chiudi ed elimina l'output dell'emulatore.

void stopLogcat ()

Interrompe l'acquisizione dell'output logcat dal dispositivo ed elimina i dati logcat attualmente salvati.

boolean stopUser (int userId)

Arresta un determinato utente.

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

Arresta un determinato utente.

String switchToAdbTcp ()

Passa il dispositivo alla modalità adb-over-tcp.

boolean switchToAdbUsb ()

Passa il dispositivo alla modalità adb tramite USB.

boolean switchUser (int userId)

Passa a un altro ID utente con un timeout predefinito.

boolean switchUser (int userId, long timeout)

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

boolean syncFiles (File localFileDir, String deviceFilePath)

Sincronizza in modo incrementale il contenuto di una directory di file locale sul dispositivo.

Bugreport takeBugreport ()

Prende una segnalazione di bug e la restituisce all'interno di un oggetto Bugreport per gestirla.

String uninstallPackage (String packageName)

Disinstallare un pacchetto Android dal dispositivo.

String uninstallPackageForUser (String packageName, int userId)

Disinstalla un pacchetto Android dal dispositivo per un determinato utente.

boolean unlockDevice ()

Sblocca il dispositivo se il dispositivo è in uno stato crittografato.

void unmountDebugfs ()

Smonta debugf.

boolean waitForBootComplete (long timeOut)

Si blocca finché non viene impostato il flag di avvio completo del dispositivo.

boolean waitForDeviceAvailable ()

Attende che il dispositivo risponda e sia disponibile per il test.

boolean waitForDeviceAvailable (long waitTime)

Attende che il dispositivo risponda e sia disponibile per il test.

boolean waitForDeviceAvailableInRecoverPath (long waitTime)

Attende che il dispositivo sia reattivo e disponibile senza considerare il percorso di ripristino.

void waitForDeviceBootloader ()

Si blocca finché il dispositivo non è visibile tramite fastboot.

boolean waitForDeviceInRecovery (long waitTime)

Blocchi affinché il dispositivo si trovi nello stato 'adb recovery' (nota che questo è distinto da IDeviceRecovery ).

boolean waitForDeviceInSideload (long waitTime)

Blocchi affinché il dispositivo si trovi nello stato "adb sideload".

boolean waitForDeviceNotAvailable (long waitTime)

I blocchi affinché il dispositivo non siano disponibili, ovvero mancanti da adb

void waitForDeviceOnline ()

Si blocca finché il dispositivo non è visibile tramite adb.

void waitForDeviceOnline (long waitTime)

Si blocca finché il dispositivo non è visibile tramite adb.

boolean waitForDeviceShell (long waitTime)

Attende che il dispositivo risponda a un comando base della shell adb.

Metodi protetti

void addExtraConnectionBuilderArgs ( DefaultConnection.ConnectionBuilder builder)
String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)

Crea il comando del sistema operativo per la sessione di comando e gli argomenti della shell adb specificati

void checkApiLevelAgainst (String feature, int strictMinLevel)
NativeDevice.RebootDeviceAction createRebootDeviceAction ( NativeDevice.RebootMode rebootMode, String reason)

Crea una RebootDeviceAction da utilizzare quando si esegue un'azione di riavvio.

IRunUtil createRunUtil ()
void doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason)

Esegui un riavvio adb.

void ensureRuntimePermissionSupported ()

metodo di supporto per generare un'eccezione se l'autorizzazione di runtime non è supportata

int getApiLevelSafe ()
ITestLogger getLogger ()
IRunUtil getRunUtil ()

Ottieni l'istanza RunUtil da utilizzare.

void initializeConnection ( IBuildInfo info, MultiMap <String, String> attributes)
String internalGetProperty (String propName, String fastbootVar, String description)

Recupera una proprietà del dispositivo, dalla cache ddmlib per impostazione predefinita, e torna ad "adb shell getprop" o "fastboot getvar" a seconda che il dispositivo sia in Fastboot o meno.

boolean isInRebootCallback ()

Restituisce se i callback di riavvio sono attualmente in esecuzione o meno.

boolean isNewer (File localFile, IFileEntry entry)

Restituisce true se il file locale è più recente del file remoto.

void notifyRebootEnded ()

Notifica a tutti IDeviceActionReceiver l'evento di fine riavvio.

void notifyRebootStarted ()

Notifica a tutti IDeviceActionReceiver l'evento di avvio del riavvio.

boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)

Esegue un'azione su questo dispositivo.

void postAdbReboot ()

Possibili azioni aggiuntive che possono essere eseguite dopo il riavvio.

void prePostBootSetup ()

Consente a ciascun tipo di dispositivo (AndroidNativeDevice, TestDevice) di sovrascrivere questo metodo per una specifica configurazione post-avvio.

boolean pullFileInternal (String remoteFilePath, File localFile)
void setClock (Clock clock)

Imposta l'istanza dell'orologio da utilizzare.

void setMicrodroidProcess (Process process)

Contrassegna il TestDevice come microdroid e imposta il suo CID.

void setTestDeviceOptions ( deviceOptions) setTestDeviceOptions ( deviceOptions)
CommandResult simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd) simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd)

Esegue un semplice comando fastboot con variabili di ambiente e segnala lo stato del comando.

CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)

Esegue un semplice comando fastboot e segnala lo stato del comando.

boolean waitForDeviceNotAvailable (String operationDesc, long time)

Attendi che il dispositivo diventi non disponibile (interrompi la segnalazione ad adb).

Costanti

ID_UTENTE_INVALID

public static final int INVALID_USER_ID

Valore restituito per qualsiasi ID utente non valido/non trovato: UserHandle ha definito il valore -10000

Valore costante: -10000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

Valore costante: 5000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

il numero predefinito di tentativi di esecuzione del comando

Valore costante: 2 (0x00000002)

Campi

DEBUGFS_PATH

public static final String DEBUGFS_PATH

SCHEDA SD

protected static final String SD_CARD

STOCCAGGIO_EMULATO

protected static final String STORAGE_EMULATED

mOpzioni

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Costruttori pubblici

NativeDevice

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

Crea un TestDevice .

Parametri
device IDevice : l' IDevice associato

stateMonitor IDeviceStateMonitor : il meccanismo IDeviceStateMonitor da utilizzare

allocationMonitor IDeviceMonitor : IDeviceMonitor per informare dei cambiamenti dello stato di allocazione. Può essere nullo

Metodi pubblici

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

Microottimizzazione (circa 400 millis) precaricando tutti gli oggetti di scena di cui abbiamo bisogno anziché chiamare "adb getprop" per ognuno di essi. vale a dire, recuperare tutte le proprietà è altrettanto veloce quanto recuperarne una. Cose come device.getApiLevel(), checkApiLevelAgainstNextRelease e getBuildAlias ​​chiamano tutti `adb getprop` dietro le quinte. Li recuperiamo in una chiamata e chiamiamo NativeDevice.setProperty. Anche se non lo facciamo, NativeDevice chiamerà setProperty e memorizzerà nella cache il risultato per le chiamate future. Lo stiamo semplicemente facendo leggermente prima. Se il dispositivo è in fase di ripristino o si verificano altri errori durante il recupero degli oggetti di scena, li ignoriamo semplicemente.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

ritorna
boolean

Lancia
DeviceNotAvailableException

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Controlla se una funzionalità è attualmente supportata o meno dato un livello minimo supportato. Questo metodo tiene conto delle funzionalità non ancora rilasciate, prima che il livello API venga aumentato.

Parametri
strictMinLevel int : il livello minimo possibile rigoroso che supporta la funzionalità.

ritorna
boolean Vero se il livello è supportato. Falso altrimenti.

Lancia
DeviceNotAvailableException

checkConnettività

public boolean checkConnectivity ()

Verifica che il dispositivo disponga di connettività di rete.

ritorna
boolean true se il dispositivo ha una connessione di rete funzionante, false altrimenti.

Lancia
DeviceNotAvailableException

clearErrorDialogs

public boolean clearErrorDialogs ()

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

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

Lancia
DeviceNotAvailableException

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

Cancella l'ultima rete Wi-Fi connessa. Dovrebbe essere chiamato quando si avvia una nuova invocazione per evitare la connessione alla rete Wi-Fi utilizzata nel test precedente dopo il riavvio del dispositivo.

clearLogcat

public void clearLogcat ()

Elimina tutti i dati logcat accumulati.

Ciò è utile nei casi in cui si desidera garantire ITestDevice#getLogcat() restituisca solo i dati di registro prodotti dopo un certo punto (ad esempio dopo aver eseguito il flashing di una nuova build di dispositivo e così via).

connectToWifiNetwork

public 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 riuscita con una delle reti Wi-Fi indicate nella mappa wifiSsidToPsk. Una volta stabilita la connessione, l'istanza proverà a ripristinare la connessione dopo ogni riavvio finché non verrà chiamato ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork() .

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

scanSsid boolean : se eseguire la scansione degli SSID nascosti per questa rete.

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

Lancia
DeviceNotAvailableException

connectToWifiNetwork

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

Parametri
wifiSsid String : l'ssid wifi a cui connettersi

wifiPsk String : passphrase PSK o null se non crittografata

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

Lancia
DeviceNotAvailableException

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Si connette a una rete Wi-Fi.

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

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

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

Lancia
DeviceNotAvailableException

connectToWifiNetwork

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

Parametri
wifiSsid String : l'ssid wifi a cui connettersi

wifiPsk String : passphrase PSK o null se non crittografata

scanSsid boolean : se eseguire la scansione dell'SSID nascosto per questa rete.

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

Lancia
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public 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 eseguire la scansione dell'SSID nascosto per questa rete

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

Lancia
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

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

Lancia
DeviceNotAvailableException

creare un utente

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

Crea un utente con un determinato nome e i flag forniti

Parametri
name String : dell'utente da creare sul dispositivo

guest boolean : abilita il flag utente --guest durante la creazione

ephemeral boolean : abilita il flag utente --ephemeral durante la creazione

ritorna
int ID dell'utente creato

Lancia
DeviceNotAvailableException

creare un utente

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

Crea un utente con un determinato nome e i flag forniti

Parametri
name String : dell'utente da creare sul dispositivo

guest boolean : abilita il flag utente --guest durante la creazione

ephemeral boolean : abilita il flag utente --ephemeral durante la creazione

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

ritorna
int ID dell'utente creato

Lancia
DeviceNotAvailableException

creare un utente

public int createUser (String name)

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

Parametri
name String : dell'utente da creare sul dispositivo

ritorna
int il numero intero per l'ID utente creato

Lancia
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

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

Parametri
name String : dell'utente da creare sul dispositivo

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

Lancia
DeviceNotAvailableException

cancella il file

public void deleteFile (String deviceFilePath)

Metodo di supporto per eliminare un file o una directory sul dispositivo.

Parametri
deviceFilePath String : il percorso assoluto del file sul dispositivo.

Lancia
DeviceNotAvailableException

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Rimuove l' IDeviceActionReceiver registrato.

Parametri
deviceActionReceiver IDeviceActionReceiver : un IDeviceActionReceiver che verrà rimosso.

dispositivoSoftRiavviato

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Metodo di supporto per verificare se il dispositivo è stato riavviato gradualmente confrontando l'attuale system_server con il precedente system_server ProcessInfo . Utilizzare getProcessByName(String) per ottenere ProcessInfo .

Parametri
prevSystemServerProcess ProcessInfo : il precedente processo system_server ProcessInfo .

ritorna
boolean true se il dispositivo è stato riavviato gradualmente

Lancia
DeviceNotAvailableException

dispositivoSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Metodo di supporto per verificare se il dispositivo è stato riavviato gradualmente dall'ora UTC dall'epoca dal dispositivo e dal relativo ERROR(/TimeUnit) . Soft-Restart si riferisce a system_server riavviato al di fuori di un riavvio hardware del dispositivo (ad esempio: riavvio richiesto). Il dispositivo corrente utcEpochTime in Milliseccond può essere ottenuto con il metodo getDeviceDate() .

Parametri
utcEpochTime long : il tempo del dispositivo in secondi dall'epoca.

timeUnit TimeUnit : l'unità di tempo TimeUnit per il dato utcEpochTime.

ritorna
boolean true se il dispositivo è stato riavviato gradualmente

Lancia
DeviceNotAvailableException

disabilitaAdbRoot

public boolean disableAdbRoot ()

Disattiva adb root.

La disabilitazione di adb root potrebbe causare la disconnessione del dispositivo da adb. Questo metodo si bloccherà finché il dispositivo non sarà disponibile.

ritorna
boolean true in caso di successo.

Lancia
DeviceNotAvailableException

disabilitaKeyguard

public void disableKeyguard ()

Tenta di disattivare lo scudo tastiera.

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

Lancia
DeviceNotAvailableException

disabilitareNetworkMonitor

public boolean disableNetworkMonitor ()

Disabilita il monitoraggio della rete sul dispositivo.

ritorna
boolean true se il monitoraggio è stato disabilitato correttamente. false se fallisce.

Lancia
DeviceNotAvailableException

disconnettiDalWifi

public boolean disconnectFromWifi ()

Si disconnette da una rete Wi-Fi.

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

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

Lancia
DeviceNotAvailableException

faFileExist

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

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

ritorna
boolean true se il file esiste, false altrimenti.

Lancia
DeviceNotAvailableException

faFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

ritorna
boolean true se il file esiste, false altrimenti.

Lancia
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Tentativo di scaricare l'heap da system_server. È responsabilità del chiamante ripulire il file scaricato.

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

devicePath String : il percorso sul dispositivo in cui inserire il dump. Deve trattarsi di una posizione in cui le autorizzazioni lo consentono.

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

Lancia
DeviceNotAvailableException

abilitaAdbRoot

public boolean enableAdbRoot ()

Attiva adb root. Se l'impostazione "enable-root" è "false", registrerà un messaggio e restituirà senza abilitare root.

L'abilitazione di adb root potrebbe causare la disconnessione del dispositivo da adb. Questo metodo si bloccherà finché il dispositivo non sarà disponibile.

ritorna
boolean true in caso di successo.

Lancia
DeviceNotAvailableException

abilitareNetworkMonitor

public boolean enableNetworkMonitor ()

Abilita il monitoraggio della rete sul dispositivo.

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

Lancia
DeviceNotAvailableException

eseguireAdbCommand

public String executeAdbCommand (long timeout, 
                String... cmdArgs)

Metodo di supporto che esegue un comando adb come comando di sistema con un timeout specificato.

executeShellCommand(String) dovrebbe essere utilizzato invece ove possibile, poiché tale metodo fornisce un migliore rilevamento degli errori e prestazioni migliori.

Parametri
timeout long : il tempo in millisecondi prima che il dispositivo venga considerato non risponde, 0L per nessun timeout

cmdArgs String : il comando adb e gli argomenti da eseguire

ritorna
String lo stdout dal comando. null se l'esecuzione del comando non è riuscita.

Lancia
DeviceNotAvailableException

eseguireAdbCommand

public String executeAdbCommand (long timeout, 
                 envMap, 
                String... cmdArgs)

Metodo di supporto che esegue un comando adb come comando di sistema con un timeout specificato.

executeShellCommand(String) dovrebbe essere utilizzato invece ove possibile, poiché tale metodo fornisce un migliore rilevamento degli errori e prestazioni migliori.

Parametri
timeout long : il tempo in millisecondi prima che il dispositivo venga considerato non risponde, 0L per nessun timeout

envMap : ambiente da impostare per il comando

cmdArgs String : il comando adb e gli argomenti da eseguire

ritorna
String lo stdout dal comando. null se l'esecuzione del comando non è riuscita.

Lancia
DeviceNotAvailableException

eseguireAdbCommand

public String executeAdbCommand (String... cmdArgs)

Metodo di supporto che esegue un comando adb come comando di sistema.

executeShellCommand(String) dovrebbe essere utilizzato invece ove possibile, poiché tale metodo fornisce un migliore rilevamento degli errori e prestazioni migliori.

Parametri
cmdArgs String : il comando adb e gli argomenti da eseguire

ritorna
String lo stdout dal comando. null se l'esecuzione del comando non è riuscita.

Lancia
DeviceNotAvailableException

eseguire il comando Fastboot

public CommandResult executeFastbootCommand (String... cmdArgs)

Metodo di supporto che esegue un comando fastboot come comando di sistema con un timeout predefinito di 2 minuti.

Previsto per l'uso quando il dispositivo è già in modalità di avvio rapido.

Parametri
cmdArgs String : il comando fastboot e gli argomenti da eseguire

ritorna
CommandResult il CommandResult contenente l'output del comando

Lancia
DeviceNotAvailableException

eseguire il comando Fastboot

public CommandResult executeFastbootCommand (long timeout, 
                String... cmdArgs)

Metodo di supporto che esegue un comando fastboot come comando di sistema.

Previsto per l'uso quando il dispositivo è già in modalità di avvio rapido.

Parametri
timeout long : il tempo in millisecondi prima della scadenza del comando

cmdArgs String : il comando fastboot e gli argomenti da eseguire

ritorna
CommandResult il CommandResult contenente l'output del comando

Lancia
DeviceNotAvailableException

eseguire il comando Long Fastboot

public CommandResult executeLongFastbootCommand (String... cmdArgs)

Metodo di supporto che esegue un comando fastboot di lunga durata come comando di sistema.

Identico executeFastbootCommand(String) tranne che utilizza un timeout più lungo.

Parametri
cmdArgs String : il comando Fastboot e gli argomenti da eseguire

ritorna
CommandResult Il comandResult contenente output di comando

Lancia
DeviceNotAvailableException

ExecutelongFastBootCommand

public CommandResult executeLongFastbootCommand ( envVarMap, 
                String... cmdArgs)

Metodo helper che esegue un comando Fastboot a lungo termine come comando di sistema con variabili di ambiente di sistema.

Identico a executeFastbootCommand(String) tranne un timeout più lungo.

Parametri
envVarMap : Variabili di ambiente di sistema con cui esegue il comando Fastboot

cmdArgs String : il comando Fastboot e gli argomenti da eseguire

ritorna
CommandResult Il comandResult contenente output di comando

Lancia
DeviceNotAvailableException

ExecuteShellCommand

public String executeShellCommand (String command)

Metodo helper che esegue un comando shell ADB e restituisce l'output come String .

Parametri
command String : il comando adb shell da eseguire

ritorna
String L'output della shell

Lancia
DeviceNotAvailableException

ExecuteShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Esegue un comando shell ADB, con più parametri per controllare il comportamento del comando.

Parametri
command String : il comando adb shell da eseguire

receiver IShellOutputReceiver : l' IShellOutputReceiver per dirigere l'output della shell su.

maxTimeToOutputShellResponse long : la quantità massima di tempo durante il quale il comando è consentito non produrre alcuna risposta; Unità come specificato in timeUnit

timeUnit TimeUnit : unità per maxTimeToOutputShellResponse

retryAttempts int : il numero massimo di volte per riprovare il comando se non riesce a causa di un'eccezione. DevicenotresponsiveException verrà lanciato se retryAttempts vengono eseguiti senza successo.

Lancia
DeviceNotAvailableException

ExecuteShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeoutForCommand, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Esegue un comando shell ADB, con più parametri per controllare il comportamento del comando.

Parametri
command String : il comando adb shell da eseguire

receiver IShellOutputReceiver : l' IShellOutputReceiver per dirigere l'output della shell su.

maxTimeoutForCommand long : il timeout massimo per il completamento del comando; Unità come specificato in timeUnit

maxTimeToOutputShellResponse long : la quantità massima di tempo durante il quale il comando è consentito non produrre alcuna risposta; Unità come specificato in timeUnit

timeUnit TimeUnit : unità per maxTimeToOutputShellResponse

retryAttempts int : il numero massimo di volte per riprovare il comando se non riesce a causa di un'eccezione. DevicenotresponsiveException verrà lanciato se retryAttempts vengono eseguiti senza successo.

Lancia
DeviceNotAvailableException

ExecuteShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Esegue il comando ADB Shell fornito, ritenendo più volte se il comando fallisce.

Una forma più semplice di executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) con valori predefiniti.

Parametri
command String : il comando adb shell da eseguire

receiver IShellOutputReceiver : l' IShellOutputReceiver per dirigere l'output della shell su.

Lancia
DeviceNotAvailableException

ExecuteShellv2Command

public CommandResult executeShellV2Command (String cmd)

Metodo helper che esegue un comando shell ADB e restituisce i risultati come CommandResult correttamente popolato con l'output di stato del comando, STDOUT e STDERR.

Parametri
cmd String : il comando che dovrebbe essere eseguito.

ritorna
CommandResult Il risultato in CommandResult .

Lancia
DeviceNotAvailableException

ExecuteShellv2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

Metodo helper che esegue un comando shell ADB e restituisce i risultati come CommandResult correttamente popolato con l'output di stato del comando e STDERR. stdout è diretto al flusso specificato.

Parametri
cmd String : il comando che dovrebbe essere eseguito.

pipeToOutput OutputStream : ERROR(/OutputStream) in cui verrà reindirizzato l'uscita STD o NULL.

ritorna
CommandResult Il risultato in CommandResult .

Lancia
DeviceNotAvailableException

ExecuteShellv2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

Metodo helper che esegue un comando shell ADB e restituisce i risultati come CommandResult correttamente popolato con l'output di stato del comando, STDOUT e STDERR.

Parametri
cmd String : il comando che dovrebbe essere eseguito.

pipeAsInput File : un ERROR(/File) che verrà convocato come input per il comando o null.

ritorna
CommandResult Il risultato in CommandResult .

Lancia
DeviceNotAvailableException

ExecuteShellv2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Esegue un comando shell ADB, con più parametri per controllare il comportamento del comando.

Parametri
cmd String : il comando adb shell da eseguire

maxTimeoutForCommand long : il timeout massimo per il completamento del comando; Unità come specificato in timeUnit

timeUnit TimeUnit : unità per maxTimeToOutputShellResponse

retryAttempts int : il numero massimo di volte per riprovare il comando se non riesce a causa di un'eccezione. DevicenotresponsiveException verrà lanciato se retryAttempts vengono eseguiti senza successo.

ritorna
CommandResult

Lancia
DeviceNotAvailableException

ExecuteShellv2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

Esegue un comando shell ADB, con più parametri per controllare il comportamento del comando.

Parametri
cmd String : il comando adb shell da eseguire

maxTimeoutForCommand long : il timeout massimo per il completamento del comando; Unità come specificato in timeUnit

timeUnit TimeUnit : unità per maxTimeToOutputShellResponse

ritorna
CommandResult

Lancia
DeviceNotAvailableException

ExecuteShellv2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Esegue un comando shell ADB, con più parametri per controllare il comportamento del comando.

Parametri
cmd String : il comando adb shell da eseguire

pipeAsInput File : un ERROR(/File) che verrà convocato come input per il comando o null.

pipeToOutput OutputStream : ERROR(/OutputStream) in cui verrà reindirizzato l'uscita STD o NULL.

maxTimeoutForCommand long : il timeout massimo per il completamento del comando; Unità come specificato in timeUnit

timeUnit TimeUnit : unità per maxTimeToOutputShellResponse

retryAttempts int : il numero massimo di volte per riprovare il comando se non riesce a causa di un'eccezione. DevicenotresponsiveException verrà lanciato se retryAttempts vengono eseguiti senza successo.

ritorna
CommandResult

Lancia
DeviceNotAvailableException

ExecuteShellv2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Esegue un comando shell ADB, con più parametri per controllare il comportamento del comando.

Parametri
cmd String : il comando adb shell da eseguire

pipeAsInput File : un ERROR(/File) che verrà convocato come input per il comando o null.

pipeToOutput OutputStream : ERROR(/OutputStream) in cui verrà reindirizzato l'uscita STD o NULL.

pipeToError OutputStream : ERROR(/OutputStream) in cui l'errore STD verrà reindirizzato o null.

maxTimeoutForCommand long : il timeout massimo per il completamento del comando; Unità come specificato in timeUnit

timeUnit TimeUnit : unità per maxTimeToOutputShellResponse

retryAttempts int : il numero massimo di volte per riprovare il comando se non riesce a causa di un'eccezione. DevicenotresponsiveException verrà lanciato se retryAttempts vengono eseguiti senza successo.

ritorna
CommandResult

Lancia
DeviceNotAvailableException

FastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

Metodo helper che cancella una partizione per il dispositivo.

Se è true getUseFastbootErase() , la cancellazione di Fastboot verrà utilizzata per pulire la partizione. Il dispositivo deve quindi creare un filesystem la prossima volta che il dispositivo si avvia. Altrimenti, viene utilizzato il formato Fastboot che creerà un nuovo filesystem sul dispositivo.

Si prevede che venga utilizzato quando il dispositivo è già in modalità Fastboot.

Parametri
partition String : la partizione per pulire

ritorna
CommandResult Il comandResult contenente output di comando

Lancia
DeviceNotAvailableException

getActiveapexes

public  getActiveApexes ()

Prendere le informazioni sugli apice attivati ​​sul dispositivo.

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

Lancia
DeviceNotAvailableException

getallsettings

public  getAllSettings (String namespace)

Restituisci le coppie del valore del tasto dello spazio dei nomi richiesto.

Parametri
namespace String : deve essere uno di {"sistema", "sicuro", "globale"}

ritorna
La mappa delle coppie di valore chiave. NULL Se lo spazio dei nomi non è supportato.

Lancia
DeviceNotAvailableException

getAllocationState

public DeviceAllocationState getAllocationState ()

Restituisci lo stato di allocazione corrente del dispositivo

ritorna
DeviceAllocationState

getandroidid

public String getAndroidId (int userId)

Trova e restituisce l'ID Android associato a un Userid, null se non trovato.

Parametri
userId int

ritorna
String

Lancia
DeviceNotAvailableException

getandroidids

public  getAndroidIds ()

Crea una mappa di ID Android trovati ID utente corrispondenti. Non vi è alcuna assicurazione che ogni ID utente sarà trovato un ID Android associato in questa funzione in modo che alcuni ID utente possano corrispondere a NULL.

ritorna
Mappa degli ID Android trovati ID utente corrispondenti.

Lancia
DeviceNotAvailableException

getApilevel

public int getApiLevel ()

Ottieni il livello API del dispositivo. Predefiniti su UNKNOWN_API_LEVEL .

ritorna
int un numero intero che indica il livello API del dispositivo

Lancia
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Prendi informazioni su un pacchetto installato sul dispositivo.

Parametri
packageName String

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

Lancia
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

Fetch Informazioni sui pacchetti installati sul dispositivo.

ritorna
ERROR(/List) di PackageInfo S installato sul dispositivo.

Lancia
DeviceNotAvailableException

GetBaseBandversion

public String getBasebandVersion ()

Metodo di convenienza per ottenere la versione Baseband (radio) di questo dispositivo. Ottenere la versione radio è specifico del dispositivo, quindi potrebbe non restituire le informazioni corrette per tutti i dispositivi. Questo metodo si basa su GSM.Version.baseband Propery per restituire le informazioni sulla versione corrette. Questo non è accurato per alcuni dispositivi CDMA e la versione restituita qui potrebbe non corrispondere alla versione segnalata da Fastboot e potrebbe non restituire la versione per la radio CDMA. TL; DR Questo metodo riporta una versione accurata solo se la proprietà GSM.Version.Baseband è la stessa della versione restituita da fastboot getvar version-baseband .

ritorna
String La versione di String Baseband o null se non può essere determinata (il dispositivo non è possibile leggere la stringa di radio o versione)

Lancia
DeviceNotAvailableException

getbattery

public Integer getBattery ()

Restituisce l'attuale livello della batteria di un dispositivo o NULL se non è disponibile il livello della batteria.

ritorna
Integer

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

Restituisce il valore booleano della proprietà data.

Parametri
name String : il nome della proprietà

defaultValue boolean : valore predefinito da restituire se la proprietà è vuota o non esiste.

ritorna
boolean true se la proprietà ha valore "1" , "y" , "yes" , "on" o "true" , false se la proprietà ha un valore di "0" , "n" , "no" , "off" , "false" o defaultValue altrimenti.

Lancia
DeviceNotAvailableException

getboothistory

public  getBootHistory ()

Il metodo Helper raccoglie la mappa della cronologia di avvio con il tempo di avvio e la ragione di avvio.

ritorna
Mappa del tempo di avvio (ora UTC in secondo luogo dal motivo dell'epoca) e di avvio

Lancia
DeviceNotAvailableException

getboothistorysince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

Il metodo helper raccoglie la mappa della cronologia di avvio con il tempo di avvio e la ragione di avvio dal momento da parte dell'epoca dal dispositivo e dall'unità di tempo specificata. L'attuale dispositivo utcepochtime in millisecond può essere ottenuto tramite metodo getDeviceDate() .

Parametri
utcEpochTime long : il tempo del dispositivo dall'epoca.

timeUnit TimeUnit : The Time Unit TimeUnit .

ritorna
Mappa del tempo di avvio (ora UTC in secondo luogo dal motivo dell'epoca) e di avvio

Lancia
DeviceNotAvailableException

getbootloaderversion

public String getBootloaderVersion ()

Metodo di convenienza per ottenere la versione bootloader di questo dispositivo.

Tenterà di recuperare la versione bootloader dallo stato corrente del dispositivo. (cioè se il dispositivo è in modalità Fastboot, tenterà di recuperare la versione da Fastboot)

ritorna
String la versione bootloader String o null se non è possibile trovare

Lancia
DeviceNotAvailableException

getbugreport

public InputStreamSource getBugreport ()

Recupera un BugReport dal dispositivo.

L'implementazione di ciò è garantita per continuare a lavorare su un dispositivo senza una SDCARD (o dove la SDCard non è ancora montata).

ritorna
InputStreamSource Un InputStreamSource che produrrà i contenuti di BugReport on Demand. In caso di guasto, InputStreamSource produrrà un ERROR(/InputStream) .

getbugreportz

public InputStreamSource getBugreportz ()

Recupera un bugreportz dal dispositivo. BugReport Format Zip contiene il BugReport e altri file di registro principali che sono utili per il debug.

Supportato solo per "versione ADB"> 1.0.36

ritorna
InputStreamSource Un InputStreamSource del file zip contenente BugReportz, restituire NULL in caso di errore.

getbuildalias

public String getBuildAlias ()

Recupera l'alias della build che il dispositivo è attualmente in esecuzione.

Build Alias ​​è di solito una stringa più leggibile dell'ID build (in genere un numero per build Nexus). Ad esempio, la versione finale di Android 4.2 ha costruzione alias JDQ39 e build ID 573038

ritorna
String Build Alias ​​o ricadere per build ID se non poteva essere recuperato

Lancia
DeviceNotAvailableException

getbuildflavor

public String getBuildFlavor ()

Recupera il sapore di build per il dispositivo.

ritorna
String il sapore di costruzione o nullo se non poteva essere recuperato

Lancia
DeviceNotAvailableException

getBuildid

public String getBuildId ()

Recupera la build Il dispositivo è attualmente in esecuzione.

ritorna
String L'ID build o IBuildInfo#UNKNOWN_BUILD_ID se non potesse essere recuperato

Lancia
DeviceNotAvailableException

getBuildsigningKeys

public String getBuildSigningKeys ()

Restituisce il tipo chiave utilizzato per firmare l'immagine del dispositivo

In genere i dispositivi Android possono essere firmati con tasti di prova (come in AOSP) o di rilascio (controllati dai singoli produttori di dispositivi)

ritorna
String La chiave di firma se trovata, null altrimenti.

Lancia
DeviceNotAvailableException

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

Restituisce un DeviceDescriptor memorizzato nella cache se il dispositivo viene assegnato, altrimenti restituisce l'attuale DeviceDescriptor .

ritorna
DeviceDescriptor

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Restituisce un DeviceDescriptor memorizzato nella cache se il dispositivo viene assegnato, altrimenti restituisce l'attuale DeviceDescriptor .

Parametri
shortDescriptor boolean : se limitare o meno il descrittore a indicare informazioni minime

ritorna
DeviceDescriptor

getchildren

public String[] getChildren (String path)

Alternativa all'utilizzo IFileEntry che a volte non funzionerà a causa delle autorizzazioni.

Parametri
path String : è il percorso sul dispositivo dove eseguire la ricerca

ritorna
String[] Array di stringa contenente tutto il file in un percorso sul dispositivo.

Lancia
DeviceNotAvailableException

getconnection

public AbstractConnection getConnection ()

La connessione corrente associata al dispositivo.

ritorna
AbstractConnection

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

ritorna
DeviceFoldableState

Lancia
DeviceNotAvailableException

getcurrentuser

public int getCurrentUser ()

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

ritorna
int

Lancia
DeviceNotAvailableException

getdeviceclass

public String getDeviceClass ()

Ottieni la classe del dispositivo.

ritorna
String la classe del dispositivo String .

getDevicete

public long getDeviceDate ()

Restituisci la data del dispositivo in millisecondi dall'epoca.

ritorna
long La data del dispositivo in formato epocale.

Lancia
DeviceNotAvailableException

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

Restituisci un DeviceDescriptor dalle informazioni sul dispositivo per ottenere informazioni su di esso senza passare l'oggetto dispositivo reale.

ritorna
DeviceDescriptor

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Restituisci un DeviceDescriptor dalle informazioni sul dispositivo per ottenere informazioni su di esso senza passare l'oggetto dispositivo reale.

Parametri
shortDescriptor boolean : se limitare o meno il descrittore a indicare informazioni minime

ritorna
DeviceDescriptor

getDevicestate

public TestDeviceState getDeviceState ()

Ottieni lo stato del dispositivo.

ritorna
TestDeviceState

getdevicetimeoffset

public long getDeviceTimeOffset (Date date)

Aiutante per ottenere la differenza di tempo tra il dispositivo e un determinato ERROR(/Date) . Usa il tempo di epoca internamente.

Parametri
date Date

ritorna
long La differenza in millisecondi

Lancia
DeviceNotAvailableException

getEmularOutput

public InputStreamSource getEmulatorOutput ()

Ottieni il flusso di emulatore stdout e stderr

ritorna
InputStreamSource Output dell'emulatore

getemulatorprocess

public Process getEmulatorProcess ()

Restituisci il Process corrispondente a questo emulatore.

ritorna
Process il Process o null

getExecutellCommandlog

public final File getExecuteShellCommandLog ()

Il registro che contiene tutti i registri executeShellCommand(String) .

ritorna
File

getExternalStorefRepace

public long getExternalStoreFreeSpace ()

Metodo helper per determinare la quantità di spazio libero sulla memoria esterna del dispositivo.

ritorna
long La quantità di spazio libero in KB

Lancia
DeviceNotAvailableException

getfastbootpath

public String getFastbootPath ()

Restituisce il percorso del binario Fastboot utilizzato. Richiede ancora isFastbootEnabled() per essere vera, per avere funzioni di stivale veloce abilitato.

ritorna
String

getfastbootproductType

public String getFastbootProductType ()

Metodo di convenienza per ottenere il tipo di prodotto di questo dispositivo quando è in modalità Fastboot.

Questo metodo deve essere utilizzato solo se il dispositivo deve essere in rapido advidico. È una variante un po 'più sicura rispetto al metodo generico getProductType() in questo caso, perché ItestDevice saprà recuperare il dispositivo in Fastboot se il dispositivo è in stato errata o non risponde.

ritorna
String il nome del tipo di prodotto String o null se non può essere determinato

Lancia
DeviceNotAvailableException

getfastbootProductVariant

public String getFastbootProductVariant ()

Metodo di convenienza per ottenere il tipo di prodotto di questo dispositivo quando è in modalità Fastboot.

Questo metodo deve essere utilizzato solo se il dispositivo deve essere in rapido advidico. È una variante un po 'più sicura rispetto al metodo generico getProductType() in questo caso, perché ItestDevice saprà recuperare il dispositivo in Fastboot se il dispositivo è in stato errata o non risponde.

ritorna
String il nome del tipo di prodotto String o null se non può essere determinato

Lancia
DeviceNotAvailableException

GetfastBootserialNumber

public String getFastbootSerialNumber ()

Restituisce il numero di serie della modalità Fastboot.

ritorna
String

getfastbootvariable

public String getFastbootVariable (String variableName)

Recupera il valore variabile Fastboot dato dal dispositivo.

Parametri
variableName String : il nome della variabile

ritorna
String il valore della proprietà o null se non esiste

Lancia
DeviceNotAvailableException

getfastbootversion

public String getFastbootVersion ()

Restituisce la stringa di versione del binario Fastboot utilizzato. O null se qualcosa va storto.

ritorna
String

GetfileEntry

public IFileEntry getFileEntry (String path)

Recupera un riferimento a un file remoto sul dispositivo.

Parametri
path String : il percorso del file da recuperare. Può essere un percorso o un percorso assoluto rispetto a '/'. (cioè la sintassi "/sistema" e "sistema" è supportata)

ritorna
IFileEntry non è possibile trovare IFileEntry o null se il file a determinato path

Lancia
DeviceNotAvailableException

GetfileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Aiutante non ufficiale per ottenere un FileEntry da un percorso non root. Fixme: refactor Il sistema FileEntry per averlo disponibile da qualsiasi percorso. (anche non radice).

Parametri
entry FileListingService.FileEntry : un FileEntry non è necessariamente root come richiesto da ddmlib.

ritorna
IFileEntry un fileentrywrapper che rappresenta il fileentry.

Lancia
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getfoldablestates

public  getFoldableStates ()

Restituisce l'elenco degli stati pieghevoli sul dispositivo. Può essere ottenuto con "CMD Device_State Stamping State".

ritorna

Lancia
DeviceNotAvailableException

getidevice

public IDevice getIDevice ()

Restituisce un riferimento IDevice associato.

Un nuovo IDevice può essere assegnato da DDMS ogni volta che il dispositivo si disconnette e si riconnette da ADB. Pertanto, i chiamanti non dovrebbero mantenere un riferimento IDevice , poiché quel riferimento può diventare stantio.

ritorna
IDevice l' IDevice

GetInstalledPackAgenames

public  getInstalledPackageNames ()

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

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

Lancia
DeviceNotAvailableException

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

Restituisce il valore intero della proprietà data dal dispositivo.

Parametri
name String : il nome della proprietà

defaultValue long : valore predefinito da restituire se la proprietà è vuota o non esiste.

ritorna
long Il valore della proprietà o defaultValue se la proprietà è vuota, non esiste o non ha un valore intero.

Lancia
DeviceNotAvailableException

getipaddress

public String getIpAddress ()

Ottiene l'indirizzo IP del dispositivo.

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

Lancia
DeviceNotAvailableException

getkeyguardstate

public KeyguardControllerState getKeyguardState ()

Restituisci un oggetto per ottenere lo stato attuale della guardia key o null se non supportato.

ritorna
KeyguardControllerState Un KeyguardControllerState contenente un'istantanea dello stato della guardia dei tasti e restituisce null se la query di guardia di chiave non è supportata.

Lancia
DeviceNotAvailableException

getLastexpectedRebooTimeMillis

public long getLastExpectedRebootTimeMillis ()

Restituisce l'ultima volta che le API FEDFED hanno innescato un riavvio in millisecondi da quando Epoch è tornato da System.currentTimeMillis() .

ritorna
long

getlaunchapilevel

public int getLaunchApiLevel ()

Ottieni il primo livello API lanciato dal dispositivo. Predefiniti su UNKNOWN_API_LEVEL .

ritorna
int un numero intero che indica il primo livello di dispositivo avviato

Lancia
DeviceNotAvailableException

getlogcat

public InputStreamSource getLogcat ()

Afferra un flusso di istantanee dei dati LogCat.

Funziona in due modalità:

  • Se il logcat viene attualmente catturato in background, tornerà su TestDeviceOptions.getMaxLogcatDataSize() byte del contenuto corrente della cattura di Logcat in background
  • In caso contrario, restituirà un dump statico dei dati LogCAT se il dispositivo sta attualmente rispondendo

    ritorna
    InputStreamSource

  • getlogcat

    public InputStreamSource getLogcat (int maxBytes)

    Afferra un flusso di istantanee degli ultimi maxBytes dei dati LogCat catturati.

    Utile per i casi in cui si desidera catturare le snapshot frequenti dei dati di Logcat acquisiti senza incorrere nella penalità di spazio del disco potenzialmente grande di ottenere l'intera istantanea getLogcat() .

    Parametri
    maxBytes int : la quantità massima di dati da restituire. Dovrebbe essere una quantità che può adattarsi comodamente alla memoria

    ritorna
    InputStreamSource

    getlogcatdump

    public InputStreamSource getLogcatDump ()

    Ottieni un dump del logcat corrente per il dispositivo. A differenza di getLogcat() , questo metodo restituirà sempre un dump statico del logcat.

    Ha lo svantaggio che nulla verrà restituito se il dispositivo non è raggiungibile.

    ritorna
    InputStreamSource Un InputStreamSource dei dati LogCAT. Viene restituito un flusso vuoto se non cattura i dati di Logcat.

    getlogcatsince

    public InputStreamSource getLogcatSince (long date)

    Afferra un flusso di snapshot di dati di logcat acquisiti a partire dalla data fornita. Il tempo sul dispositivo deve essere utilizzato getDeviceDate() .

    Parametri
    date long : in millisecondi dal formato epocale di quando iniziare l'istantanea fino al presente. (può essere ottenuto utilizzando "Data +%S")

    ritorna
    InputStreamSource

    getmacaddress

    public String getMacAddress ()

    Restituisce l'indirizzo MAC del dispositivo, null se non riesce a interrogare dal dispositivo.

    ritorna
    String

    getMainUserid

    public Integer getMainUserId ()

    Restituisce l'ID utente principale.

    ritorna
    Integer L'utente dell'utente principale se ce n'è uno e null se non esiste un utente principale.

    Lancia
    DeviceNotAvailableException

    GetMainLineModuleInfo

    public  getMainlineModuleInfo ()

    Ottieni le informazioni sui moduli principali installati sul dispositivo.

    ritorna
    ERROR(/Set) dei moduli String Mainline attualmente installati sul dispositivo.

    Lancia
    DeviceNotAvailableException

    GetMaxNumberOfrningSersSupported

    public int getMaxNumberOfRunningUsersSupported ()

    Ottieni il numero massimo di utenti supportati contemporaneamente. Predefinito è 0.

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

    Lancia
    DeviceNotAvailableException

    GetMaxNumberOfUserSsupported

    public int getMaxNumberOfUsersSupported ()

    Ottieni il numero massimo di utenti supportati. Predefinito è 0.

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

    Lancia
    DeviceNotAvailableException

    getmicrodroidprocess

    public Process getMicrodroidProcess ()

    ritorna
    Process Restituisce il processo della VM di microdroide. Se TestDevice non è un microdroide, restituisce null.

    getMonitor

    public IDeviceStateMonitor getMonitor ()

    Restituisci l' IDeviceStateMonitor associato al dispositivo.

    ritorna
    IDeviceStateMonitor

    getmountpoint

    public String getMountPoint (String mountName)

    Restituisce un punto di montaggio.

    Interroga il dispositivo direttamente se le informazioni memorizzate nella cache in IDevice non sono disponibili.

    TODO: sposta questo comportamento su IDevice#getMountPoint(String)

    Parametri
    mountName String : il nome del punto di montaggio

    ritorna
    String il punto di montaggio o null

    getMountPointInfo

    public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    Restituisce un MountPointInfo corrispondente al percorso MountPoint specificato o null se quel percorso non ha nulla montato o altrimenti non appare in /proc /monta come un mountpoint.

    Parametri
    mountpoint String

    ritorna
    ITestDevice.MountPointInfo Un ERROR(/List) di MountPointInfo contenente le informazioni in "/proc/mount"

    Lancia
    DeviceNotAvailableException

    getMountPointInfo

    public  getMountPointInfo ()

    Restituisce una versione analizzata delle informazioni in /proc /montes sul dispositivo

    ritorna
    Un ERROR(/List) di MountPointInfo contenente le informazioni in "/proc/mount"

    Lancia
    DeviceNotAvailableException

    getoptions

    public TestDeviceOptions getOptions ()

    Prendi le opzioni di test per il dispositivo.

    ritorna
    TestDeviceOptions TestDeviceOptions correlati al dispositivo in esame.

    getpartitionfrespace

    public long getPartitionFreeSpace (String partition)

    Metodo helper per determinare la quantità di spazio libero sulla partizione del dispositivo.

    Parametri
    partition String

    ritorna
    long La quantità di spazio libero in KB

    Lancia
    DeviceNotAvailableException

    GetPrimaryUserid

    public Integer getPrimaryUserId ()

    Restituisce l'ID utente principale.

    ritorna
    Integer l'utente dell'utente primario se ce n'è uno e null se non esiste un utente primario.

    Lancia
    DeviceNotAvailableException

    getprocessbyname

    public ProcessInfo getProcessByName (String processName)

    Il metodo helper esegue il comando "PIDOF" e "STAT" e restituisce l'oggetto ProcessInfo con PID e il tempo di inizio del processo del processo dato.

    Parametri
    processName String : la stringa di nome Proces.

    ritorna
    ProcessInfo ProcessInfo di un determinato processo di processo

    Lancia
    DeviceNotAvailableException

    getProcessPid

    public String getProcessPid (String process)

    Restituisce il PID del servizio o nullo se qualcosa è andato storto.

    Parametri
    process String : la stringa di nome Proces.

    ritorna
    String

    Lancia
    DeviceNotAvailableException

    GetProducTType

    public String getProductType ()

    Metodo di convenienza per ottenere il tipo di prodotto di questo dispositivo.

    Questo metodo funzionerà se il dispositivo è in modalità ADB o Fastboot.

    ritorna
    String Il nome del tipo di prodotto String . Non sarà nullo

    Lancia
    DeviceNotAvailableException

    getProductVariant

    public String getProductVariant ()

    Metodo di convenienza per ottenere la variante del prodotto di questo dispositivo.

    Questo metodo funzionerà se il dispositivo è in modalità ADB o Fastboot.

    ritorna
    String il nome variante del prodotto String o null se non può essere determinato

    Lancia
    DeviceNotAvailableException

    getproperty

    public String getProperty (String name)

    Recupera il valore della proprietà dato dal dispositivo.

    Parametri
    name String : il nome della proprietà

    ritorna
    String il valore della proprietà o null se non esiste

    Lancia
    DeviceNotAvailableException

    getRecoverymode

    public ITestDevice.RecoveryMode getRecoveryMode ()

    Ottieni la modalità di ripristino corrente utilizzata per il dispositivo.

    ritorna
    ITestDevice.RecoveryMode La modalità di ripristino corrente utilizzata per il dispositivo.

    getcreenshot

    public InputStreamSource getScreenshot (String format)

    Afferra uno screenshot dal dispositivo. Consigliato di utilizzare GetScreenshot (formato) invece con la codifica JPEG per dimensioni inferiori

    Parametri
    format String : PNG supportato, JPEG

    ritorna
    InputStreamSource un InputStreamSource dello screenshot in formato o null se lo screenshot non ha avuto successo.

    Lancia
    DeviceNotAvailableException

    getcreenshot

    public InputStreamSource getScreenshot (long displayId)

    Afferra uno screenshot dal dispositivo fornito ID display. Il formato è PNG.

    TODO: estendi le implementazioni sopra per supportare il "formato" e "RISCALE"

    Parametri
    displayId long : l'ID di visualizzazione dello schermo per ottenere lo screenshot da.

    ritorna
    InputStreamSource un InputStreamSource dello screenshot in formato o null se lo screenshot non ha avuto successo.

    Lancia
    DeviceNotAvailableException

    getcreenshot

    public InputStreamSource getScreenshot (String format, 
                    boolean rescale)

    Afferra uno screenshot dal dispositivo. Consigliato di utilizzare getScreenshot(String) invece con la codifica JPEG per dimensioni inferiori.

    Parametri
    format String : PNG supportato, JPEG

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

    ritorna
    InputStreamSource un InputStreamSource dello screenshot in formato o null se lo screenshot non ha avuto successo.

    Lancia
    DeviceNotAvailableException

    getcreenshot

    public InputStreamSource getScreenshot ()

    Afferra uno screenshot dal dispositivo.

    ritorna
    InputStreamSource un InputStreamSource dello screenshot in formato PNG o null se lo screenshot non ha avuto successo.

    Lancia
    DeviceNotAvailableException

    getherialnumber

    public String getSerialNumber ()

    Metodo di convenienza per ottenere il numero di serie di questo dispositivo.

    ritorna
    String il numero di serie String

    gettatura

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

    Restituisci il valore dell'impostazione richiesta. Lo spazio dei nomi deve essere uno di: {"sistema", "sicuro", "globale"}

    Parametri
    userId int

    namespace String

    key String

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

    Lancia
    DeviceNotAvailableException

    gettatura

    public String getSetting (String namespace, 
                    String key)

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

    Parametri
    namespace String

    key String

    ritorna
    String

    Lancia
    DeviceNotAvailableException

    getimoperator

    public String getSimOperator ()

    Restituisci l'operatore della scheda SIM o NULL se non disponibile o se il dispositivo non è disponibile.

    ritorna
    String

    getimstate

    public String getSimState ()

    Restituisci lo stato della scheda SIM o NULL se non disponibile o dispositivo non è disponibile.

    ritorna
    String

    GetTomb Stones

    public  getTombstones ()

    Fetch e restituire l'elenco delle pietre tombali dai dispositivi. Richiede radice.

    Il metodo è il miglior sforzo, quindi se una lapide non viene tirata per qualsiasi motivo, mancherà dall'elenco. Solo un DeviceNotAvailableException terminerà presto il metodo.

    ritorna
    Un elenco di file di tomba, vuoto se nessuna tomba.

    Lancia
    DeviceNotAvailableException

    gettotalmemory

    public long getTotalMemory ()

    Restituisce la dimensione totale della memoria fisica in byte o -1 in caso di errore interno

    ritorna
    long

    getuninstallablepackagenames

    public  getUninstallablePackageNames ()

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

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

    Lancia
    DeviceNotAvailableException

    getusefastbooterase

    public boolean getUseFastbootErase ()

    Ottieni se utilizzare Fastboot Cancella o Fastboot Formato per pulire una partizione sul dispositivo.

    ritorna
    boolean true se verrà utilizzato la cancellazione di Fastboot o false se verrà utilizzato il formato Fastboot.

    getuserflags

    public int getUserFlags (int userId)

    Trova e restituisce le flag di un determinato utente. Le bandiere sono definite nella classe "Android.content.pm.Userinfo" nel progetto open source Android.

    Parametri
    userId int

    ritorna
    int I flag associati all'Is UserId forniti se trovati, -10000 in qualsiasi altro caso.

    Lancia
    DeviceNotAvailableException

    getuserinfos

    public  getUserInfos ()

    Ottieni la mappa di useid su UserInfo sul dispositivo. Lancerà DeviceRuntimeException se l'uscita dal dispositivo non è come previsto.

    ritorna
    L'elenco degli oggetti UserInfo.

    Lancia
    DeviceNotAvailableException

    GetUSerserialNumber

    public int getUserSerialNumber (int userId)

    Restituisci il numero di serie associato all'UserID se trovato, -10000 in qualsiasi altro caso.

    Parametri
    userId int

    ritorna
    int

    Lancia
    DeviceNotAvailableException

    HandleallLocationEvent

    public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

    Elaborare il dispositivo dato. Può il dispositivo di transizione in nuovo stato. Informerà l' IDeviceMonitor di qualsiasi transizione statale.

    Elaborare il dispositivoEvent, che può o meno passare questo dispositivo a un nuovo stato di allocazione.

    Parametri
    event DeviceEvent

    ritorna
    IManagedTestDevice.DeviceEventResponse

    Hasfeature

    public boolean hasFeature (String feature)

    Controlla se una funzione è disponibile su un dispositivo.

    Parametri
    feature String : quale formato dovrebbe essere "Funzione: " O " "Direttamente.

    ritorna
    boolean Vero se si trova la funzione, falso altrimenti.

    Lancia
    DeviceNotAvailableException

    InstallaPackage

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

    Installa un pacchetto Android sul dispositivo.

    Parametri
    packageFile File : il file APK da installare

    reinstall boolean : true se si deve eseguire una reinstallazione

    extraArgs String : argomenti extra opzionali da passare. Vedi "ADB Shell PM -H" per le opzioni disponibili.

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

    Lancia
    DeviceNotAvailableException

    InstallaPackage

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

    Installa un pacchetto Android sul dispositivo.

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

    Parametri
    packageFile File : il file APK da installare

    reinstall boolean : true se si deve eseguire una reinstallazione

    grantPermissions boolean : se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione

    extraArgs String : argomenti extra opzionali da passare. Vedi "ADB Shell PM -H" per le opzioni disponibili.

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

    Lancia
    DeviceNotAvailableException

    InstallPackageForUuser

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

    Installa un pacchetto Android sul dispositivo per un determinato utente.

    Parametri
    packageFile File : il file APK da installare

    reinstall boolean : true se si deve eseguire una reinstallazione

    userId int : l'ID utente intero da installare.

    extraArgs String : argomenti extra opzionali da passare. Vedi "ADB Shell PM -H" per le opzioni disponibili.

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

    Lancia
    DeviceNotAvailableException

    InstallPackageForUuser

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

    Installa un pacchetto Android sul dispositivo per un determinato utente.

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

    Parametri
    packageFile File : il file APK da installare

    reinstall boolean : true se si deve eseguire una reinstallazione

    grantPermissions boolean : se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione

    userId int : l'ID utente intero da installare.

    extraArgs String : argomenti extra opzionali da passare. Vedi "ADB Shell PM -H" per le opzioni disponibili.

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

    Lancia
    DeviceNotAvailableException

    InvalidatePropertycache

    public void invalidatePropertyCache ()

    Isadbroot

    public boolean isAdbRoot ()

    ritorna
    boolean

    Lancia
    DeviceNotAvailableException

    ISADBTCP

    public boolean isAdbTcp ()

    ritorna
    boolean

    ISappenumerations supportato

    public boolean isAppEnumerationSupported ()

    Controlla se la piattaforma sull'enumerazione dell'app supporta il dispositivo

    ritorna
    boolean Vero se l'enumerazione dell'app è supportata, false altrimenti

    Lancia
    DeviceNotAvailableException

    ISBYPASLOWTARGETSDKBLOCKSUPPORT

    public boolean isBypassLowTargetSdkBlockSupported ()

    Controllare se la piattaforma sul dispositivo supporta il bypassing Blocco SDK target basso sulle installazioni di app

    ritorna
    boolean Vero se il blocco SDK bersaglio a basso taglio è supportato, falso altrimenti

    Lancia
    DeviceNotAvailableException

    isdebugfsmount

    public boolean isDebugfsMounted ()

    Controlla se Debugfs è montato.

    ritorna
    boolean true se Debugfs è montato

    Lancia
    DeviceNotAvailableException

    isdeviceencrypted

    public boolean isDeviceEncrypted ()

    Restituisce se il dispositivo è crittografato.

    ritorna
    boolean true se il dispositivo è crittografato.

    Lancia
    DeviceNotAvailableException

    isdirectory

    public boolean isDirectory (String path)

    Restituisce true se il percorso sul dispositivo è una directory, false altrimenti.

    Parametri
    path String

    ritorna
    boolean

    Lancia
    DeviceNotAvailableException

    isenableadbroot

    public boolean isEnableAdbRoot ()

    ritorna
    boolean true se la radice ADB deve essere abilitata sul dispositivo

    è supportato

    public boolean isEncryptionSupported ()

    Restituisce se la crittografia è supportata sul dispositivo.

    ritorna
    boolean true se il dispositivo supporta la crittografia.

    Lancia
    DeviceNotAvailableException

    isEcutable

    public boolean isExecutable (String fullPath)

    Restituisce vero se il percorso del file sul dispositivo è un file eseguibile, falso altrimenti.

    Parametri
    fullPath String

    ritorna
    boolean

    Lancia
    DeviceNotAvailableException

    isfastbootenabled

    public boolean isFastbootEnabled ()

    Restituisci se Fastboot è disponibile per il dispositivo.

    ritorna
    boolean

    isheadless

    public boolean isHeadless ()

    Restituisce true se il dispositivo è senza testa (nessuna schermata), falso altrimenti.

    ritorna
    boolean

    Lancia
    DeviceNotAvailableException

    isheadlessystemuserMode

    public boolean isHeadlessSystemUserMode ()

    Restituisce se il dispositivo utilizza la modalità utente del sistema senza testa.

    ritorna
    boolean

    Lancia
    DeviceNotAvailableException

    ismainuserpermanentadmin

    public boolean isMainUserPermanentAdmin ()

    Restituisce se l'utente principale è un amministratore permanente e non può essere eliminato o declassato allo stato non addmin.

    ritorna
    boolean

    Lancia
    DeviceNotAvailableException

    ismultioSersupported

    public boolean isMultiUserSupported ()

    Determina se il multi utente è supportato.

    ritorna
    boolean Vero se il multi utente è supportato, falso altrimenti

    Lancia
    DeviceNotAvailableException

    IspackageInstalled

    public boolean isPackageInstalled (String packageName, 
                    String userId)

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

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

    userId String : l'ID utente che stiamo controllando il pacchetto è installato. Se NULL, verrà utilizzato lo zero dell'utente primario.

    ritorna
    boolean Vero se il pacchetto viene riportato come installato. Falso altrimenti.

    Lancia
    DeviceNotAvailableException

    IspackageInstalled

    public boolean isPackageInstalled (String packageName)

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

    Parametri
    packageName String

    ritorna
    boolean Vero se il pacchetto viene riportato come installato. Falso altrimenti.

    Lancia
    DeviceNotAvailableException

    isruntimepermissions supportato

    public boolean isRuntimePermissionSupported ()

    Controlla se la piattaforma sul dispositivo supporta la concessione dell'autorizzazione di runtime

    ritorna
    boolean Vero se l'autorizzazione di runtime è supportata, false altrimenti.

    Lancia
    DeviceNotAvailableException

    ISSTATEBOOTLOOTHARDERORFASTBOOTD

    public boolean isStateBootloaderOrFastbootd ()

    Restituisce vero se il dispositivo è in TestDeviceState#FASTBOOT o TestDeviceState.FASTBOOTD .

    ritorna
    boolean

    isuserrunning

    public boolean isUserRunning (int userId)

    Controlla se un determinato utente è in esecuzione.

    Parametri
    userId int

    ritorna
    boolean Vero se l'utente è in esecuzione, falso in ogni altro caso.

    Lancia
    DeviceNotAvailableException

    isusersecondary

    public boolean isUserSecondary (int userId)

    Restituisce se l'utente specificato è un utente secondario in base alle sue flag.

    Parametri
    userId int

    ritorna
    boolean Vero se l'utente è secondario, falso altrimenti.

    Lancia
    DeviceNotAvailableException

    isuservisibile

    public boolean isUserVisible (int userId)

    Verifica se l'utente dato è visibile.

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

    Parametri
    userId int

    ritorna
    boolean

    Lancia
    DeviceNotAvailableException

    isuservisibleOndisplay

    public boolean isUserVisibleOnDisplay (int userId, 
                    int displayId)

    Verifica se l'utente dato è visibile nel display indicato.

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

    Parametri
    userId int

    displayId int

    ritorna
    boolean

    Lancia
    DeviceNotAvailableException

    ISVisibleBackGroundUseSondefaultDisplaysupportato

    public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

    ritorna
    boolean

    Lancia
    DeviceNotAvailableException

    ISVisibleBackGroundSersSsupported

    public boolean isVisibleBackgroundUsersSupported ()

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

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

    ritorna
    boolean

    Lancia
    DeviceNotAvailableException

    iswifienabled

    public boolean isWifiEnabled ()

    Test se WiFi è abilitato.

    Verifica se WiFi è abilitato sul dispositivo. Utile per far valere lo stato WiFi prima dei test che non dovrebbero funzionare con WiFi, ad es. Test di dati mobili.

    ritorna
    boolean true se WiFi è abilitato. false se disabilitato

    Lancia
    DeviceNotAvailableException

    ListDisplayids

    public  listDisplayIds ()

    Raccogli l'elenco dei display disponibili ID sul dispositivo come riportato da "Dumpsys Surfaceflinger".

    ritorna
    L'elenco dei display. L'impostazione predefinita restituisce sempre il display predefinito 0.

    Lancia
    DeviceNotAvailableException

    ListDisplayIdsForStartingVisibleBoundUsers

    public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

    ritorna

    Lancia
    DeviceNotAvailableException

    Listuser

    public  listUsers ()

    Ottiene l'elenco degli utenti sul dispositivo. Lancerà DeviceRuntimeException se l'uscita dal dispositivo non è come previsto.

    ritorna
    L'elenco degli ID utente.

    Lancia
    DeviceNotAvailableException

    Loganrs

    public boolean logAnrs (ITestLogger logger)

    Raccogli e registri gli anRS dal dispositivo.

    Parametri
    logger ITestLogger : un ITestLogger per registrare gli anrs.

    ritorna
    boolean Vero se la registrazione ha avuto successo, falso altrimenti.

    Lancia
    DeviceNotAvailableException

    logbugreport

    public boolean logBugreport (String dataName, 
                    ITestLogger listener)

    Metodo helper per prendere un BugReport e registrarlo ai giornalisti.

    Parametri
    dataName String : nome in base al quale verrà segnalato BugReport.

    listener ITestLogger : un ITestLogger per registrare BugReport.

    ritorna
    boolean Vero se la registrazione ha avuto successo, falso altrimenti.

    Logondevice

    public void logOnDevice (String tag, 
                    Log.LogLevel level, 
                    String format, 
                    Object... args)

    Registra un messaggio nel logcat del dispositivo. Questa è una chiamata sicura che non lancerà anche se la registrazione fallisce.

    Parametri
    tag String : il tag in cui registriamo il nostro messaggio nel logcat.

    level Log.LogLevel : il livello di debug del messaggio nel logcat.

    format String : il formato del messaggio.

    args Object : l'args da sostituire tramite String.Format ().

    Mountdebugfs

    public void mountDebugfs ()

    Mount Debugfs.

    Lancia
    DeviceNotAvailableException

    non bloccante

    public void nonBlockingReboot ()

    Emette un comando per riavviare il dispositivo e restituisce il comando completo e quando il dispositivo non è più visibile all'ADB.

    Lancia
    DeviceNotAvailableException

    PostadBrootaction

    public void postAdbRootAction ()

    Sostituire se il dispositivo necessita di alcune azioni specifiche da intraprendere dopo la root ADB e prima che il dispositivo torni online. L'implementazione predefinita non include alcuna azione di addizione. La radice ADB non è garantita per essere abilitata in questa fase.

    Lancia
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    Postadbunrootaction

    public void postAdbUnrootAction ()

    Sostituire se il dispositivo necessita di alcune azioni specifiche da intraprendere dopo ADB Straot e prima che il dispositivo torni online. L'implementazione predefinita non include alcuna azione aggiuntiva. La radice ADB non è garantita per essere disabilitata in questa fase.

    Lancia
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    PostbootSetUp

    public void postBootSetup ()

    Eseguire le istruzioni per configurare il dispositivo per il test dopo ogni avvio.

    Dovrebbe essere chiamato dopo che il dispositivo è completamente avviato/disponibile

    In circostanze normali questo metodo non deve essere chiamato esplicitamente, poiché le implementazioni dovrebbero eseguire automaticamente questi passaggi durante l'esecuzione di un riavvio.

    Dove potrebbe essere necessario chiamare è quando il dispositivo si riavvia a causa di altri eventi (ad es. Quando è stato completato un comando di aggiornamento rapido)

    Lancia
    DeviceNotAvailableException

    PostInvocationTeardown

    public void postInvocationTearDown (Throwable exception)

    Passaggi aggiuntivi per il dispositivo specifico richiesto Cleans che verrà eseguito dopo aver effettuato l'invocazione.

    Parametri
    exception Throwable : se presente, l'ultima eccezione sollevata dall'errore di invocazione.

    preinvocationsetup

    public void preInvocationSetup (IBuildInfo info, 
                    MultiMap<String, String> attributes)

    Passaggi aggiuntivi per il dispositivo specifico Impostazione richiesta che verrà eseguita sul dispositivo prima del flusso di invocazione.

    Parametri
    info IBuildInfo : l' IBuildInfo del dispositivo.

    attributes MultiMap : gli attributi memorizzati nel contesto di invocazione

    Lancia
    DeviceNotAvailableException
    TargetSetupError

    pulldir

    public boolean pullDir (String deviceFilePath, 
                    File localDir)

    Tirare in modo ricorsivo il contenuto della directory dal dispositivo.

    Parametri
    deviceFilePath String : il percorso del file assoluto della sorgente remota

    localDir File : la directory locale per attirare i file in

    ritorna
    boolean true if file was pulled successfully. false otherwise.

    Lancia
    DeviceNotAvailableException

    pullFile

    public boolean pullFile (String remoteFilePath, 
                    File localFile)

    Retrieves a file off device.

    Parametri
    remoteFilePath String : the absolute path to file on device.

    localFile File : the local file to store contents in. If non-empty, contents will be replaced.

    ritorna
    boolean true if file was retrieved successfully. false otherwise.

    Lancia
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath, 
                    int userId)

    Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

    Parametri
    remoteFilePath String : the absolute path to file on device.

    userId int : The user id to pull from

    ritorna
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Lancia
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath)

    Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

    Parametri
    remoteFilePath String : the absolute path to file on device.

    ritorna
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Lancia
    DeviceNotAvailableException

    pullFile

    public boolean pullFile (String remoteFilePath, 
                    File localFile, 
                    int userId)

    Retrieves a file off device.

    Parametri
    remoteFilePath String : the absolute path to file on device.

    localFile File : the local file to store contents in. If non-empty, contents will be replaced.

    userId int : The user id to pull from

    ritorna
    boolean true if file was retrieved successfully. false otherwise.

    Throws
    DeviceNotAvailableException

    pullFileContents

    public String pullFileContents (String remoteFilePath)

    Retrieves a file off device, and returns the contents.

    Parametri
    remoteFilePath String : the absolute path to file on device.

    ritorna
    String A String containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Throws
    DeviceNotAvailableException

    pullFileFromExternal

    public File pullFileFromExternal (String remoteFilePath)

    A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File) , and return a reference to that File .

    Parametri
    remoteFilePath String : the path to file on device, relative to the device's external storage mountpoint

    ritorna
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Throws
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath, 
                     excludedDirectories)

    Recursively push directory contents to device while excluding some directories that are filtered.

    Parametri
    localFileDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    excludedDirectories : Set of excluded directories names that shouldn't be pushed.

    ritorna
    boolean true if file was pushed successfully. false otherwise.

    Throws
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath)

    Recursively push directory contents to device.

    Parametri
    localFileDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    ritorna
    boolean true if file was pushed successfully. false otherwise.

    Throws
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                    String remoteFilePath, 
                    boolean evaluateContentProviderNeeded)

    Variant of pushFile(File, String) which can optionally consider evaluating the need for the content provider.

    Parametri
    localFile File : the local file to push

    remoteFilePath String : the remote destination absolute file path

    evaluateContentProviderNeeded boolean : whether to check if we need the content provider

    ritorna
    boolean true if file was pushed successfully. false otherwise.

    Throws
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                    String remoteFilePath)

    Push a file to device. By default using a content provider.

    Parametri
    localFile File : the local file to push

    remoteFilePath String : the remote destination absolute file path

    ritorna
    boolean true if file was pushed successfully. false otherwise.

    Throws
    DeviceNotAvailableException

    pushString

    public boolean pushString (String contents, 
                    String remoteFilePath)

    Push file created from a string to device

    Parametri
    contents String : the contents of the file to push

    remoteFilePath String : the remote destination absolute file path

    ritorna
    boolean true if string was pushed successfully. false otherwise.

    Throws
    DeviceNotAvailableException

    riavviare

    public void reboot (String reason)

    Reboots the device into adb mode with given reason to be persisted across reboot.

    Blocks until device becomes available.

    Last reboot reason can be obtained by querying sys.boot.reason propety.

    Parametri
    reason String : a reason for this reboot, or null if no reason is specified.

    Throws
    DeviceNotAvailableException

    riavviare

    public void reboot ()

    Reboots the device into adb mode.

    Blocks until device becomes available.

    Lancia
    DeviceNotAvailableException

    rebootIntoBootloader

    public void rebootIntoBootloader ()

    Reboots the device into bootloader mode.

    Blocks until device is in bootloader mode.

    Throws
    DeviceNotAvailableException

    rebootIntoFastbootd

    public void rebootIntoFastbootd ()

    Reboots the device into fastbootd mode.

    Blocks until device is in fastbootd mode.

    Throws
    DeviceNotAvailableException

    rebootIntoRecovery

    public void rebootIntoRecovery ()

    Reboots the device into adb recovery mode.

    Blocks until device enters recovery

    Throws
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload ()

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    Throws
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload (boolean autoReboot)

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    Parametri
    autoReboot boolean : whether to automatically reboot the device after sideload

    Throws
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline ()

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    Throws
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline (String reason)

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    Parametri
    reason String : a reason for this reboot, or null if no reason is specified.

    Throws
    DeviceNotAvailableException

    rebootUserspace

    public void rebootUserspace ()

    Reboots only userspace part of device.

    Blocks until device becomes available.

    AVVERTIMENTO. Userspace reboot is currently under active development, use it on your own risk.

    Lancia
    DeviceNotAvailableException

    rebootUserspaceUntilOnline

    public void rebootUserspaceUntilOnline ()

    An alternate to rebootUserspace() ()} that only blocks until device is online ie visible to adb.

    Throws
    DeviceNotAvailableException

    recoverDevice

    public boolean recoverDevice ()

    Attempts to recover device communication.

    ritorna
    boolean True if recovery attempted and successful, returns False if recovery was skipped

    Throws
    DeviceNotAvailableException if device is no longer available

    registerDeviceActionReceiver

    public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

    Registers a IDeviceActionReceiver for this device.

    All registered IDeviceActionReceiver s will be notified before a device action starts and after the device action ends.

    Parametri
    deviceActionReceiver IDeviceActionReceiver : A IDeviceActionReceiver which will be registered.

    remountSystemReadOnly

    public void remountSystemReadOnly ()

    Make the system partition on the device read-only. May reboot the device.

    Throws
    DeviceNotAvailableException

    remountSystemWritable

    public void remountSystemWritable ()

    Make the system partition on the device writable. May reboot the device.

    Throws
    DeviceNotAvailableException

    remountVendorReadOnly

    public void remountVendorReadOnly ()

    Make the vendor partition on the device read-only. May reboot the device.

    Throws
    DeviceNotAvailableException

    remountVendorWritable

    public void remountVendorWritable ()

    Make the vendor partition on the device writable. May reboot the device.

    Lancia
    DeviceNotAvailableException

    removeAdmin

    public boolean removeAdmin (String componentName, 
                    int userId)

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

    Parametri
    componentName String : of device admin to be removed.

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

    ritorna
    boolean True if it is successful, false otherwise.

    Throws
    DeviceNotAvailableException

    removeOwners

    public void removeOwners ()

    Remove all existing device profile owners with the best effort.

    Throws
    DeviceNotAvailableException

    removeUser

    public boolean removeUser (int userId)

    Remove a given user from the device.

    Parametri
    userId int : of the user to remove

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

    Throws
    DeviceNotAvailableException

    resetContentProviderSetup

    public void resetContentProviderSetup ()

    Reset the flag for content provider setup in order to trigger it again.

    runInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                    ITestLifeCycleReceiver... listeners)

    Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) with one or more listeners passed as parameters.

    Parametri
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners ITestLifeCycleReceiver : the test result listener(s)

    ritorna
    boolean true if test command completed. false if it failed to complete, but recovery succeeded

    Throws
    DeviceNotAvailableException

    runInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    Runs instrumentation tests, and provides device recovery.

    If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.

    If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.

    Parametri
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners : the test result listeners

    ritorna
    boolean true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded

    Throws
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

    public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                    int userId, 
                     listeners)

    Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) but runs the test for the given user.

    Parametri
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    ritorna
    boolean

    Throws
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

    public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                    int userId, 
                    ITestLifeCycleReceiver... listeners)

    Same as ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) but runs the test for a given user.

    Parametri
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    ritorna
    boolean

    Throws
    DeviceNotAvailableException

    setConfiguration

    public void setConfiguration (IConfiguration configuration)

    Injects the IConfiguration in use.

    Parametri
    configuration IConfiguration

    setConnectionAvdInfo

    public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

    Parametri
    avdInfo GceAvdInfo

    impostare la data

    public void setDate (Date date)

    Sets the date on device

    Note: setting date on device requires root

    Parametri
    date Date : specify a particular date; will use host date if null

    Throws
    DeviceNotAvailableException

    setDeviceOwner

    public boolean setDeviceOwner (String componentName, 
                    int userId)

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

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

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

    ritorna
    boolean True if it is successful, false otherwise.

    Lancia
    DeviceNotAvailableException

    setDeviceState

    public void setDeviceState (TestDeviceState deviceState)

    Update the device's state.

    Parametri
    deviceState TestDeviceState : the TestDeviceState

    setEmulatorOutputStream

    public void setEmulatorOutputStream (SizeLimitedOutputStream output)

    For emulator set SizeLimitedOutputStream to log output

    Parametri
    output SizeLimitedOutputStream : to log the output

    setEmulatorProcess

    public void setEmulatorProcess (Process p)

    Sets the Process , when this device is an emulator.

    Parametri
    p Process

    setFastbootEnabled

    public void setFastbootEnabled (boolean fastbootEnabled)

    Set the fastboot option for the device. Should be set when device is first allocated.

    Parametri
    fastbootEnabled boolean : whether fastboot is available for the device or not

    setFastbootPath

    public void setFastbootPath (String fastbootPath)

    Sets the path to the fastboot binary that should be used. Still requires isFastbootEnabled() to be true, to have fastboot functions enabled.

    Parametri
    fastbootPath String

    setIDevice

    public void setIDevice (IDevice newDevice)

    Update the IDevice associated with this ITestDevice.

    The new IDevice must refer the same physical device as the current reference. This method will be called if DDMS has allocated a new IDevice

    Parametri
    newDevice IDevice : the IDevice

    setLogStartDelay

    public void setLogStartDelay (int delay)

    Sets the time in ms to wait before starting logcat capture for a online device.

    Parametri
    delay int : the delay in ms

    setOptions

    public void setOptions (TestDeviceOptions options)

    Set the TestDeviceOptions for the device

    Parametri
    options TestDeviceOptions

    setProperty

    public boolean setProperty (String propKey, 
                    String propValue)

    Sets the given property value on the device. Requires adb root is true.

    Parametri
    propKey String : The key targeted to be set.

    propValue String : The property value to be set.

    ritorna
    boolean returns True if the setprop command was successful, False otherwise.

    Throws
    DeviceNotAvailableException

    setRecovery

    public void setRecovery (IDeviceRecovery recovery)

    Set the IDeviceRecovery to use for this device. Should be set when device is first allocated.

    Parametri
    recovery IDeviceRecovery : the IDeviceRecovery

    setRecoveryMode

    public void setRecoveryMode (ITestDevice.RecoveryMode mode)

    Set the current recovery mode to use for the device.

    Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etc

    Parametri
    mode ITestDevice.RecoveryMode : whether 'recover till online only' mode should be on or not.

    setSetting

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

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

    Parametri
    namespace String

    key String

    value String

    Throws
    DeviceNotAvailableException

    setSetting

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

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

    Parametri
    userId int

    namespace String

    key String

    value String

    Throws
    DeviceNotAvailableException

    setTestLogger

    public void setTestLogger (ITestLogger testLogger)

    Injects the ITestLogger instance

    Parametri
    testLogger ITestLogger

    setUseFastbootErase

    public void setUseFastbootErase (boolean useFastbootErase)

    Set whether to use fastboot erase or fastboot format to wipe a partition on the device.

    Parametri
    useFastbootErase boolean : true if fastboot erase should be used or false if fastboot format should be used.

    startLogcat

    public void startLogcat ()

    Start capturing logcat output from device in the background.

    Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat.

    When the device is no longer in use, stopLogcat() must be called.

    startLogcat() and stopLogcat() do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat.

    startUser

    public boolean startUser (int userId)

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

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

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

    Throws
    DeviceNotAvailableException

    startUser

    public boolean startUser (int userId, 
                    boolean waitFlag)

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

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

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

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

    Throws
    DeviceNotAvailableException

    startVisibleBackgroundUser

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

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

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

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

    displayId int : display to start user visible on

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

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

    Throws
    DeviceNotAvailableException

    stopEmulatorOutput

    public void stopEmulatorOutput ()

    Close and delete the emulator output.

    stopLogcat

    public void stopLogcat ()

    Stop capturing logcat output from device, and discard currently saved logcat data.

    Will have no effect if logcat output is not being captured.

    stopUser

    public boolean stopUser (int userId)

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

    Parametri
    userId int : of the user to stop.

    ritorna
    boolean true if the user was successfully stopped.

    Throws
    DeviceNotAvailableException

    stopUser

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

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

    Parametri
    userId int : of the user to stop.

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

    forceFlag boolean : will force stop the user.

    ritorna
    boolean true if the user was successfully stopped.

    Throws
    DeviceNotAvailableException

    switchToAdbTcp

    public String switchToAdbTcp ()

    Switch device to adb-over-tcp mode.

    ritorna
    String the tcp serial number or null if device could not be switched

    Throws
    DeviceNotAvailableException

    switchToAdbUsb

    public boolean switchToAdbUsb ()

    Switch device to adb over usb mode.

    ritorna
    boolean true if switch was successful, false otherwise.

    Throws
    DeviceNotAvailableException

    cambia utente

    public boolean switchUser (int userId)

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

    Parametri
    userId int

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

    Throws
    DeviceNotAvailableException

    cambia utente

    public boolean switchUser (int userId, 
                    long timeout)

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

    Parametri
    userId int

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

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

    Throws
    DeviceNotAvailableException

    syncFiles

    public boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

    Incrementally syncs the contents of a local file directory to device.

    Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date.

    Hidden files (with names starting with ".") will be ignored.

    Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.

    Parametri
    localFileDir File : the local file directory containing files to recursively push.

    deviceFilePath String : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail

    ritorna
    boolean true if files were synced successfully. false otherwise.

    Throws
    DeviceNotAvailableException

    takeBugreport

    public Bugreport takeBugreport ()

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

    ritorna
    Bugreport

    uninstallPackage

    public String uninstallPackage (String packageName)

    Uninstall an Android package from device.

    Parametri
    packageName String : the Android package to uninstall

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

    Throws
    DeviceNotAvailableException

    uninstallPackageForUser

    public String uninstallPackageForUser (String packageName, 
                    int userId)

    Uninstall an Android package from device for a given user.

    Parametri
    packageName String : the Android package to uninstall

    userId int : the integer user id to uninstall for.

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

    Throws
    DeviceNotAvailableException

    unlockDevice

    public boolean unlockDevice ()

    Unlocks the device if the device is in an encrypted state.

    This method may restart the framework but will not call postBootSetup() . Therefore, the device might not be fully ready to be tested when this method returns.

    ritorna
    boolean true if successful or if the device is unencrypted.

    Throws
    DeviceNotAvailableException

    unmountDebugfs

    public void unmountDebugfs ()

    Unmount debugfs.

    Throws
    DeviceNotAvailableException

    waitForBootComplete

    public boolean waitForBootComplete (long timeOut)

    Blocks until the device's boot complete flag is set.

    Parametri
    timeOut long : time in msecs to wait for the flag to be set

    ritorna
    boolean true if device's boot complete flag is set within the timeout

    Throws
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable ()

    Waits for the device to be responsive and available for testing. Uses default timeout.

    ritorna
    boolean True if device is available, False if recovery is disabled and unavailable.

    Throws
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable (long waitTime)

    Waits for the device to be responsive and available for testing.

    Parametri
    waitTime long : the time in ms to wait

    ritorna
    boolean True if device is available, False if recovery is disabled and unavailable.

    Throws
    DeviceNotAvailableException

    waitForDeviceAvailableInRecoverPath

    public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    Waits for the device to be responsive and available without considering recovery path.

    Parametri
    waitTime long

    ritorna
    boolean True if device is available, False if unavailable.

    Throws
    DeviceNotAvailableException

    waitForDeviceBootloader

    public void waitForDeviceBootloader ()

    Blocks until device is visible via fastboot. Use default timeout.

    Throws
    DeviceNotAvailableException

    waitForDeviceInRecovery

    public boolean waitForDeviceInRecovery (long waitTime)

    Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery ).

    Parametri
    waitTime long : the time in ms to wait

    ritorna
    boolean true if device boots into recovery before time expires. false otherwise

    waitForDeviceInSideload

    public boolean waitForDeviceInSideload (long waitTime)

    Blocks for the device to be in the 'adb sideload' state

    Parametri
    waitTime long : the time in ms to wait

    ritorna
    boolean true if device boots into sideload before time expires. false otherwise

    waitForDeviceNotAvailable

    public boolean waitForDeviceNotAvailable (long waitTime)

    Blocks for the device to be not available ie missing from adb

    Parametri
    waitTime long : the time in ms to wait

    ritorna
    boolean true if device becomes not available before time expires. false otherwise

    waitForDeviceOnline

    public void waitForDeviceOnline ()

    Blocks until device is visible via adb. Uses default timeout

    Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

    Throws
    DeviceNotAvailableException

    waitForDeviceOnline

    public void waitForDeviceOnline (long waitTime)

    Blocks until device is visible via adb.

    Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

    Parametri
    waitTime long : the time in ms to wait

    Throws
    DeviceNotAvailableException

    waitForDeviceShell

    public boolean waitForDeviceShell (long waitTime)

    Waits for device to be responsive to a basic adb shell command.

    Parametri
    waitTime long : the time in ms to wait

    ritorna
    boolean true if device becomes responsive before waitTime elapses.

    Metodi protetti

    addExtraConnectionBuilderArgs

    protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

    Parametri
    builder DefaultConnection.ConnectionBuilder

    buildAdbShellCommand

    protected String[] buildAdbShellCommand (String command, 
                    boolean forceExitStatusDetection)

    Builds the OS command for the given adb shell command session and args

    Parametri
    command String

    forceExitStatusDetection boolean

    ritorna
    String[]

    checkApiLevelAgainst

    protected void checkApiLevelAgainst (String feature, 
                    int strictMinLevel)

    Parametri
    feature String

    strictMinLevel int

    createRebootDeviceAction

    protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                    String reason)

    Create a RebootDeviceAction to be used when performing a reboot action.

    Parametri
    rebootMode NativeDevice.RebootMode : a mode of this reboot.

    reason String : for this reboot.

    ritorna
    NativeDevice.RebootDeviceAction the created RebootDeviceAction .

    createRunUtil

    protected IRunUtil createRunUtil ()

    ritorna
    IRunUtil

    doAdbReboot

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

    Perform a adb reboot.

    Parametri
    rebootMode NativeDevice.RebootMode : a mode of this reboot.

    reason String : for this reboot.

    Throws
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    ensureRuntimePermissionSupported

    protected void ensureRuntimePermissionSupported ()

    helper method to throw exception if runtime permission isn't supported

    Throws
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getApiLevelSafe

    protected int getApiLevelSafe ()

    ritorna
    int

    getLogger

    protected ITestLogger getLogger ()

    ritorna
    ITestLogger

    getRunUtil

    protected IRunUtil getRunUtil ()

    Get the RunUtil instance to use.

    ritorna
    IRunUtil

    initializeConnection

    protected void initializeConnection (IBuildInfo info, 
                    MultiMap<String, String> attributes)

    Parametri
    info IBuildInfo

    attributes MultiMap

    Throws
    DeviceNotAvailableException
    TargetSetupError

    internalGetProperty

    protected String internalGetProperty (String propName, 
                    String fastbootVar, 
                    String description)

    Fetch a device property, from the ddmlib cache by default, and falling back to either `adb shell getprop` or `fastboot getvar` depending on whether the device is in Fastboot or not.

    Parametri
    propName String : The name of the device property as returned by `adb shell getprop`

    fastbootVar String : The name of the equivalent fastboot variable to query. if null , fastboot query will not be attempted

    description String : A simple description of the variable. First letter should be capitalized.

    ritorna
    String A string, possibly null or empty, containing the value of the given property

    Throws
    DeviceNotAvailableException

    isInRebootCallback

    protected boolean isInRebootCallback ()

    Returns whether reboot callbacks is currently being executed or not. All public api's for reboot should be disabled if true.

    ritorna
    boolean

    isNewer

    protected boolean isNewer (File localFile, 
                    IFileEntry entry)

    Return true if local file is newer than remote file. IFileEntry being accurate to the minute, in case of equal times, the file will be considered newer.

    Parametri
    localFile File

    entry IFileEntry

    ritorna
    boolean

    notifyRebootEnded

    protected void notifyRebootEnded ()

    Notifies all IDeviceActionReceiver about reboot end event.

    Throws
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    notifyRebootStarted

    protected void notifyRebootStarted ()

    Notifies all IDeviceActionReceiver about reboot start event.

    Throws
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    performDeviceAction

    protected boolean performDeviceAction (String actionDescription, 
                    NativeDevice.DeviceAction action, 
                    int retryAttempts)

    Performs an action on this device. Attempts to recover device and optionally retry command if action fails.

    Parametri
    actionDescription String : a short description of action to be performed. Used for logging purposes only.

    action NativeDevice.DeviceAction : the action to be performed

    retryAttempts int : the retry attempts to make for action if it fails but recovery succeeds

    ritorna
    boolean true if action was performed successfully

    Throws
    DeviceNotAvailableException if recovery attempt fails or max attempts done without success

    postAdbReboot

    protected void postAdbReboot ()

    Possible extra actions that can be taken after a reboot.

    Throws
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    prePostBootSetup

    protected void prePostBootSetup ()

    Allows each device type (AndroidNativeDevice, TestDevice) to override this method for specific post boot setup.

    Throws
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    pullFileInternal

    protected boolean pullFileInternal (String remoteFilePath, 
                    File localFile)

    Parametri
    remoteFilePath String

    localFile File

    ritorna
    boolean

    Throws
    DeviceNotAvailableException

    imposta l'orologio

    protected void setClock (Clock clock)

    Set the Clock instance to use.

    Parametri
    clock Clock

    setMicrodroidProcess

    protected void setMicrodroidProcess (Process process)

    Marks the TestDevice as microdroid and sets its CID.

    Parametri
    process Process : Process of the Microdroid VM.

    setTestDeviceOptions

    protected void setTestDeviceOptions ( deviceOptions)

    Parametri
    deviceOptions

    simpleFastbootCommand

    protected CommandResult simpleFastbootCommand (long timeout, 
                     envVarMap, 
                    String[] fullCmd)

    Executes a simple fastboot command with environment variables and report the status of the command.

    Parametri
    timeout long

    envVarMap

    fullCmd String

    ritorna
    CommandResult

    simpleFastbootCommand

    protected CommandResult simpleFastbootCommand (long timeout, 
                    String[] fullCmd)

    Executes a simple fastboot command and report the status of the command.

    Parametri
    timeout long

    fullCmd String

    ritorna
    CommandResult

    waitForDeviceNotAvailable

    protected boolean waitForDeviceNotAvailable (String operationDesc, 
                    long time)

    Wait to see the device going unavailable (stop reporting to adb).

    Parametri
    operationDesc String : The name of the operation that is waiting for unavailable.

    time long : The time to wait for unavailable to occur.

    ritorna
    boolean True if device did become unavailable.