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 |
class | NativeDevice.AdbShellAction |
class | NativeDevice.RebootDeviceAction |
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 | |
---|---|
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 |
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 |
boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk) Una variante di |
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' |
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 |
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 |
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 |
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 | executeShellV2Command (String cmd, OutputStream pipeToOutput) Metodo di supporto che esegue un comando della shell adb e restituisce i risultati come |
CommandResult | executeShellV2Command (String cmd, File pipeAsInput) Metodo di supporto che esegue un comando della shell adb e restituisce i risultati come |
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 | getCachedDeviceDescriptor (boolean shortDescriptor) Restituisce un |
String[] | getChildren (String path) Alternativa all'utilizzo |
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 | getDeviceDescriptor (boolean shortDescriptor) Restituisce un |
TestDeviceState | getDeviceState () Ottieni lo stato del dispositivo. |
long | getDeviceTimeOffset (Date date) Aiutante per ottenere la differenza oraria tra il dispositivo e un determinato |
InputStreamSource | getEmulatorOutput () Ottieni il flusso dell'emulatore stdout e stderr |
Process | getEmulatorProcess () Restituisce il |
final File | getExecuteShellCommandLog () Il log che contiene tutti i log |
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 |
getFoldableStates () Restituisce l'elenco degli stati pieghevoli nel dispositivo. | |
IDevice | getIDevice () Restituisce un riferimento |
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 |
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 |
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' |
String | getMountPoint (String mountName) Restituisce un punto di montaggio. |
ITestDevice.MountPointInfo | getMountPointInfo (String mountpoint) Restituisce un |
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 |
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 |
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 | |
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 | 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 |
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 |
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 | |
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 | nonBlockingReboot () Emette un comando per riavviare il dispositivo e ritorna al termine 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 |
File | pullFile (String remoteFilePath) Recupera un file dal dispositivo, lo archivia in un |
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 |
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 |
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 |
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 |
void | rebootUntilOnline (String reason) Un'alternativa a |
void | rebootUserspace () Riavvia solo la parte dello spazio utente del dispositivo. |
void | rebootUserspaceUntilOnline () Un'alternativa a |
boolean | recoverDevice () Tenta di ripristinare la comunicazione del dispositivo. |
void | registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) Registra un |
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 |
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 |
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 |
boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) Uguale a |
void | setConfiguration ( IConfiguration configuration) Inietta la |
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 |
void | setEmulatorProcess (Process p) Imposta |
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 |
boolean | setProperty (String propKey, String propValue) Imposta il valore della proprietà specificata sul dispositivo. |
void | setRecovery ( IDeviceRecovery recovery) Imposta |
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 |
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 |
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 |
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. |
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 |
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 |
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 |
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 |
void | notifyRebootEnded () Notifica a tutti |
void | notifyRebootStarted () Notifica a tutti |
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
SCHEDA SD
protected static final String SD_CARD
STOCCAGGIO_EMULATO
protected static final String STORAGE_EMULATED
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 garantireITestDevice#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 | |
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à chiamatoITestDevice#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 |
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à chiamatoITestDevice#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 | |
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.
IdenticoexecuteFastbootCommand(String)
tranne che utilizza un timeout più lungo.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 Long Fastboot
public CommandResult 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.
Identico executeFastbootCommand(String)
tranne che utilizza un timeout più lungo.
Parametri | |
---|---|
envVarMap | |
cmdArgs | String : il comando fastboot e gli argomenti da eseguire |
ritorna | |
---|---|
CommandResult | il CommandResult contenente l'output del comando |
Lancia | |
---|---|
DeviceNotAvailableException |
eseguireShellCommand
public String executeShellCommand (String command)
Metodo helper che esegue un comando shell adb e restituisce l'output come String
.
Parametri | |
---|---|
command | String : il comando della shell adb da eseguire |
ritorna | |
---|---|
String | l'output della shell |
Lancia | |
---|---|
DeviceNotAvailableException |
eseguireShellCommand
public 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.
Parametri | |
---|---|
command | String : il comando della shell adb da eseguire |
receiver | IShellOutputReceiver : IShellOutputReceiver a cui indirizzare l'output della shell. |
maxTimeToOutputShellResponse | long : il periodo di tempo massimo durante il quale il comando può non emettere 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 diexecuteShellCommand(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
publicgetActiveApexes ()
Prendere le informazioni sugli apice attivati sul dispositivo.
ritorna | |
---|---|
ERROR(/Set) di ApexInfo attualmente attivato sul dispositivo |
Lancia | |
---|---|
DeviceNotAvailableException |
getallsettings
publicgetAllSettings (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
publicgetAndroidIds ()
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
publicgetAppPackageInfos ()
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
publicgetBootHistory ()
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
publicgetBootHistorySince (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 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 genericogetProductType()
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 genericogetProductType()
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
publicgetFoldableStates ()
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.
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
publicgetInstalledPackageNames ()
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à:
TestDeviceOptions.getMaxLogcatDataSize()
byte del contenuto corrente della cattura di Logcat in backgroundritorna | |
---|---|
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
publicgetMainlineModuleInfo ()
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. Il valore 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. Il valore 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 inIDevice
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
publicgetMountPointInfo ()
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
publicgetTombstones ()
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
publicgetUninstallablePackageNames ()
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
publicgetUserInfos ()
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: |
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 ()
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 |
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
publiclistDisplayIds ()
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
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
Ottiene l'elenco dei display che possono essere utilizzati per start a user visible in the background
.
ritorna | |
---|---|
Lancia | |
---|---|
DeviceNotAvailableException |
Listuser
publiclistUsers ()
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 (). |
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 se il file è stato tirato correttamente. false altrimenti. |
Lancia | |
---|---|
DeviceNotAvailableException |
Pullfile
public boolean pullFile (String remoteFilePath, File localFile)
Recupera un dispositivo file off.
Parametri | |
---|---|
remoteFilePath | String : il percorso assoluto da file sul dispositivo. |
localFile | File : il file locale per archiviare i contenuti in. Se non vuoto, i contenuti verranno sostituiti. |
ritorna | |
---|---|
boolean | true se il file è stato recuperato correttamente. false altrimenti. |
Lancia | |
---|---|
DeviceNotAvailableException |
Pullfile
public File pullFile (String remoteFilePath, int userId)
Recupera un dispositivo file off, lo memorizza in un ERROR(/File)
e restituisce quel File
.
Parametri | |
---|---|
remoteFilePath | String : il percorso assoluto da file sul dispositivo. |
userId | int : l'ID utente da trarre da |
ritorna | |
---|---|
File | Un ERROR(/File) contenente il contenuto del file del dispositivo o null se la copia non è riuscita per qualsiasi motivo (inclusi i problemi con il filesystem host) |
Lancia | |
---|---|
DeviceNotAvailableException |
Pullfile
public File pullFile (String remoteFilePath)
Recupera un dispositivo file off, lo memorizza in un ERROR(/File)
e restituisce quel File
.
Parametri | |
---|---|
remoteFilePath | String : il percorso assoluto da file sul dispositivo. |
ritorna | |
---|---|
File | Un ERROR(/File) contenente il contenuto del file del dispositivo o null se la copia non è riuscita per qualsiasi motivo (inclusi i problemi con il filesystem host) |
Lancia | |
---|---|
DeviceNotAvailableException |
Pullfile
public boolean pullFile (String remoteFilePath, File localFile, int userId)
Recupera un dispositivo file off.
Parametri | |
---|---|
remoteFilePath | String : il percorso assoluto da file sul dispositivo. |
localFile | File : il file locale per archiviare i contenuti in. Se non vuoto, i contenuti verranno sostituiti. |
userId | int : l'ID utente da trarre da |
ritorna | |
---|---|
boolean | true se il file è stato recuperato correttamente. false altrimenti. |
Lancia | |
---|---|
DeviceNotAvailableException |
PullfileContents
public String pullFileContents (String remoteFilePath)
Recupera un dispositivo file off e restituisce il contenuto.
Parametri | |
---|---|
remoteFilePath | String : il percorso assoluto da file sul dispositivo. |
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) |
Lancia | |
---|---|
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) |
Lancia | |
---|---|
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 |
ritorna | |
---|---|
boolean | true if file was pushed successfully. false altrimenti. |
Lancia | |
---|---|
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 altrimenti. |
Lancia | |
---|---|
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 altrimenti. |
Lancia | |
---|---|
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 altrimenti. |
Lancia | |
---|---|
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 altrimenti. |
Lancia | |
---|---|
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. |
Lancia | |
---|---|
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.Lancia | |
---|---|
DeviceNotAvailableException |
rebootIntoFastbootd
public void rebootIntoFastbootd ()
Reboots the device into fastbootd mode.
Blocks until device is in fastbootd mode.
Lancia | |
---|---|
DeviceNotAvailableException |
rebootIntoRecovery
public void rebootIntoRecovery ()
Reboots the device into adb recovery mode.
Blocks until device enters recoveryLancia | |
---|---|
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
Lancia | |
---|---|
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 |
Lancia | |
---|---|
DeviceNotAvailableException |
rebootUntilOnline
public void rebootUntilOnline ()
An alternate to reboot()
that only blocks until device is online ie visible to adb.
Lancia | |
---|---|
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. |
Lancia | |
---|---|
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.
Lancia | |
---|---|
DeviceNotAvailableException |
recoverDevice
public boolean recoverDevice ()
Attempts to recover device communication.
ritorna | |
---|---|
boolean | True if recovery attempted and successful, returns False if recovery was skipped |
Lancia | |
---|---|
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.
Lancia | |
---|---|
DeviceNotAvailableException |
remountSystemWritable
public void remountSystemWritable ()
Make the system partition on the device writable. May reboot the device.
Lancia | |
---|---|
DeviceNotAvailableException |
remountVendorReadOnly
public void remountVendorReadOnly ()
Make the vendor partition on the device read-only. May reboot the device.
Lancia | |
---|---|
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. |
Lancia | |
---|---|
DeviceNotAvailableException |
removeOwners
public void removeOwners ()
Remove all existing device profile owners with the best effort.
Lancia | |
---|---|
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. |
Lancia | |
---|---|
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 |
Lancia | |
---|---|
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 |
ritorna | |
---|---|
boolean | true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded |
Lancia | |
---|---|
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 |
Lancia | |
---|---|
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 |
Lancia | |
---|---|
DeviceNotAvailableException |
setConfigurazione
public void setConfiguration (IConfiguration configuration)
Inietta la IConfiguration
in uso.
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 |
Lancia | |
---|---|
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 IDeviceParametri | |
---|---|
newDevice | IDevice : l' 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. |
Lancia | |
---|---|
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, etcParametri | |
---|---|
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 |
Lancia | |
---|---|
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 |
Lancia | |
---|---|
DeviceNotAvailableException |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Inserisce l'istanza ITestLogger
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. |
Lancia | |
---|---|
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. |
Lancia | |
---|---|
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. |
Lancia | |
---|---|
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. |
Lancia | |
---|---|
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. |
Lancia | |
---|---|
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 |
Lancia | |
---|---|
DeviceNotAvailableException |
switchToAdbUsb
public boolean switchToAdbUsb ()
Switch device to adb over usb mode.
ritorna | |
---|---|
boolean | true if switch was successful, false otherwise. |
Lancia | |
---|---|
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. Falso altrimenti. |
Lancia | |
---|---|
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. Falso altrimenti. |
Lancia | |
---|---|
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 altrimenti. |
Lancia | |
---|---|
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. |
Lancia | |
---|---|
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. |
Lancia | |
---|---|
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 callpostBootSetup()
. 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. |
Lancia | |
---|---|
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 |
Lancia | |
---|---|
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. |
Lancia | |
---|---|
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. |
Lancia | |
---|---|
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. |
Lancia | |
---|---|
DeviceNotAvailableException |
waitForDeviceBootloader
public void waitForDeviceBootloader ()
Blocks until device is visible via fastboot. Use default timeout.
Lancia | |
---|---|
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 altrimenti |
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 altrimenti |
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 altrimenti |
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. UsewaitForDeviceAvailable()
instead.Lancia | |
---|---|
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. UsewaitForDeviceAvailable()
instead.Parametri | |
---|---|
waitTime | long : the time in ms to wait |
Lancia | |
---|---|
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 . |
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. |
Lancia | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
ensureRuntimePermissionSupported
protected void ensureRuntimePermissionSupported ()
helper method to throw exception if runtime permission isn't supported
Lancia | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getApiLevelSafe
protected int getApiLevelSafe ()
ritorna | |
---|---|
int |
initializeConnection
protected void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
Parametri | |
---|---|
info | IBuildInfo |
attributes | MultiMap |
Lancia | |
---|---|
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 |
Lancia | |
---|---|
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.
Lancia | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
notifyRebootStarted
protected void notifyRebootStarted ()
Notifies all IDeviceActionReceiver
about reboot start event.
Lancia | |
---|---|
| 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 |
Lancia | |
---|---|
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.
Lancia | |
---|---|
| 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.
Lancia | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
pullFileInternal
protected boolean pullFileInternal (String remoteFilePath, File localFile)
Parametri | |
---|---|
remoteFilePath | String |
localFile | File |
ritorna | |
---|---|
boolean |
Lancia | |
---|---|
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. |
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2023-12-01 UTC.