Dispositivo nativo
public
class
NativeDevice
extends Object
implements
IConfigurationReceiver,
IManagedTestDevice,
ITestLoggerReceiver
java.lang.Object | |
🎞 | com.android.tradefed.device.NativeDevice |
Implementazione predefinita di ITestDevice
dispositivi Android non full stack.
Riepilogo
Classi nidificate | |
---|---|
class |
NativeDevice.AdbAction
Un |
class |
NativeDevice.AdbShellAction
|
class |
NativeDevice.RebootDeviceAction
|
Costanti | |
---|---|
int |
INVALID_USER_ID
Valore restituito per un 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 dei nuovi comandi |
Campi | |
---|---|
public
static
final
String |
DEBUGFS_PATH
|
protected
static
final
String |
SD_CARD
|
protected
static
final
String |
STORAGE_EMULATED
|
protected
TestDeviceOptions |
mOptions
|
protected
final
IDeviceStateMonitor |
mStateMonitor
|
Costruttori pubblici | |
---|---|
NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Crea un |
Metodi pubblici | |
---|---|
void
|
batchPrefetchStartupBuildProps()
Micro ottimizzazione (circa 400 millisecondi) mediante il precaricamento di tutti gli oggetti di cui abbiamo bisogno anziché chiamare "adb" getprop per ognuno. |
boolean
|
canSwitchToHeadlessSystemUser()
Indica se è consentito passare all'utente SYSTEM headless. |
boolean
|
checkApiLevelAgainstNextRelease(int strictMinLevel)
Controlla se una funzionalità è attualmente supportata o meno in un livello minimamente supportato. |
boolean
|
checkConnectivity()
Verifica la connettività di rete del dispositivo. |
boolean
|
clearErrorDialogs()
Prova a chiudere le eventuali finestre di dialogo di errore attualmente visualizzate nell'interfaccia utente del dispositivo. |
void
|
clearLastConnectedWifiNetwork()
Cancella l'ultima rete Wi-Fi connessa. |
void
|
clearLogcat()
Elimina tutti i dati logcat accumulati. |
boolean
|
connectToWifiNetwork(
Si connette a una rete Wi-Fi. |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk)
Si connette a una rete Wi-Fi. |
boolean
|
connectToWifiNetwork(
Si connette a una rete Wi-Fi network.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 pari a 0. |
int
|
createUserNoThrow(String name)
Crea un utente con un determinato nome e flag predefiniti pari a 0. |
void
|
deleteFile(String deviceFilePath, int userId)
Metodo di supporto per eliminare un file o una directory sul dispositivo. |
void
|
deleteFile(String deviceFilePath)
Metodo di supporto per eliminare un file o una directory sul dispositivo. |
void
|
deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Rimuove la registrazione di |
boolean
|
deviceSoftRestarted(ProcessInfo prevSystemServerProcess)
Metodo di supporto per verificare se il dispositivo è stato riavviato temporaneamente, confrontando l'attuale sistema_server con
system_server |
boolean
|
deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)
Metodo di supporto per verificare se il dispositivo è stato riavviato temporaneamente a partire dall'ora UTC dall'epoca
dispositivo e i relativi |
boolean
|
disableAdbRoot()
Disattiva adb root. |
void
|
disableKeyguard()
Tenta di disattivare il blocco della tastiera. |
boolean
|
disableNetworkMonitor()
Disattiva 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 il file esiste sul dispositivo. |
File
|
dumpHeap(String process, String devicePath)
Tenta di eseguire il dump dell'heap da system_server. |
boolean
|
enableAdbRoot()
Attiva root ADB. |
boolean
|
enableNetworkMonitor()
Abilita il monitoraggio della rete sul dispositivo. |
String
|
executeAdbCommand(long timeout, String... cmdArgs)
Metodo helper che esegue un comando adb come comando di sistema con un timeout specificato. |
String
|
executeAdbCommand(long timeout,
Metodo helper che esegue un comando adb come comando di sistema con un timeout specificato. |
String
|
executeAdbCommand(String... cmdArgs)
Metodo helper che esegue un comando adb come comando di sistema. |
CommandResult
|
executeFastbootCommand(String... cmdArgs)
Metodo helper che esegue un comando fastboot come comando di sistema con un timeout predefinito 2 minuti. |
CommandResult
|
executeFastbootCommand(long timeout, String... cmdArgs)
Metodo helper che esegue un comando fastboot come comando di sistema. |
CommandResult
|
executeLongFastbootCommand(String... cmdArgs)
Metodo helper che esegue un comando fastboot a lunga esecuzione come comando di sistema. |
CommandResult
|
executeLongFastbootCommand(
Metodo helper che esegue un comando fastboot a lunga esecuzione come comando di sistema con il sistema variabili di ambiente. |
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 in caso di errore. |
CommandResult
|
executeShellV2Command(String cmd)
Metodo helper che esegue un comando shell adb e restituisce i risultati come |
CommandResult
|
executeShellV2Command(String cmd, OutputStream pipeToOutput)
Metodo helper che esegue un comando della shell adb e restituisce i risultati come |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput)
Metodo helper 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 helper 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 attuale del dispositivo |
String
|
getAndroidId(int userId)
Trova e restituisci l'android-id associato a un userId, null se non trovato. |
|
getAndroidIds()
Crea una mappa degli ID Android trovati con ID utente corrispondenti. |
int
|
getApiLevel()
Ottieni il livello API del dispositivo. |
PackageInfo
|
getAppPackageInfo(String packageName)
Recupera informazioni su un pacchetto installato sul dispositivo. |
|
getAppPackageInfos()
Recupera informazioni sui pacchetti installati sul dispositivo. |
String
|
getBasebandVersion()
Metodo pratico per ottenere la versione in banda di base (radio) di questo dispositivo. |
Integer
|
getBattery()
Restituisce il livello della batteria corrente 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 helper raccoglie la mappa della cronologia di avvio con data e ora e motivo dell'avvio. |
|
getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)
Il metodo helper raccoglie la mappa della cronologia di avvio con il tempo e il motivo dell'avvio a partire dalla data tempo dall'epoca del dispositivo e l'unità di tempo specificata. |
String
|
getBootloaderVersion()
Metodo pratico per recuperare la versione bootloader del 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 potrebbero essere firmati con token di test (come in AOSP) o chiavi di rilascio (controllata da singoli produttori di dispositivi) |
DeviceDescriptor
|
getCachedDeviceDescriptor()
Restituisce un |
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
Restituisce un |
String[]
|
getChildren(String path)
Alternativa all'utilizzo di |
AbstractConnection
|
getConnection()
La connessione attuale associata al dispositivo. |
ContentProviderHandler
|
getContentProvider(int userId)
Restituisce |
DeviceFoldableState
|
getCurrentFoldableState()
Restituisce l'attuale stato pieghevole del dispositivo o nullo se si sono verificati alcuni problemi. |
int
|
getCurrentUser()
Restituisce l'ID dell'utente corrente in esecuzione. |
String
|
getDeviceClass()
Ottieni la classe del dispositivo. |
long
|
getDeviceDate()
Restituisce la data del dispositivo in millisecondi dall'epoca. |
DeviceDescriptor
|
getDeviceDescriptor()
Restituisci un |
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
Restituisci un |
TestDeviceState
|
getDeviceState()
Ottieni lo stato del dispositivo. |
long
|
getDeviceTimeOffset(Date date)
Assistente per rilevare la differenza di tempo tra il dispositivo e un determinato |
InputStreamSource
|
getEmulatorOutput()
recupera il flusso di stdout e stderr dell'emulatore |
Process
|
getEmulatorProcess()
Restituisce il valore |
final
File
|
getExecuteShellCommandLog()
Il log che contiene tutti i log di |
long
|
getExternalStoreFreeSpace()
Metodo di supporto per determinare la quantità di spazio libero sulla memoria esterna del dispositivo. |
String
|
getFastbootPath()
Restituisce il percorso del programma binario fastboot utilizzato. |
String
|
getFastbootProductType()
Metodo pratico per conoscere il tipo di prodotto di questo dispositivo quando è in modalità Fastboot. |
String
|
getFastbootProductVariant()
Metodo pratico per conoscere il tipo di prodotto di questo dispositivo quando è in modalità Fastboot. |
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 di versione del binario fastboot in uso. |
IFileEntry
|
getFileEntry(String path)
Recupera un riferimento a un file remoto sul dispositivo. |
IFileEntry
|
getFileEntry(FileListingService.FileEntry entry)
Supporto non ufficiale per ottenere un |
|
getFoldableStates()
Restituisce l'elenco di stati pieghevoli sul dispositivo. |
IDevice
|
getIDevice()
Restituisce un riferimento all'elemento ddmlib |
|
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()
Recupera l'indirizzo IP del dispositivo. |
KeyguardControllerState
|
getKeyguardState()
Restituisci un oggetto per ottenere lo stato attuale del blocco della tastiera o null se non supportato. |
long
|
getLastExpectedRebootTimeMillis()
Restituisce l'ultima volta in cui le API Tradefed hanno attivato un riavvio in millisecondi da EPOCH come
restituito da |
int
|
getLaunchApiLevel()
Ottieni il primo livello API 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()
Recupera il logcat attuale 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, nullo se la query dal dispositivo non riesce. |
Integer
|
getMainUserId()
Restituisce l'ID utente principale. |
|
getMainlineModuleInfo()
Recupera le informazioni sui moduli di linea principali installati sul dispositivo. |
int
|
getMaxNumberOfRunningUsersSupported()
Ottieni il numero massimo di utenti supportati in esecuzione contemporaneamente. |
int
|
getMaxNumberOfUsersSupported()
Ottieni il numero massimo di utenti supportati. |
Process
|
getMicrodroidProcess()
|
IDeviceStateMonitor
|
getMonitor()
Restituisci il |
String
|
getMountPoint(String mountName)
Restituisce un punto di montaggio. |
ITestDevice.MountPointInfo
|
getMountPointInfo(String mountpoint)
Restituisce un valore |
|
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 o null se si è verificato un problema. |
String
|
getProductType()
Metodo pratico per conoscere il tipo di prodotto di questo dispositivo. |
String
|
getProductVariant()
Metodo pratico per ottenere la variante di prodotto di questo dispositivo. |
String
|
getProperty(String name)
Recupera il valore della proprietà specificato dal dispositivo. |
ITestDevice.RecoveryMode
|
getRecoveryMode()
Recupera l'attuale modalità di ripristino utilizzata per il dispositivo. |
InputStreamSource
|
getScreenshot(String format)
Acquisisce uno screenshot dal dispositivo. |
InputStreamSource
|
getScreenshot(long displayId)
Recupera uno screenshot dall'ID display del dispositivo specificato. |
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Acquisisce uno screenshot dal dispositivo. |
InputStreamSource
|
getScreenshot()
Acquisisce uno screenshot dal dispositivo. |
String
|
getSerialNumber()
Metodo pratico per ottenere il numero di serie del dispositivo. |
String
|
getSetting(int userId, String namespace, String key)
Restituisce il valore dell'impostazione richiesta. |
String
|
getSetting(String namespace, String key)
Vedi |
String
|
getSimOperator()
Restituisci l'operatore della scheda SIM o null se non è disponibile o se il dispositivo non è disponibile. |
String
|
getSimState()
Restituisce lo stato della scheda SIM o null se non è disponibile o il dispositivo non è disponibile. |
|
getTombstones()
Recupera e restituisci l'elenco delle lapidi dai dispositivi. |
long
|
getTotalMemory()
Restituisce la dimensione totale della memoria fisica in byte o -1 in caso di errore interno |
String
|
getTrackingSerial()
Ai fini della gestione dei dispositivi, individua il numero di serie utilizzato per monitorare il dispositivo. |
|
getUninstallablePackageNames()
Recupera i nomi dei pacchetti dell'applicazione che possono essere disinstallati. |
boolean
|
getUseFastbootErase()
Scopri se utilizzare il formato fastboot reset o fastboot per cancellare una partizione sul dispositivo. |
int
|
getUserFlags(int userId)
Trova e restituisci i flag di un determinato utente. |
|
getUserInfos()
Recupera la mappa di useId per |
int
|
getUserSerialNumber(int userId)
Restituisce il numero di serie associato allo userId, se trovato, -10000 in tutti gli altri casi. |
IManagedTestDevice.DeviceEventResponse
|
handleAllocationEvent(DeviceEvent event)
Elabora l'elemento DeviceEvent specificato. Elaborare DeviceEvent, che può o meno trasferire questo dispositivo a una nuova allocazione stato. |
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 di un determinato utente. |
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Installa un pacchetto Android sul dispositivo di un determinato utente. |
void
|
invalidatePropertyCache()
|
boolean
|
isAdbRoot()
|
boolean
|
isAdbTcp()
|
boolean
|
isAppEnumerationSupported()
Controllare se la piattaforma sul dispositivo supporta l'enumerazione delle app |
boolean
|
isBypassLowTargetSdkBlockSupported()
Controlla se la piattaforma sul dispositivo supporta l'aggiramento del blocco SDK target basso sulle installazioni di app |
boolean
|
isDebugfsMounted()
Controlla se il debugfs è montato. |
boolean
|
isDeviceEncrypted()
Indica se il dispositivo è criptato. |
boolean
|
isDirectory(String path)
Restituisce True se il percorso sul dispositivo è una directory, false in caso contrario. |
boolean
|
isEnableAdbRoot()
|
boolean
|
isEncryptionSupported()
Indica se la crittografia è supportata sul dispositivo. |
boolean
|
isExecutable(String fullPath)
Restituisce True se il percorso del file sul dispositivo è un file eseguibile, false in caso contrario. |
boolean
|
isFastbootEnabled()
Restituire se fastboot è disponibile per il dispositivo. |
boolean
|
isHeadless()
Restituisce true se il dispositivo è headless (nessuno schermo), false negli altri casi. |
boolean
|
isHeadlessSystemUserMode()
Indica se il dispositivo utilizza la modalità utente di sistema headless. |
boolean
|
isMainUserPermanentAdmin()
Indica se l'utente principale è un amministratore permanente e non può essere eliminato o eseguito il downgrade a non amministratore. |
boolean
|
isMultiUserSupported()
Determina se la funzionalità multiutente è supportata. |
boolean
|
isPackageInstalled(String packageName, String userId)
Esegui una query sul dispositivo per trovare un dato nome pacchetto e un dato ID utente per verificare se al momento installato o meno per quell'utente. |
boolean
|
isPackageInstalled(String packageName)
Esegui una query sul dispositivo per trovare un determinato nome di pacchetto per verificare se il pacchetto è attualmente installato o meno. |
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)
Verificare se un determinato utente è in esecuzione. |
boolean
|
isUserSecondary(int userId)
Indica se l'utente specificato è un utente secondario in base ai flag. |
boolean
|
isUserVisible(int userId)
Controlla se l'utente specificato è visibile. |
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
Controlla se l'utente è visibile sul display specificato. |
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
Indica se il dispositivo consente agli utenti di essere avviati visibili in background in |
boolean
|
isVisibleBackgroundUsersSupported()
Indica se il dispositivo consente agli utenti di essere avviati visibili in background. |
boolean
|
isWifiEnabled()
Verifica che il Wi-Fi sia attivo. |
|
listDisplayIds()
Raccogli l'elenco degli ID dei display disponibili sul dispositivo segnalato da "dumpsys SurfaceFlinger". |
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Recupera l'elenco di display che possono essere utilizzati per |
|
listUsers()
Recupera l'elenco di utenti presenti sul dispositivo. |
boolean
|
logAnrs(ITestLogger logger)
Raccoglie e registra gli errori ANR dal dispositivo. |
boolean
|
logBugreport(String dataName, ITestLogger listener)
Metodo di supporto per inviare una segnalazione di bug e registrarla agli autori di segnalazioni. |
void
|
logOnDevice(String tag, Log.LogLevel level, String format, Object... args)
Registra un messaggio nel logcat del dispositivo. |
void
|
mountDebugfs()
Monta debugfs. |
void
|
nonBlockingReboot()
Emette un comando per riavviare il dispositivo e ritorna al completamento del comando e quando il dispositivo non è più visibile ad ADB. |
void
|
postAdbRootAction()
Esegui l'override se il dispositivo ha bisogno di determinate azioni dopo la root adb e prima del comando il dispositivo è di nuovo online. |
void
|
postAdbUnrootAction()
Esegui l'override se il dispositivo richiede l'esecuzione di determinate azioni dopo l'unroot dell'adb e prima il dispositivo è di nuovo online. |
void
|
postBootSetup()
Segui le istruzioni per configurare il dispositivo e testarlo dopo ogni avvio. |
void
|
postInvocationTearDown(Throwable exception)
Passaggi aggiuntivi per la pulizia specifica del dispositivo che verranno eseguiti dopo la chiamata al termine dell'operazione. |
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, int userId)
Esegui il pull ricorsivo dei contenuti della directory dal dispositivo. |
boolean
|
pullDir(String deviceFilePath, File localDir)
Esegui il pull ricorsivo dei contenuti 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 |
File
|
pullFile(String remoteFilePath)
Recupera un file dal dispositivo, lo archivia in un file |
boolean
|
pullFile(String remoteFilePath, File localFile, int userId)
Recupera un file dal dispositivo. |
String
|
pullFileContents(String remoteFilePath)
Recupera un file dal dispositivo e restituisce i contenuti. |
File
|
pullFileFromExternal(String remoteFilePath)
Un metodo pratico per recuperare un file dalla memoria esterna del dispositivo, archivialo in un
|
boolean
|
pushDir(File localFileDir, String deviceFilePath,
Esegui il push ricorsivo dei contenuti delle directory al dispositivo, escludendo alcune directory che sono filtrati. |
boolean
|
pushDir(File localFileDir, String deviceFilePath)
Esegui il push ricorsivo dei contenuti della directory sul dispositivo. |
boolean
|
pushDir(File localFileDir, String deviceFilePath, int userId)
Esegui il push ricorsivo dei contenuti della directory sul dispositivo. |
boolean
|
pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Variante di |
boolean
|
pushFile(File localFile, String remoteFilePath)
Esegui il push di un file sul dispositivo. |
boolean
|
pushFile(File localFile, String remoteFilePath, int userId)
Esegui il push di un file sul dispositivo. |
boolean
|
pushString(String contents, String remoteFilePath)
Esegui il push del file creato da una stringa al dispositivo |
void
|
reboot(String reason)
Riavvia il dispositivo in modalità ADB e l' |
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 (tieni presente che si tratta di una modalità speciale in fase di ripristino) Blocco fino all'attivazione della modalità sideload sul dispositivo |
void
|
rebootIntoSideload(boolean autoReboot)
Riavvia il dispositivo in modalità sideload adb (tieni presente che si tratta di una modalità speciale in fase di ripristino) Blocco fino all'attivazione della modalità sideload sul dispositivo |
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 recuperare la comunicazione del dispositivo. |
void
|
registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Registra un |
void
|
remountSystemReadOnly()
Imposta la partizione di sistema sul dispositivo come di sola lettura. |
void
|
remountSystemWritable()
Rendi scrivibile la partizione di sistema del dispositivo. |
void
|
remountVendorReadOnly()
Rendi la partizione del fornitore sul dispositivo di sola lettura. |
void
|
remountVendorWritable()
Rendi scrivibile la partizione del fornitore sul dispositivo. |
boolean
|
removeAdmin(String componentName, int userId)
Rimuovi l'amministratore del dispositivo specificato per l'utente e restituisci |
void
|
removeOwners()
Rimuovi tutti i proprietari di profili esistenti del dispositivo con il massimo impegno. |
boolean
|
removeUser(int userId)
Rimuovere un determinato utente dal dispositivo. |
void
|
resetContentProviderSetup()
Reimposta il flag per la configurazione del fornitore di contenuti per attivarlo di nuovo. |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Metodo pratico per eseguire |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner,
Esegue test di strumentazione e fornisce il recupero del dispositivo. |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
Uguale a |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Uguale a |
void
|
setConfiguration(IConfiguration configuration)
Inserisce |
final
void
|
setConnectionAvdInfo(GceAvdInfo avdInfo)
|
void
|
setDate(Date date)
Imposta la data sul dispositivo Nota: l'impostazione della data sul dispositivo richiede il 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 imposta |
void
|
setEmulatorProcess(Process p)
Consente di impostare |
void
|
setFastbootEnabled(boolean fastbootEnabled)
Imposta l'opzione fastboot per il dispositivo. |
void
|
setFastbootPath(String fastbootPath)
Imposta il percorso del programma binario fastboot da utilizzare. |
void
|
setIDevice(IDevice newDevice)
Aggiorna l'IDevice associato a questo ITestDevice. |
void
|
setLogStartDelay(int delay)
Imposta il tempo di attesa in ms 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 specificato per la proprietà sul dispositivo. |
void
|
setRecovery(IDeviceRecovery recovery)
Imposta il |
void
|
setRecoveryMode(ITestDevice.RecoveryMode mode)
Imposta l'attuale modalità di ripristino da usare per il dispositivo. |
void
|
setSetting(String namespace, String key, String value)
Vedi |
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
|
setTrackingSerial(String trackingSerial)
Ai fini della gestione dei dispositivi, traccia il numero di serie che utilizziamo per fare riferimento al dispositivo. |
void
|
setUseFastbootErase(boolean useFastbootErase)
Scegli se utilizzare il formato fastboot reset o fastboot per cancellare una partizione sul dispositivo. |
void
|
startLogcat()
Avvia l'acquisizione dell'output logcat dal dispositivo in background. |
boolean
|
startUser(int userId)
Avvia un determinato utente in background se al momento è arrestato. |
boolean
|
startUser(int userId, boolean waitFlag)
Avvia un determinato utente in background se al momento è arrestato. |
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Avvia un determinato utente in background, visibile sul display specificato (ad esempio, consentendo all'utente per avviare attività in quel display). |
void
|
stopEmulatorOutput()
Chiudi ed elimina l'output dell'emulatore. |
void
|
stopLogcat()
Interrompi l'acquisizione dell'output di logcat dal dispositivo ed elimina i dati di logcat attualmente salvati. |
boolean
|
stopUser(int userId)
Arresta un determinato utente. |
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Interrompere un determinato utente. |
String
|
switchToAdbTcp()
Passa alla modalità adb-over-tcp sul dispositivo. |
boolean
|
switchToAdbUsb()
Passa al dispositivo in modalità ADB su USB. |
boolean
|
switchUser(int userId)
Passa a un altro userId con un timeout predefinito. |
boolean
|
switchUser(int userId, long timeout)
Passa a un altro userId con il timeout fornito come scadenza. |
boolean
|
syncFiles(File localFileDir, String deviceFilePath)
Sincronizza in modo incrementale i contenuti di una directory di file locale con il dispositivo. |
Bugreport
|
takeBugreport()
Prendi una segnalazione di bug e restituila all'interno di un oggetto |
String
|
uninstallPackage(String packageName)
Disinstalla un pacchetto Android dal dispositivo. |
String
|
uninstallPackageForUser(String packageName, int userId)
Disinstalla un pacchetto Android dal dispositivo per un determinato utente. |
boolean
|
unlockDevice()
Sblocca il dispositivo se è in stato criptato. |
void
|
unmountDebugfs()
Smonta il debugfs. |
boolean
|
waitForBootComplete(long timeOut)
Si blocca finché non viene impostato il flag di completamento dell'avvio del dispositivo. |
boolean
|
waitForDeviceAvailable()
Attende che il dispositivo risponda e sia disponibile per i test. |
boolean
|
waitForDeviceAvailable(long waitTime)
Attende che il dispositivo risponda e sia disponibile per i test. |
boolean
|
waitForDeviceAvailableInRecoverPath(long waitTime)
Attende che il dispositivo risponda e sia disponibile senza considerare il percorso di ripristino. |
void
|
waitForDeviceBootloader()
Si blocca finché il dispositivo non è visibile tramite fastboot. |
boolean
|
waitForDeviceInRecovery(long waitTime)
Blocchi per far sì che il dispositivo si trovi in "recupero ADB" (tieni presente che questo è diverso
|
boolean
|
waitForDeviceInSideload(long waitTime)
Blocchi per far sì che il dispositivo si trovi in ''adb sideload'' stato |
boolean
|
waitForDeviceNotAvailable(long waitTime)
Blocchi per cui il dispositivo non è disponibile, cioè non è presente nell'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 shell adb di base. |
Metodi protetti | |
---|---|
void
|
addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)
|
String[]
|
buildAdbShellCommand(String command, boolean forceExitStatusDetection)
Crea il comando del sistema operativo per la sessione e gli argomenti del comando shell adb specificati |
void
|
checkApiLevelAgainst(String feature, int strictMinLevel)
|
NativeDevice.RebootDeviceAction
|
createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)
Crea un |
IRunUtil
|
createRunUtil()
|
void
|
doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)
Esegui un riavvio ADB. |
void
|
ensureRuntimePermissionSupported()
metodo helper 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 di ddmlib per impostazione predefinita e utilizza sia "adb" shell getprop" o "fastboot getvar" a seconda che il dispositivo sia in Fastboot o meno. |
boolean
|
isInRebootCallback()
Indica se i callback di riavvio sono attualmente in esecuzione o meno. |
boolean
|
isNewer(File localFile, IFileEntry entry)
Restituisci |
void
|
notifyRebootEnded()
Invia notifiche a |
void
|
notifyRebootStarted()
Invia notifiche a tutti i |
boolean
|
performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Esegue un'azione su questo dispositivo. |
void
|
postAdbReboot()
Eventuali azioni aggiuntive che è possibile eseguire dopo un riavvio. |
void
|
prePostBootSetup()
Consente a ogni tipo di dispositivo (Android NativeDevice, TestDevice) di eseguire l'override di questo metodo per una specifica configurazione post-avvio. |
boolean
|
pullFileInternal(String remoteFilePath, File localFile)
|
void
|
setClock(Clock clock)
Imposta l'istanza di orologio da utilizzare. |
void
|
setMicrodroidProcess(Process process)
Contrassegna il TestDevice come microdroide e imposta il relativo ID cliente. |
void
|
setTestDeviceOptions(
|
CommandResult
|
simpleFastbootCommand(long timeout,
Esegue un semplice comando fastboot con variabili di ambiente e segnala lo stato del . |
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_NON_VALIDO
public static final int INVALID_USER_ID
Valore restituito per un ID utente non valido/non trovato: UserHandle ha definito il valore -10000
Valore costante: -10.000 (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 dei nuovi comandi
Valore costante: 2 (0x00000002)
Campi
PERCORSO_DEBUGFS
public static final String DEBUGFS_PATH
SCHEDA_SD
protected static final String SD_CARD
SPAZIO DI ARCHIVIAZIONE_EMULATED
protected static final String STORAGE_EMULATED
Costruttori pubblici
Dispositivo nativo
public NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Crea un TestDevice
.
Parametri | |
---|---|
device |
IDevice : il valore IDevice associato |
stateMonitor |
IDeviceStateMonitor : il meccanismo IDeviceStateMonitor da utilizzare |
allocationMonitor |
IDeviceMonitor : il IDeviceMonitor per informare le modifiche dello stato di allocazione.
Può essere nullo |
Metodi pubblici
batchPrefetchStartupBuildProps
public void batchPrefetchStartupBuildProps ()
Micro ottimizzazione (circa 400 millisecondi) mediante il precaricamento di tutti gli oggetti di cui abbiamo bisogno anziché chiamare "adb" getprop per ognuno. Ad esempio, il recupero di tutte le proprietà è veloce quanto il recupero di una. Ad esempio, device.getApiLevel(), checkApiLevelAgainstNextRelease e getBuildAlias dietro le quinte, "adb getprop". Le recuperiamo con una sola chiamata e chiamiamo NativeDevice.setProperty. Anche se non lo facciamo, NativeDevice chiama direttamente setProperty e memorizza nella cache il risultato per chiamate future. Lo stiamo facendo un po' prima. Se il dispositivo è in fase di ripristino o si trova ci sono altri errori durante il recupero degli oggetti, li ignoriamo.
CANNOT TRANSLATE
public boolean canSwitchToHeadlessSystemUser ()
Indica se è consentito passare all'utente SYSTEM headless.
Ritorni | |
---|---|
boolean |
Lanci | |
---|---|
DeviceNotAvailableException |
checkApiLevelAgainstNextRelease
public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
Controlla se una funzionalità è attualmente supportata o meno in un livello minimamente supportato. Questo prende in considerazione ancora le funzionalità non ancora rilasciate, prima che venga innalzato il livello API.
Parametri | |
---|---|
strictMinLevel |
int : il livello minimo massimo possibile che supporta la funzionalità. |
Ritorni | |
---|---|
boolean |
True se il livello è supportato. Falso negli altri casi. |
Lanci | |
---|---|
DeviceNotAvailableException |
checkConnectivity
public boolean checkConnectivity ()
Verifica la connettività di rete del dispositivo.
Ritorni | |
---|---|
boolean |
true se il dispositivo ha una connessione di rete funzionante,
false in modo eccessivo. |
Lanci | |
---|---|
DeviceNotAvailableException |
Finestra di dialogo di errore
public boolean clearErrorDialogs ()
Prova a chiudere le eventuali finestre di dialogo di errore attualmente visualizzate nell'interfaccia utente del dispositivo.
Ritorni | |
---|---|
boolean |
true se non erano presenti finestre di dialogo o se sono state cancellate correttamente.
false in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
cancellaUltimaReteWifiConnessa
public void clearLastConnectedWifiNetwork ()
Cancella l'ultima rete Wi-Fi connessa. Questo deve essere chiamato quando viene avviata una nuova chiamata per evitare di connettersi alla rete Wi-Fi utilizzata nel test precedente dopo il riavvio del dispositivo.
CANCELLA
public void clearLogcat ()
Elimina tutti i dati logcat accumulati.
Questa opzione è utile nei casi in cui vuoi assicurarti che ITestDevice#getLogcat()
restituisca solo i resi
Registra dati generati dopo un determinato momento (ad esempio dopo il flashing della build di un nuovo dispositivo e così via).
connettitiaallareteWifi
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 con una rete Wi-Fi
reti specificate nella mappa wifiSsidToPsk. Dopo aver stabilito una connessione, l'istanza proverà a
Ripristina la connessione dopo ogni riavvio fino al giorno ITestDevice#disconnectFromWifi()
oppure
ITestDevice#clearLastConnectedWifiNetwork()
ha chiamato.
Parametri | |
---|---|
wifiSsidToPsk |
: una mappa degli SSID delle reti Wi-Fi alle password. |
scanSsid |
boolean : indica se cercare gli SSID nascosti per questa rete. |
Ritorni | |
---|---|
boolean |
true in caso di connessione alla rete Wi-Fi. false
altrimenti |
Lanci | |
---|---|
DeviceNotAvailableException |
connettitiaallareteWifi
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 alla rete Wi-Fi specificata.
Una volta stabilita una connessione, l'istanza proverà a ripristinare la connessione dopo ogni riavvio
fino al giorno ITestDevice#disconnectFromWifi()
o
ITestDevice#clearLastConnectedWifiNetwork()
ha chiamato.
Parametri | |
---|---|
wifiSsid |
String : l'SSD Wi-Fi a cui connetterti |
wifiPsk |
String : passphrase PSK o null se non criptata |
Ritorni | |
---|---|
boolean |
true in caso di connessione alla rete Wi-Fi. false
altrimenti |
Lanci | |
---|---|
DeviceNotAvailableException |
connettitiaallareteWifi
public boolean connectToWifiNetwork (wifiSsidToPsk)
Si connette a una rete Wi-Fi.
Attiva il Wi-Fi e si blocca finché non viene stabilita una connessione con una rete Wi-Fi
reti specificate nella mappa wifiSsidToPsk. Dopo aver stabilito una connessione, l'istanza proverà a
Ripristina la connessione dopo ogni riavvio fino al giorno ITestDevice#disconnectFromWifi()
oppure
ITestDevice#clearLastConnectedWifiNetwork()
viene chiamato.f
Parametri | |
---|---|
wifiSsidToPsk |
: una mappa degli SSID delle reti Wi-Fi alle password. |
Ritorni | |
---|---|
boolean |
true in caso di connessione alla rete Wi-Fi. false
altrimenti |
Lanci | |
---|---|
DeviceNotAvailableException |
connettitiaallareteWifi
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 alla rete Wi-Fi specificata.
Una volta stabilita una connessione, l'istanza proverà a ripristinare la connessione dopo ogni riavvio
fino al giorno ITestDevice#disconnectFromWifi()
o
ITestDevice#clearLastConnectedWifiNetwork()
ha chiamato.
Parametri | |
---|---|
wifiSsid |
String : l'SSD Wi-Fi a cui connetterti |
wifiPsk |
String : passphrase PSK o null se non criptata |
scanSsid |
boolean : indica se cercare l'SSID nascosto per questa rete. |
Ritorni | |
---|---|
boolean |
true in caso di connessione alla rete Wi-Fi. false
altrimenti |
Lanci | |
---|---|
DeviceNotAvailableException |
connettitiAllaWifiNetworkIfNeeded
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 cercare l'SSID nascosto per questa rete |
Ritorni | |
---|---|
boolean |
true in caso di connessione alla rete Wi-Fi. false
altrimenti |
Lanci | |
---|---|
DeviceNotAvailableException |
connettitiAllaWifiNetworkIfNeeded
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.
Ritorni | |
---|---|
boolean |
true in caso di connessione alla rete Wi-Fi. false
altrimenti |
Lanci | |
---|---|
DeviceNotAvailableException |
CreaUtente
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 : attiva il flag utente --guest durante la creazione |
ephemeral |
boolean : abilita il flag utente --temporaneo durante la creazione |
Ritorni | |
---|---|
int |
ID dell'utente creato |
Lanci | |
---|---|
DeviceNotAvailableException |
CreaUtente
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 : attiva il flag utente --guest durante la creazione |
ephemeral |
boolean : abilita il flag utente --temporaneo durante la creazione |
forTesting |
boolean : abilita il flag di test --for-testing durante la creazione |
Ritorni | |
---|---|
int |
ID dell'utente creato |
Lanci | |
---|---|
DeviceNotAvailableException |
CreaUtente
public int createUser (String name)
Crea un utente con un determinato nome e flag predefiniti pari a 0.
Parametri | |
---|---|
name |
String : dell'utente da creare sul dispositivo |
Ritorni | |
---|---|
int |
Il numero intero per l'ID utente creato |
Lanci | |
---|---|
DeviceNotAvailableException |
CreaUtenteNoThrow
public int createUserNoThrow (String name)
Crea un utente con un determinato nome e flag predefiniti pari a 0.
Parametri | |
---|---|
name |
String : dell'utente da creare sul dispositivo |
Ritorni | |
---|---|
int |
Il numero intero per l'ID utente creato o -1 per l'errore. |
Lanci | |
---|---|
DeviceNotAvailableException |
deleteFile
public void deleteFile (String deviceFilePath, int userId)
Metodo di supporto per eliminare un file o una directory sul dispositivo.
Parametri | |
---|---|
deviceFilePath |
String : il percorso assoluto del file sul dispositivo. |
userId |
int : l'ID utente da cui eliminare |
Lanci | |
---|---|
DeviceNotAvailableException |
deleteFile
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. |
Lanci | |
---|---|
DeviceNotAvailableException |
annullaregistrazioneDeviceActionReceiver
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Rimuove la registrazione di IDeviceActionReceiver
.
Parametri | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : un IDeviceActionReceiver che verrà rimosso. |
dispositivoRiavvio avviato
public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Metodo di supporto per verificare se il dispositivo è stato riavviato temporaneamente, confrontando l'attuale sistema_server con
system_server ProcessInfo
precedente. Usa getProcessByName(String)
per ricevere ProcessInfo
.
Parametri | |
---|---|
prevSystemServerProcess |
ProcessInfo : il precedente processo system_server ProcessInfo . |
Ritorni | |
---|---|
boolean |
true se il dispositivo è stato riavviato temporaneamente |
Lanci | |
---|---|
DeviceNotAvailableException |
dispositivoSoftRiavviatoDa
public boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
Metodo di supporto per verificare se il dispositivo è stato riavviato temporaneamente a partire dall'ora UTC dall'epoca
dispositivo e i relativi ERROR(/TimeUnit)
. Per riavvio software si intende system_server riavviato al di fuori di un
riavvio forzato del dispositivo (ad esempio, riavvio richiesto). L'attuale utcEpochTime del dispositivo in
Il milliseccond può essere ottenuto con il metodo getDeviceDate()
.
Parametri | |
---|---|
utcEpochTime |
long : tempo del dispositivo in secondi dall'epoca. |
timeUnit |
TimeUnit : l'unità di tempo TimeUnit per il valore utcEpochTime specificato. |
Ritorni | |
---|---|
boolean |
true se il dispositivo è stato riavviato temporaneamente |
Lanci | |
---|---|
DeviceNotAvailableException |
disattivareAdbRoot
public boolean disableAdbRoot ()
Disattiva adb root.
La disattivazione di adb root può causare la disconnessione del dispositivo da adb. Questo metodo bloccherà fino a è disponibile.
Ritorni | |
---|---|
boolean |
true in caso di esito positivo. |
Lanci | |
---|---|
DeviceNotAvailableException |
disattiva KeyGuard
public void disableKeyguard ()
Tenta di disattivare il blocco della tastiera.
Prima di tutto attendi che l'invio di input sia pronto, questo avviene più o meno nello stesso momento in cui dispositivo segnala BOOT_COMPLETE, apparentemente in modo asincrono, perché il framework attuale l'implementazione presenta race condizione occasionali. Viene quindi inviato un comando per ignorare il blocco tastiera (funziona solo su quelle non sicure)
Lanci | |
---|---|
DeviceNotAvailableException |
disattivareNetworkMonitor
public boolean disableNetworkMonitor ()
Disattiva il monitoraggio della rete sul dispositivo.
Ritorni | |
---|---|
boolean |
true se il monitoraggio è disabilitato correttamente. false
se l'operazione non riesce. |
Lanci | |
---|---|
DeviceNotAvailableException |
disconnetti daWifi
public boolean disconnectFromWifi ()
Si disconnette da una rete Wi-Fi.
Rimuove tutte le reti dall'elenco di reti note e disattiva il Wi-Fi.
Ritorni | |
---|---|
boolean |
true in caso di disconnessione dalla rete Wi-Fi. false
se la disconnessione non è riuscita. |
Lanci | |
---|---|
DeviceNotAvailableException |
fileExist
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 verificare |
userId |
int : l'ID utente in base al quale verificare l'esistenza del file |
Ritorni | |
---|---|
boolean |
true se il file esiste, false in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
fileExist
public boolean doesFileExist (String deviceFilePath)
Metodo di supporto per determinare se il file esiste sul dispositivo.
Parametri | |
---|---|
deviceFilePath |
String : il percorso assoluto del file sul dispositivo da verificare |
Ritorni | |
---|---|
boolean |
true se il file esiste, false in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
dumpHeap
public File dumpHeap (String process, String devicePath)
Tenta di eseguire il dump dell'heap da system_server. È responsabilità del chiamante ripulire del file di cui è stato eseguito il dump.
Parametri | |
---|---|
process |
String : il nome del processo del dispositivo su cui eseguire il dump dell'heap. |
devicePath |
String : il percorso sul dispositivo in cui posizionare il dump. Deve essere una posizione in cui
se le autorizzazioni lo consentono. |
Ritorni | |
---|---|
File |
ERROR(/File) contenente il report. Null se si è verificato un errore. |
Lanci | |
---|---|
DeviceNotAvailableException |
attivaAdbRoot
public boolean enableAdbRoot ()
Attiva root ADB. Se il comando "enable-root" è "false", registrerà un messaggio e senza abilitare root.
L'attivazione della directory principale ADB potrebbe causare la disconnessione del dispositivo da ADB. Questo metodo bloccherà fino a è disponibile.
Ritorni | |
---|---|
boolean |
true in caso di esito positivo. |
Lanci | |
---|---|
DeviceNotAvailableException |
abilitaNetworkMonitor
public boolean enableNetworkMonitor ()
Abilita il monitoraggio della rete sul dispositivo.
Ritorni | |
---|---|
boolean |
true se il monitoraggio è abilitato correttamente. false
se l'operazione non riesce. |
Lanci | |
---|---|
DeviceNotAvailableException |
eseguireAdbCommand
public String executeAdbCommand (long timeout, String... cmdArgs)
Metodo helper che esegue un comando adb come comando di sistema con un timeout specificato.
Se possibile, utilizza invece executeShellCommand(String)
, in quanto
migliora il rilevamento dei guasti e le prestazioni.
Parametri | |
---|---|
timeout |
long : il tempo in millisecondi prima che il dispositivo venga considerato come non risponde, 0 L per
nessun timeout |
cmdArgs |
String : il comando adb e gli argomenti da eseguire |
Ritorni | |
---|---|
String |
lo stdout dal comando. null se l'esecuzione del comando non è riuscita. |
Lanci | |
---|---|
DeviceNotAvailableException |
eseguireAdbCommand
public String executeAdbCommand (long timeout,envMap, String... cmdArgs)
Metodo helper che esegue un comando adb come comando di sistema con un timeout specificato.
Se possibile, utilizza invece executeShellCommand(String)
, in quanto
migliora il rilevamento dei guasti e le prestazioni.
Parametri | |
---|---|
timeout |
long : il tempo in millisecondi prima che il dispositivo venga considerato come non risponde, 0 L per
nessun timeout |
envMap |
: ambiente da impostare per il comando |
cmdArgs |
String : il comando adb e gli argomenti da eseguire |
Ritorni | |
---|---|
String |
lo stdout dal comando. null se l'esecuzione del comando non è riuscita. |
Lanci | |
---|---|
DeviceNotAvailableException |
eseguireAdbCommand
public String executeAdbCommand (String... cmdArgs)
Metodo helper che esegue un comando adb come comando di sistema.
Se possibile, utilizza invece executeShellCommand(String)
, in quanto
migliora il rilevamento dei guasti e le prestazioni.
Parametri | |
---|---|
cmdArgs |
String : il comando adb e gli argomenti da eseguire |
Ritorni | |
---|---|
String |
lo stdout dal comando. null se l'esecuzione del comando non è riuscita. |
Lanci | |
---|---|
DeviceNotAvailableException |
eseguireFastbootCommand
public CommandResult executeFastbootCommand (String... cmdArgs)
Metodo helper che esegue un comando fastboot come comando di sistema con un timeout predefinito 2 minuti.
È previsto l'utilizzo quando il dispositivo è già in modalità Fastboot.
Parametri | |
---|---|
cmdArgs |
String : il comando fastboot e gli argomenti da eseguire |
Ritorni | |
---|---|
CommandResult |
il CommandResult contenente l'output del comando |
Lanci | |
---|---|
DeviceNotAvailableException |
eseguireFastbootCommand
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
Metodo helper che esegue un comando fastboot come comando di sistema.
È previsto l'utilizzo quando il dispositivo è già in modalità Fastboot.
Parametri | |
---|---|
timeout |
long : tempo in millisecondi prima della scadenza del comando |
cmdArgs |
String : il comando fastboot e gli argomenti da eseguire |
Ritorni | |
---|---|
CommandResult |
il CommandResult contenente l'output del comando |
Lanci | |
---|---|
DeviceNotAvailableException |
eseguireLongFastbootCommand
public CommandResult executeLongFastbootCommand (String... cmdArgs)
Metodo helper che esegue un comando fastboot a lunga esecuzione come comando di sistema.
Identico a executeFastbootCommand(String)
, ma utilizza un timeout più lungo.
Parametri | |
---|---|
cmdArgs |
String : il comando fastboot e gli argomenti da eseguire |
Ritorni | |
---|---|
CommandResult |
il CommandResult contenente l'output del comando |
Lanci | |
---|---|
DeviceNotAvailableException |
eseguireLongFastbootCommand
public CommandResult executeLongFastbootCommand (envVarMap, String... cmdArgs)
Metodo helper che esegue un comando fastboot a lunga esecuzione come comando di sistema con il sistema variabili di ambiente.
Identico a executeFastbootCommand(String)
, ma utilizza un timeout più lungo.
Parametri | |
---|---|
envVarMap |
: le variabili di ambiente di sistema con cui viene eseguito il comando fastboot |
cmdArgs |
String : il comando fastboot e gli argomenti da eseguire |
Ritorni | |
---|---|
CommandResult |
il CommandResult contenente l'output del comando |
Lanci | |
---|---|
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 shell adb da eseguire |
Ritorni | |
---|---|
String |
l'output della shell |
Lanci | |
---|---|
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 shell adb da eseguire |
receiver |
IShellOutputReceiver : il valore IShellOutputReceiver a cui indirizzare l'output della shell. |
maxTimeToOutputShellResponse |
long : il periodo di tempo massimo durante il quale viene eseguito il comando
autorizzati a non restituire alcuna risposta; unità come specificato in timeUnit |
timeUnit |
TimeUnit : unità per maxTimeToOutputShellResponse |
retryAttempts |
int : il numero massimo di volte in cui è possibile riprovare un comando se questo non riesce a causa di un
. L'eccezione DeviceNot responsiveException verrà generata se retryAttempts
vengono eseguite senza successo. |
Lanci | |
---|---|
DeviceNotAvailableException |
eseguireShellCommand
public 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.
Parametri | |
---|---|
command |
String : il comando shell adb da eseguire |
receiver |
IShellOutputReceiver : il valore IShellOutputReceiver a cui indirizzare l'output della shell. |
maxTimeoutForCommand |
long : il timeout massimo per il completamento del comando; unità come
specificato in timeUnit |
maxTimeToOutputShellResponse |
long : il periodo di tempo massimo durante il quale viene eseguito il comando
autorizzati a non restituire alcuna risposta; unità come specificato in timeUnit |
timeUnit |
TimeUnit : unità per maxTimeToOutputShellResponse |
retryAttempts |
int : il numero massimo di volte in cui è possibile riprovare un comando se questo non riesce a causa di un
. L'eccezione DeviceNotDisabledException verrà generata se retryAttempts sono
senza successo. |
Lanci | |
---|---|
DeviceNotAvailableException |
eseguireShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver)
Esegue il comando della shell adb specificato, riprovando più volte in caso di errore.
Una forma più semplice
executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
con
i valori predefiniti.
Parametri | |
---|---|
command |
String : il comando shell adb da eseguire |
receiver |
IShellOutputReceiver : il valore IShellOutputReceiver a cui indirizzare l'output della shell. |
Lanci | |
---|---|
DeviceNotAvailableException |
eseguireShellV2Command
public CommandResult executeShellV2Command (String cmd)
Metodo helper che esegue un comando shell adb e restituisce i risultati come CommandResult
correttamente compilato con l'output dello stato del comando, stdout e stderr.
Parametri | |
---|---|
cmd |
String : il comando da eseguire. |
Ritorni | |
---|---|
CommandResult |
Il risultato in CommandResult . |
Lanci | |
---|---|
DeviceNotAvailableException |
eseguireShellV2Command
public CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)
Metodo helper che esegue un comando della shell adb e restituisce i risultati come CommandResult
correttamente compilato con l'output dello stato del comando e il comando stderr. stdout è
vengono indirizzati allo stream specificato.
Parametri | |
---|---|
cmd |
String : il comando da eseguire. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) in cui verrà reindirizzato l'output standard oppure nullo. |
Ritorni | |
---|---|
CommandResult |
Il risultato in CommandResult . |
Lanci | |
---|---|
DeviceNotAvailableException |
eseguireShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput)
Metodo helper che esegue un comando della shell adb e restituisce i risultati come CommandResult
correttamente compilato con l'output dello stato del comando, stdout e stderr.
Parametri | |
---|---|
cmd |
String : il comando da eseguire. |
pipeAsInput |
File : un ERROR(/File) che verrà inviato come input al comando oppure null. |
Ritorni | |
---|---|
CommandResult |
Il risultato in CommandResult . |
Lanci | |
---|---|
DeviceNotAvailableException |
eseguireShellV2Command
public 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.
Parametri | |
---|---|
cmd |
String : il comando shell adb 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 in cui è possibile riprovare un comando se questo non riesce a causa di un
. L'eccezione DeviceNotDisabledException verrà generata se retryAttempts sono
senza successo. |
Ritorni | |
---|---|
CommandResult |
Lanci | |
---|---|
DeviceNotAvailableException |
eseguireShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Esegue un comando della shell adb, con più parametri per controllare il comportamento del comando.
Parametri | |
---|---|
cmd |
String : il comando shell adb da eseguire |
maxTimeoutForCommand |
long : il timeout massimo per il completamento del comando; unità come
specificato in timeUnit |
timeUnit |
TimeUnit : unità per maxTimeToOutputShellResponse |
Ritorni | |
---|---|
CommandResult |
Lanci | |
---|---|
DeviceNotAvailableException |
eseguireShellV2Command
public 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.
Parametri | |
---|---|
cmd |
String : il comando shell adb da eseguire |
pipeAsInput |
File : un ERROR(/File) che verrà inviato come input al comando oppure null. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) in cui verrà reindirizzato l'output standard oppure nullo. |
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 in cui è possibile riprovare un comando se questo non riesce a causa di un
. L'eccezione DeviceNotDisabledException verrà generata se retryAttempts sono
senza successo. |
Ritorni | |
---|---|
CommandResult |
Lanci | |
---|---|
DeviceNotAvailableException |
eseguireShellV2Command
public 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.
Parametri | |
---|---|
cmd |
String : il comando shell adb da eseguire |
pipeAsInput |
File : un ERROR(/File) che verrà inviato come input al comando oppure null. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) in cui verrà reindirizzato l'output standard oppure nullo. |
pipeToError |
OutputStream : ERROR(/OutputStream) dove verrà reindirizzato l'errore standard oppure nullo. |
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 in cui è possibile riprovare un comando se questo non riesce a causa di un
. L'eccezione DeviceNotDisabledException verrà generata se retryAttempts sono
senza successo. |
Ritorni | |
---|---|
CommandResult |
Lanci | |
---|---|
DeviceNotAvailableException |
fastbootWipePartition
public CommandResult fastbootWipePartition (String partition)
Metodo helper che cancella una partizione per il dispositivo.
Se getUseFastbootErase()
è true
, la cancellazione rapida dei dati verrà usata
la partizione. Il dispositivo deve quindi creare un file system al successivo avvio del dispositivo.
In caso contrario, viene utilizzato il formato fastboot, che crea un nuovo file system sul dispositivo.
È previsto l'utilizzo quando il dispositivo è già in modalità Fastboot.
Parametri | |
---|---|
partition |
String : la partizione da cancellare |
Ritorni | |
---|---|
CommandResult |
il CommandResult contenente l'output del comando |
Lanci | |
---|---|
DeviceNotAvailableException |
getActiveApexes
publicgetActiveApexes ()
Recupera le informazioni sugli APEX attivati sul dispositivo.
Ritorni | |
---|---|
|
Attualmente attivi sul dispositivo: ERROR(/Set) di ApexInfo |
Lanci | |
---|---|
DeviceNotAvailableException |
getAllSettings
publicgetAllSettings (String namespace)
Restituisce coppie chiave-valore dello spazio dei nomi richiesto.
Parametri | |
---|---|
namespace |
String : deve essere uno di {"system", "secure", "global"} |
Ritorni | |
---|---|
|
la mappa delle coppie chiave-valore. Null se lo spazio dei nomi non è supportato. |
Lanci | |
---|---|
DeviceNotAvailableException |
getAllocationState
public DeviceAllocationState getAllocationState ()
Restituisce lo stato di allocazione attuale del dispositivo
Ritorni | |
---|---|
DeviceAllocationState |
getAndroidId
public String getAndroidId (int userId)
Trova e restituisci l'android-id associato a un userId, null se non trovato.
Parametri | |
---|---|
userId |
int |
Ritorni | |
---|---|
String |
Lanci | |
---|---|
DeviceNotAvailableException |
getAndroidId
publicgetAndroidIds ()
Crea una mappa degli ID Android trovati con ID utente corrispondenti. Non esiste alcuna assicurazione che ogni utente id troverà un ID Android associato in questa funzione, pertanto alcuni ID utente potrebbero corrispondere a un valore nullo.
Ritorni | |
---|---|
|
Mappa di ID Android corrispondenti a ID utente. |
Lanci | |
---|---|
DeviceNotAvailableException |
getApiLevel
public int getApiLevel ()
Ottieni il livello API del dispositivo. Il valore predefinito è UNKNOWN_API_LEVEL
.
Ritorni | |
---|---|
int |
un numero intero che indica il livello API del dispositivo |
Lanci | |
---|---|
DeviceNotAvailableException |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Recupera informazioni su un pacchetto installato sul dispositivo.
Parametri | |
---|---|
packageName |
String |
Ritorni | |
---|---|
PackageInfo |
PackageInfo o null se non è stato possibile recuperare le informazioni |
Lanci | |
---|---|
DeviceNotAvailableException |
getAppPackageInfos
publicgetAppPackageInfos ()
Recupera informazioni sui pacchetti installati sul dispositivo.
Ritorni | |
---|---|
|
ERROR(/List) di PackageInfo installati sul dispositivo. |
Lanci | |
---|---|
DeviceNotAvailableException |
getBasebandVersion
public String getBasebandVersion ()
Metodo pratico per ottenere la versione in banda di base (radio) di questo dispositivo. Scaricare la versione radio
è specifico del dispositivo, quindi potrebbe non restituire le informazioni corrette per tutti i dispositivi. Questo
fa affidamento sulla proprietà gsm.version.baseband per restituire le informazioni corrette sulla versione.
Questo dato non è preciso per alcuni dispositivi CDMA e la versione qui restituita potrebbe non corrispondere
la versione segnalata da fastboot e potrebbe non restituire la versione per la radio CDMA.
TL;DR questo metodo segnala la versione accurata solo se la proprietà gsm.version.baseband è
uguale alla versione restituita da fastboot getvar version-baseband
.
Ritorni | |
---|---|
String |
la versione della banda di base String o null se non può essere determinata
(il dispositivo non ha un segnale radio o la stringa di versione non può essere letta) |
Lanci | |
---|---|
DeviceNotAvailableException |
getBatteria
public Integer getBattery ()
Restituisce il livello della batteria corrente di un dispositivo o Null se il livello della batteria non è disponibile.
Ritorni | |
---|---|
Integer |
getBooleanProperty
public boolean getBooleanProperty (String name, boolean defaultValue)
Restituisce il valore booleano della proprietà specificata.
Parametri | |
---|---|
name |
String : il nome della proprietà |
defaultValue |
boolean : valore predefinito da restituire se la proprietà è vuota o non esiste. |
Ritorni | |
---|---|
boolean |
true se la proprietà ha un valore "1" , "y" , "yes" ,
"on" o "true" , false se la proprietà ha il valore "0" ,
"n" , "no" , "off" , "false" o defaultValue
negli altri casi. |
Lanci | |
---|---|
DeviceNotAvailableException |
getBootHistory
publicgetBootHistory ()
Il metodo helper raccoglie la mappa della cronologia di avvio con data e ora e motivo dell'avvio.
Ritorni | |
---|---|
|
Mappa dell'ora di avvio (ora UTC in secondi dall'epoca) e del motivo dell'avvio |
Lanci | |
---|---|
DeviceNotAvailableException |
getBootHistoryDa
publicgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
Il metodo helper raccoglie la mappa della cronologia di avvio con il tempo e il motivo dell'avvio a partire dalla data
tempo dall'epoca del dispositivo e l'unità di tempo specificata. L'attuale utcEpochTime del dispositivo in
Il millisecondo può essere ottenuto con il metodo getDeviceDate()
.
Parametri | |
---|---|
utcEpochTime |
long : data e ora del dispositivo dall'epoca. |
timeUnit |
TimeUnit : l'unità di tempo TimeUnit . |
Ritorni | |
---|---|
|
Mappa dell'ora di avvio (ora UTC in secondi dall'epoca) e del motivo dell'avvio |
Lanci | |
---|---|
DeviceNotAvailableException |
getBootloaderVersion
public String getBootloaderVersion ()
Metodo pratico per recuperare la versione bootloader del dispositivo.
Si tenterà di recuperare la versione del bootloader dallo stato attuale del dispositivo. (ad es. se il dispositivo è in modalità fastboot, proverà a recuperare la versione da fastboot)
Ritorni | |
---|---|
String |
la versione del bootloader String o null se non è possibile trovarla |
Lanci | |
---|---|
DeviceNotAvailableException |
getBugreport
public InputStreamSource getBugreport ()
Recupera una segnalazione di bug dal dispositivo.
L'implementazione di questa funzionalità garantisce che il dispositivo continui a funzionare su un dispositivo privo di scheda SD (o nel punto in cui la scheda SD non è ancora montata).
Ritorni | |
---|---|
InputStreamSource |
Un InputStreamSource che produrrà i contenuti della segnalazione di bug on demand. Nella
in caso di errore, InputStreamSource produrrà un ERROR(/InputStream) vuoto. |
getBugreportz
public InputStreamSource getBugreportz ()
Recupera una segnalazione di bug dal dispositivo. La segnalazione di bug in formato ZIP contiene la segnalazione di bug principale e altri file di log utili per il debug.
Supportata solo per la "versione adb" > 1,0.36
Ritorni | |
---|---|
InputStreamSource |
a InputStreamSource del file ZIP contenente il bugreportz, restituisci null in
in caso di errore. |
getBuildAlias
public String getBuildAlias ()
Recupera l'alias della build attualmente in esecuzione sul dispositivo.
L'alias build è in genere una stringa più leggibile rispetto all'ID build (di solito un numero per build Nexus). Ad esempio, la release finale di Android 4.2 ha l'alias di build JDQ39 e l'ID build 573038
Ritorni | |
---|---|
String |
l'alias build o ricorrere all'ID build se non è stato possibile recuperarlo |
Lanci | |
---|---|
DeviceNotAvailableException |
getBuildFlavor
public String getBuildFlavor ()
Recupera la versione di build per il dispositivo.
Ritorni | |
---|---|
String |
versione build o nullo se non è stato possibile recuperarla |
Lanci | |
---|---|
DeviceNotAvailableException |
getBuildId
public String getBuildId ()
Recupera la build attualmente in esecuzione sul dispositivo.
Ritorni | |
---|---|
String |
l'ID build o IBuildInfo#UNKNOWN_BUILD_ID se non è stato possibile recuperarlo |
Lanci | |
---|---|
DeviceNotAvailableException |
getBuildSigningKey
public String getBuildSigningKeys ()
Restituisce il tipo di chiave utilizzato per firmare l'immagine del dispositivo
In genere i dispositivi Android potrebbero essere firmati con token di test (come in AOSP) o chiavi di rilascio (controllata da singoli produttori di dispositivi)
Ritorni | |
---|---|
String |
La chiave di firma, se trovata, nulla, in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor ()
Restituisce un DeviceDescriptor
memorizzato nella cache se il dispositivo è allocato, altrimenti restituisce il valore
DeviceDescriptor
corrente.
Ritorni | |
---|---|
DeviceDescriptor |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
Restituisce un DeviceDescriptor
memorizzato nella cache se il dispositivo è allocato, altrimenti restituisce il valore
DeviceDescriptor
corrente.
Parametri | |
---|---|
shortDescriptor |
boolean : indica se limitare o meno il descrittore al minimo indispensabile di informazioni. |
Ritorni | |
---|---|
DeviceDescriptor |
getChildren
public String[] getChildren (String path)
Alternativa all'utilizzo di IFileEntry
che a volte non funziona a causa delle autorizzazioni.
Parametri | |
---|---|
path |
String : è il percorso sul dispositivo in cui eseguire la ricerca |
Ritorni | |
---|---|
String[] |
Array di stringa contenente l'intero file in un percorso sul dispositivo. |
Lanci | |
---|---|
DeviceNotAvailableException |
getConnection
public AbstractConnection getConnection ()
La connessione attuale associata al dispositivo.
Ritorni | |
---|---|
AbstractConnection |
getContentProvider
public ContentProviderHandler getContentProvider (int userId)
Restituisce ContentProviderHandler
o null se non disponibile.
Il fornitore di contenuti può essere riutilizzato se è stato creato in precedenza con lo stesso userId
.
Parametri | |
---|---|
userId |
int : l'ID utente con cui inizializzare il fornitore di contenuti. |
Ritorni | |
---|---|
ContentProviderHandler |
Lanci | |
---|---|
DeviceNotAvailableException |
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Restituisce l'attuale stato pieghevole del dispositivo o nullo se si sono verificati alcuni problemi.
Ritorni | |
---|---|
DeviceFoldableState |
Lanci | |
---|---|
DeviceNotAvailableException |
getCurrentUser
public int getCurrentUser ()
Restituisce l'ID dell'utente corrente in esecuzione. In caso di errore, restituisci -10000.
Ritorni | |
---|---|
int |
Lanci | |
---|---|
DeviceNotAvailableException |
getDeviceClass
public String getDeviceClass ()
Ottieni la classe del dispositivo.
Ritorni | |
---|---|
String |
la classe del dispositivo String . |
getDeviceDate
public long getDeviceDate ()
Restituisce la data del dispositivo in millisecondi dall'epoca.
Ritorni | |
---|---|
long |
la data del dispositivo nel formato dell'epoca. |
Lanci | |
---|---|
DeviceNotAvailableException |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor ()
Restituisci un DeviceDescriptor
dalle informazioni del dispositivo per avere informazioni senza
per passare l'oggetto
effettivo del dispositivo.
Ritorni | |
---|---|
DeviceDescriptor |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
Restituisci un DeviceDescriptor
dalle informazioni del dispositivo per avere informazioni senza
per passare l'oggetto
effettivo del dispositivo.
Parametri | |
---|---|
shortDescriptor |
boolean : indica se limitare o meno il descrittore al minimo indispensabile di informazioni. |
Ritorni | |
---|---|
DeviceDescriptor |
getDeviceState
public TestDeviceState getDeviceState ()
Ottieni lo stato del dispositivo.
Ritorni | |
---|---|
TestDeviceState |
getDeviceTimeOffset
public long getDeviceTimeOffset (Date date)
Assistente per rilevare la differenza di tempo tra il dispositivo e un determinato ERROR(/Date)
. Utilizza il tempo dell'epoca
internamente.
Parametri | |
---|---|
date |
Date |
Ritorni | |
---|---|
long |
la differenza in millisecondi |
Lanci | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public InputStreamSource getEmulatorOutput ()
recupera il flusso di stdout e stderr dell'emulatore
Ritorni | |
---|---|
InputStreamSource |
output dell'emulatore |
getEmulatorProcess
public Process getEmulatorProcess ()
Restituisce il valore Process
corrispondente a questo emulatore.
Ritorni | |
---|---|
Process |
Process o null |
getEseguiShellCommandLog
public final File getExecuteShellCommandLog ()
Il log che contiene tutti i log di executeShellCommand(String)
.
Ritorni | |
---|---|
File |
getExternalStoreFreeSpace
public long getExternalStoreFreeSpace ()
Metodo di supporto per determinare la quantità di spazio libero sulla memoria esterna del dispositivo.
Ritorni | |
---|---|
long |
la quantità di spazio libero in kB |
Lanci | |
---|---|
DeviceNotAvailableException |
getFastbootPath
public String getFastbootPath ()
Restituisce il percorso del programma binario fastboot utilizzato.
È comunque necessario che isFastbootEnabled()
sia true e le funzioni fastboot siano abilitate.
Ritorni | |
---|---|
String |
getFastbootProductType
public String getFastbootProductType ()
Metodo pratico per conoscere il tipo di prodotto di questo dispositivo quando è in modalità Fastboot.
Questo metodo deve essere utilizzato solo se il dispositivo deve essere in fastboot. È una variante un po' più sicura
rispetto al metodo getProductType()
generico in questo caso, perché ITestDevice
potrà ripristinare il dispositivo in fastboot se si trova in stato non corretto o
non risponde.
Ritorni | |
---|---|
String |
il nome del tipo di prodotto String o null se non può essere determinato |
Lanci | |
---|---|
DeviceNotAvailableException |
getFastbootProductVariant
public String getFastbootProductVariant ()
Metodo pratico per conoscere il tipo di prodotto di questo dispositivo quando è in modalità Fastboot.
Questo metodo deve essere utilizzato solo se il dispositivo deve essere in fastboot. È una variante un po' più sicura
rispetto al metodo getProductType()
generico in questo caso, perché ITestDevice
potrà ripristinare il dispositivo in fastboot se si trova in stato non corretto o
non risponde.
Ritorni | |
---|---|
String |
il nome del tipo di prodotto String o null se non può essere determinato |
Lanci | |
---|---|
DeviceNotAvailableException |
getFastbootSerialNumber
public String getFastbootSerialNumber ()
Restituisce il numero di serie della modalità fastboot.
Ritorni | |
---|---|
String |
getFastbootVariabile
public String getFastbootVariable (String variableName)
Recupera il valore della variabile fastboot specificato dal dispositivo.
Parametri | |
---|---|
variableName |
String : il nome della variabile |
Ritorni | |
---|---|
String |
il valore della proprietà o null se non esiste |
Lanci | |
---|---|
DeviceNotAvailableException |
getFastbootVersion
public String getFastbootVersion ()
Restituisce la stringa di versione del binario fastboot in uso. O nullo se qualcosa va sbagliato.
Ritorni | |
---|---|
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 relativo a "/". (ad es.
entrambi "/system" e "system" è supportata) |
Ritorni | |
---|---|
IFileEntry |
IFileEntry o null se il file al path specificato non può
essere trovato |
Lanci | |
---|---|
DeviceNotAvailableException |
getFileEntry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
Supporto non ufficiale per ottenere un FileEntry
da un percorso non principale. CORREZIONE: esegui il refactoring del
FileEntry System per renderlo disponibile da qualsiasi percorso. (anche non root).
Parametri | |
---|---|
entry |
FileListingService.FileEntry : un valore FileEntry non necessariamente root come richiesto da Ddmlib. |
Ritorni | |
---|---|
IFileEntry |
un FileEntryWrapper che rappresenta la voce FileEntry. |
Lanci | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableEccezione |
DeviceNotAvailableException |
getFoldableStates
publicgetFoldableStates ()
Restituisce l'elenco di stati pieghevoli sul dispositivo. Può essere ottenuto con "cmd device_state" stati di stampa".
Ritorni | |
---|---|
|
Lanci | |
---|---|
DeviceNotAvailableException |
getIDevice
public IDevice getIDevice ()
Restituisce un riferimento all'elemento ddmlib IDevice
associato.
Un nuovo IDevice
può essere assegnato da DCM ogni volta che il dispositivo si disconnette e
si riconnette dall'ADB. Di conseguenza, i chiamanti non devono tenere un riferimento a IDevice
,
perché il riferimento potrebbe diventare inattivo.
Ritorni | |
---|---|
IDevice |
IDevice |
getInstallaPackageNames
publicgetInstalledPackageNames ()
Recupera i nomi dei pacchetti dell'applicazione presenti sul dispositivo.
Ritorni | |
---|---|
|
ERROR(/Set) nomi di pacchetti su String attualmente installati sul dispositivo. |
Lanci | |
---|---|
DeviceNotAvailableException |
getIntProperty
public long getIntProperty (String name, long defaultValue)
Restituisce il valore intero della proprietà specificata dal dispositivo.
Parametri | |
---|---|
name |
String : il nome della proprietà |
defaultValue |
long : valore predefinito da restituire se la proprietà è vuota o non esiste. |
Ritorni | |
---|---|
long |
il valore della proprietà o defaultValue se la proprietà è vuota, non esiste,
o non ha un valore intero. |
Lanci | |
---|---|
DeviceNotAvailableException |
getIpAddress
public String getIpAddress ()
Recupera l'indirizzo IP del dispositivo.
Ritorni | |
---|---|
String |
l'indirizzo IP del dispositivo o null se il dispositivo non ha un indirizzo IP |
Lanci | |
---|---|
DeviceNotAvailableException |
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Restituisci un oggetto per ottenere lo stato attuale del blocco della tastiera o null se non supportato.
Ritorni | |
---|---|
KeyguardControllerState |
un elemento KeyguardControllerState contenente uno snapshot dello stato del blocco tastiera
e restituisce Null se la query Keyguard non è supportata. |
Lanci | |
---|---|
DeviceNotAvailableException |
getLastAspettaRiavvioMillis
public long getLastExpectedRebootTimeMillis ()
Restituisce l'ultima volta in cui le API Tradefed hanno attivato un riavvio in millisecondi da EPOCH come
restituito da System.currentTimeMillis()
.
Ritorni | |
---|---|
long |
getLaunchApiLevel
public int getLaunchApiLevel ()
Ottieni il primo livello API del dispositivo. Il valore predefinito è UNKNOWN_API_LEVEL
.
Ritorni | |
---|---|
int |
un numero intero che indica il primo livello API del dispositivo avviato |
Lanci | |
---|---|
DeviceNotAvailableException |
getLogcat
public InputStreamSource getLogcat ()
Acquisisce un flusso di snapshot dei dati logcat.
Funziona in due modalità:
TestDeviceOptions.getMaxLogcatDataSize()
byte dei contenuti attuali in background
acquisizione logcat
Ritorni | |
---|---|
InputStreamSource |
getLogcat
public InputStreamSource getLogcat (int maxBytes)
Acquisisce un flusso di snapshot degli ultimi maxBytes
di dati logcat acquisiti.
Utile nei casi in cui vuoi acquisire istantanee frequenti dei dati logcat acquisiti
senza incorrere in una penalità di spazio su disco potenzialmente elevata per ottenere l'intero snapshot getLogcat()
.
Parametri | |
---|---|
maxBytes |
int : la quantità massima di dati da restituire. Deve essere un importo che può
si adattano perfettamente alla memoria |
Ritorni | |
---|---|
InputStreamSource |
getLogcatDump
public InputStreamSource getLogcatDump ()
Recupera il logcat attuale per il dispositivo. A differenza di getLogcat()
, questo metodo
restituiscono sempre un dump statico del logcat.
Ha lo svantaggio che non verrà restituito nulla se il dispositivo non è raggiungibile.
Ritorni | |
---|---|
InputStreamSource |
un InputStreamSource dei dati logcat. In caso di errore viene restituito un flusso vuoto
per acquisire i dati logcat. |
getLogcatDal
public InputStreamSource getLogcatSince (long date)
Acquisisce un flusso di snapshot dei dati logcat acquisiti a partire dalla data fornita. L'ora
dovrebbe essere usato getDeviceDate()
.
Parametri | |
---|---|
date |
long : in millisecondi dal formato dell'epoca in cui iniziare lo snapshot fino a oggi.
(può essere ottenuto utilizzando "data +%s") |
Ritorni | |
---|---|
InputStreamSource |
getMacAddress
public String getMacAddress ()
Restituisce l'indirizzo MAC del dispositivo, nullo se la query dal dispositivo non riesce.
Ritorni | |
---|---|
String |
getMainUserId
public Integer getMainUserId ()
Restituisce l'ID utente principale.
Ritorni | |
---|---|
Integer |
l'ID utente dell'utente principale, se presente, e nullo, se non esiste un utente principale. |
Lanci | |
---|---|
DeviceNotAvailableException |
getMainlineModuleInfo
publicgetMainlineModuleInfo ()
Recupera le informazioni sui moduli di linea principali installati sul dispositivo.
Ritorni | |
---|---|
|
ERROR(/Set) di String moduli di linea principali attualmente installati sul dispositivo. |
Lanci | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfRunningUsersSupported
public int getMaxNumberOfRunningUsersSupported ()
Ottieni il numero massimo di utenti supportati in esecuzione contemporaneamente. Il valore predefinito è 0.
Ritorni | |
---|---|
int |
un numero intero che indica il numero di utenti che eseguono contemporaneamente |
Lanci | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfUsersSupported
public int getMaxNumberOfUsersSupported ()
Ottieni il numero massimo di utenti supportati. Il valore predefinito è 0.
Ritorni | |
---|---|
int |
un numero intero che indica il numero di utenti supportati |
Lanci | |
---|---|
DeviceNotAvailableException |
getMicrodroidProcess
public Process getMicrodroidProcess ()
Ritorni | |
---|---|
Process |
Restituisce il processo della VM Microdroid. Se TestDevice non è un Microdroid, restituisce null. |
getMonitor
public IDeviceStateMonitor getMonitor ()
Restituisci il IDeviceStateMonitor
associato al dispositivo.
Ritorni | |
---|---|
IDeviceStateMonitor |
getMountPoint
public String getMountPoint (String mountName)
Restituisce un punto di montaggio.
Esegue una query direttamente sul dispositivo se le informazioni memorizzate nella cache in IDevice
non sono disponibili.
DA FARE: sposta questo comportamento in IDevice#getMountPoint(String)
Parametri | |
---|---|
mountName |
String : il nome del punto di montaggio |
Ritorni | |
---|---|
String |
il punto di montaggio o null |
getMountPointInfo
public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Restituisce un valore MountPointInfo
corrispondente al percorso del punto di montaggio specificato oppure
null
se il percorso non è montato o altrimenti non viene visualizzato in
/proc/mounts come punto di montaggio.
Parametri | |
---|---|
mountpoint |
String |
Ritorni | |
---|---|
ITestDevice.MountPointInfo |
Un elemento ERROR(/List) di MountPointInfo contenente le informazioni in "/proc/mounts" |
Lanci | |
---|---|
DeviceNotAvailableException |
getMountPointInfo
publicgetMountPointInfo ()
Restituisce una versione analizzata delle informazioni in /proc/mounts sul dispositivo
Ritorni | |
---|---|
|
Un elemento ERROR(/List) di MountPointInfo contenente le informazioni in "/proc/mounts" |
Lanci | |
---|---|
DeviceNotAvailableException |
getOpzioni
public TestDeviceOptions getOptions ()
Recupera le opzioni di test per il dispositivo.
Ritorni | |
---|---|
TestDeviceOptions |
TestDeviceOptions relativi al dispositivo sottoposto a test. |
getPartitionFreeSpace
public long getPartitionFreeSpace (String partition)
Metodo di supporto per determinare la quantità di spazio libero sulla partizione del dispositivo.
Parametri | |
---|---|
partition |
String |
Ritorni | |
---|---|
long |
la quantità di spazio libero in kB |
Lanci | |
---|---|
DeviceNotAvailableException |
IDUtentePrincipale
public Integer getPrimaryUserId ()
Restituisce l'ID utente principale.
Ritorni | |
---|---|
Integer |
l'ID utente dell'utente principale, se presente, e nullo, se non esiste un utente principale. |
Lanci | |
---|---|
DeviceNotAvailableException |
getProcessByName
public ProcessInfo getProcessByName (String processName)
Il metodo helper esegue il comando "pidof" e "stat" e restituisce l'oggetto ProcessInfo
con
PID e ora di inizio del processo del processo specificato.
Parametri | |
---|---|
processName |
String : la stringa del nome dei processi. |
Ritorni | |
---|---|
ProcessInfo |
ProcessInfo di un determinato processoName |
Lanci | |
---|---|
DeviceNotAvailableException |
getProcessPid
public String getProcessPid (String process)
Restituisce il PID del servizio o null se si è verificato un problema.
Parametri | |
---|---|
process |
String : la stringa del nome dei processi. |
Ritorni | |
---|---|
String |
Lanci | |
---|---|
DeviceNotAvailableException |
getProductType
public String getProductType ()
Metodo pratico per conoscere il tipo di prodotto di questo dispositivo.
Questo metodo funziona se il dispositivo è in modalità ADB o fastboot.
Ritorni | |
---|---|
String |
il nome del tipo di prodotto String . Non sarà nullo |
Lanci | |
---|---|
DeviceNotAvailableException |
getProductVariant
public String getProductVariant ()
Metodo pratico per ottenere la variante di prodotto di questo dispositivo.
Questo metodo funziona se il dispositivo è in modalità ADB o fastboot.
Ritorni | |
---|---|
String |
il nome della variante del prodotto String o null se non può essere
determinato |
Lanci | |
---|---|
DeviceNotAvailableException |
getProperty
public String getProperty (String name)
Recupera il valore della proprietà specificato dal dispositivo.
Parametri | |
---|---|
name |
String : il nome della proprietà |
Ritorni | |
---|---|
String |
il valore della proprietà o null se non esiste |
Lanci | |
---|---|
DeviceNotAvailableException |
getRecoveryMode
public ITestDevice.RecoveryMode getRecoveryMode ()
Recupera l'attuale modalità di ripristino utilizzata per il dispositivo.
Ritorni | |
---|---|
ITestDevice.RecoveryMode |
La modalità di ripristino corrente utilizzata per il dispositivo. |
getScreenshot
public InputStreamSource getScreenshot (String format)
Acquisisce uno screenshot dal dispositivo. Si consiglia di utilizzare getScreenshot(format) con codifica JPEG per dimensioni inferiori
Parametri | |
---|---|
format |
String : PNG, JPEG supportato |
Ritorni | |
---|---|
InputStreamSource |
una InputStreamSource dello screenshot in formato o null se
lo screenshot non è andato a buon fine. |
Lanci | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot (long displayId)
Recupera uno screenshot dall'ID display del dispositivo specificato. Il formato è PNG.
DA FARE: estendi le implementazioni precedenti per supportare il "formato" e poi scalare
Parametri | |
---|---|
displayId |
long : l'ID di visualizzazione dello schermo da cui recuperare lo screenshot. |
Ritorni | |
---|---|
InputStreamSource |
una InputStreamSource dello screenshot in formato o null se
screenshot non riuscito. |
Lanci | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot (String format, boolean rescale)
Acquisisce uno screenshot dal dispositivo. È consigliabile usare invece getScreenshot(String)
con codifica JPEG per dimensioni inferiori.
Parametri | |
---|---|
format |
String : PNG, JPEG supportato |
rescale |
boolean : se lo screenshot deve essere ridimensionato per ridurre le dimensioni dell'immagine risultante |
Ritorni | |
---|---|
InputStreamSource |
una InputStreamSource dello screenshot in formato o null se
screenshot non riuscito. |
Lanci | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot ()
Acquisisce uno screenshot dal dispositivo.
Ritorni | |
---|---|
InputStreamSource |
Una InputStreamSource dello screenshot in formato PNG o null se
lo screenshot non è andato a buon fine. |
Lanci | |
---|---|
DeviceNotAvailableException |
getSerialNumber
public String getSerialNumber ()
Metodo pratico per ottenere il numero di serie del dispositivo.
Ritorni | |
---|---|
String |
il numero di serie di String |
getImpostazione
public String getSetting (int userId, String namespace, String key)
Restituisce il valore dell'impostazione richiesta. lo spazio dei nomi deve essere uno dei seguenti: {"system", "secure", "global"}
Parametri | |
---|---|
userId |
int |
namespace |
String |
key |
String |
Ritorni | |
---|---|
String |
il valore associato allo spazio dei nomi:chiave di un utente. Nullo se non trovato. |
Lanci | |
---|---|
DeviceNotAvailableException |
getImpostazione
public String getSetting (String namespace, String key)
Vedi getSetting(int, String, String)
ed eseguita sull'utente del sistema.
Parametri | |
---|---|
namespace |
String |
key |
String |
Ritorni | |
---|---|
String |
Lanci | |
---|---|
DeviceNotAvailableException |
getSimOperator
public String getSimOperator ()
Restituisci l'operatore della scheda SIM o null se non è disponibile o se il dispositivo non è disponibile.
Ritorni | |
---|---|
String |
getSimState
public String getSimState ()
Restituisce lo stato della scheda SIM o null se non è disponibile o il dispositivo non è disponibile.
Ritorni | |
---|---|
String |
getTombstones
publicgetTombstones ()
Recupera e restituisci l'elenco delle lapidi dai dispositivi. Richiede root.
è il miglior tentativo, quindi se per qualche motivo non viene estratta una lapide,
non presente nell'elenco. Solo un DeviceNotAvailableException
terminerà il metodo
in anticipo.
Ritorni | |
---|---|
|
Un elenco di file di tombstone, vuoto se non ci sono tombstone. |
Lanci | |
---|---|
DeviceNotAvailableException |
getTotalMemory
public long getTotalMemory ()
Restituisce la dimensione totale della memoria fisica in byte o -1 in caso di errore interno
Ritorni | |
---|---|
long |
getTrackingSerial
public String getTrackingSerial ()
Ai fini della gestione dei dispositivi, individua il numero di serie utilizzato per monitorare il dispositivo.
Ritorni | |
---|---|
String |
getDisinstallaablePackageNames
publicgetUninstallablePackageNames ()
Recupera i nomi dei pacchetti dell'applicazione che possono essere disinstallati. Attualmente definito come pacchetti non di sistema e pacchetti di sistema aggiornati.
Ritorni | |
---|---|
|
ERROR(/Set) dei nomi di pacchetti String disinstallabili attualmente installati nell'
dispositivo. |
Lanci | |
---|---|
DeviceNotAvailableException |
getUseFastbootReset
public boolean getUseFastbootErase ()
Scopri se utilizzare il formato fastboot reset o fastboot per cancellare una partizione sul dispositivo.
Ritorni | |
---|---|
boolean |
true se verrà usato il reset fastboot o false se verrà usato il formato fastboot
. |
Flag User
public int getUserFlags (int userId)
Trova e restituisci i flag di un determinato utente. I flag sono definiti in "android.content.pm.UserInfo" nel progetto open source Android.
Parametri | |
---|---|
userId |
int |
Ritorni | |
---|---|
int |
i flag associati allo userId fornito, se trovato, -10000 in tutti gli altri casi. |
Lanci | |
---|---|
DeviceNotAvailableException |
OttieniInfoUtente
publicgetUserInfos ()
Recupera la mappa di useId per UserInfo
sul dispositivo. Se l'output dal dispositivo non è quello previsto, verrà generato DeviceRuntimeException
.
Ritorni | |
---|---|
|
l'elenco di oggetti UserInfo. |
Lanci | |
---|---|
DeviceNotAvailableException |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Restituisce il numero di serie associato allo userId, se trovato, -10000 in tutti gli altri casi.
Parametri | |
---|---|
userId |
int |
Ritorni | |
---|---|
int |
Lanci | |
---|---|
DeviceNotAvailableException |
handleAllocationEvent
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
Elabora l'elemento DeviceEvent specificato. Può eseguire la transizione del dispositivo
nel nuovo stato. Informerà IDeviceMonitor
di eventuali transizioni di stato.
Elaborare DeviceEvent, che può o meno trasferire questo dispositivo a una nuova allocazione stato.
Parametri | |
---|---|
event |
DeviceEvent |
Ritorni | |
---|---|
IManagedTestDevice.DeviceEventResponse |
hasFeature
public boolean hasFeature (String feature)
Controlla se una funzionalità è disponibile su un dispositivo.
Parametri | |
---|---|
feature |
String : quale formato deve essere "feature: |
Ritorni | |
---|---|
boolean |
True se la caratteristica viene trovata, false in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, String... extraArgs)
Installa un pacchetto Android sul dispositivo.
Parametri | |
---|---|
packageFile |
File : il file apk da installare |
reinstall |
boolean : true se è necessario eseguire una reinstallazione |
extraArgs |
String : argomenti aggiuntivi facoltativi da passare. Vedi "adb shell pm -h" per disponibile
le opzioni di CPU e memoria disponibili. |
Ritorni | |
---|---|
String |
String con un codice di errore o null in caso di esito positivo. |
Lanci | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Installa un pacchetto Android sul dispositivo.
Nota: solo i casi d'uso che richiedono il controllo esplicito della concessione dell'autorizzazione di runtime al la data e l'ora di installazione devono chiamare questa funzione.
Parametri | |
---|---|
packageFile |
File : il file apk da installare |
reinstall |
boolean : true se è necessario eseguire una reinstallazione |
grantPermissions |
boolean : se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione |
extraArgs |
String : argomenti aggiuntivi facoltativi da passare. Vedi "adb shell pm -h" per disponibile
le opzioni di CPU e memoria disponibili. |
Ritorni | |
---|---|
String |
String con un codice di errore o null in caso di esito positivo. |
Lanci | |
---|---|
DeviceNotAvailableException |
installPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)
Installa un pacchetto Android sul dispositivo di un determinato utente.
Parametri | |
---|---|
packageFile |
File : il file apk da installare |
reinstall |
boolean : true se è necessario eseguire una reinstallazione |
userId |
int : l'ID utente intero per il quale eseguire l'installazione. |
extraArgs |
String : argomenti aggiuntivi facoltativi da passare. Vedi "adb shell pm -h" per disponibile
le opzioni di CPU e memoria disponibili. |
Ritorni | |
---|---|
String |
String con un codice di errore o null in caso di esito positivo. |
Lanci | |
---|---|
DeviceNotAvailableException |
installPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Installa un pacchetto Android sul dispositivo di un determinato utente.
Nota: solo i casi d'uso che richiedono il controllo esplicito della concessione dell'autorizzazione di runtime al la data e l'ora di installazione devono chiamare questa funzione.
Parametri | |
---|---|
packageFile |
File : il file apk da installare |
reinstall |
boolean : true se è necessario eseguire una reinstallazione |
grantPermissions |
boolean : se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione |
userId |
int : l'ID utente intero per il quale eseguire l'installazione. |
extraArgs |
String : argomenti aggiuntivi facoltativi da passare. Vedi "adb shell pm -h" per disponibile
le opzioni di CPU e memoria disponibili. |
Ritorni | |
---|---|
String |
String con un codice di errore o null in caso di esito positivo. |
Lanci | |
---|---|
DeviceNotAvailableException |
invalidaProprietàCache
public void invalidatePropertyCache ()
isAdbTcp
public boolean isAdbTcp ()
Ritorni | |
---|---|
boolean |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Controllare se la piattaforma sul dispositivo supporta l'enumerazione delle app
Ritorni | |
---|---|
boolean |
True se l'enumerazione dell'app è supportata, false in caso contrario |
Lanci | |
---|---|
DeviceNotAvailableException |
isBypassLowTargetSdkBlockSupported
public boolean isBypassLowTargetSdkBlockSupported ()
Controlla se la piattaforma sul dispositivo supporta l'aggiramento del blocco SDK target basso sulle installazioni di app
Ritorni | |
---|---|
boolean |
True se by bypass il blocco SDK target basso è supportato, false altrimenti |
Lanci | |
---|---|
DeviceNotAvailableException |
isDebugfsMounted
public boolean isDebugfsMounted ()
Controlla se il debugfs è montato.
Ritorni | |
---|---|
boolean |
true se il debugfs è montato |
Lanci | |
---|---|
DeviceNotAvailableException |
isDeviceEncrypted
public boolean isDeviceEncrypted ()
Indica se il dispositivo è criptato.
Ritorni | |
---|---|
boolean |
true se il dispositivo è criptato. |
Lanci | |
---|---|
DeviceNotAvailableException |
isDirectory
public boolean isDirectory (String path)
Restituisce True se il percorso sul dispositivo è una directory, false in caso contrario.
Parametri | |
---|---|
path |
String |
Ritorni | |
---|---|
boolean |
Lanci | |
---|---|
DeviceNotAvailableException |
isAbilitaAdbRoot
public boolean isEnableAdbRoot ()
Ritorni | |
---|---|
boolean |
true se ADB root deve essere attivato sul dispositivo |
CrittografiaSupportato
public boolean isEncryptionSupported ()
Indica se la crittografia è supportata sul dispositivo.
Ritorni | |
---|---|
boolean |
true , se il dispositivo supporta la crittografia. |
Lanci | |
---|---|
DeviceNotAvailableException |
èeseguibile
public boolean isExecutable (String fullPath)
Restituisce True se il percorso del file sul dispositivo è un file eseguibile, false in caso contrario.
Parametri | |
---|---|
fullPath |
String |
Ritorni | |
---|---|
boolean |
Lanci | |
---|---|
DeviceNotAvailableException |
isFastbootEnabled
public boolean isFastbootEnabled ()
Restituire se fastboot è disponibile per il dispositivo.
Ritorni | |
---|---|
boolean |
isHeadless
public boolean isHeadless ()
Restituisce true se il dispositivo è headless (nessuno schermo), false negli altri casi.
Ritorni | |
---|---|
boolean |
Lanci | |
---|---|
DeviceNotAvailableException |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Indica se il dispositivo utilizza la modalità utente di sistema headless.
Ritorni | |
---|---|
boolean |
Lanci | |
---|---|
DeviceNotAvailableException |
èAmministratorePermanenteUtentePrincipale
public boolean isMainUserPermanentAdmin ()
Indica se l'utente principale è un amministratore permanente e non può essere eliminato o eseguito il downgrade a non amministratore.
Ritorni | |
---|---|
boolean |
Lanci | |
---|---|
DeviceNotAvailableException |
isMultiUserSupported
public boolean isMultiUserSupported ()
Determina se la funzionalità multiutente è supportata.
Ritorni | |
---|---|
boolean |
true se la funzionalità multiutente è supportata, false negli altri casi |
Lanci | |
---|---|
DeviceNotAvailableException |
èPacchettoInstallato
public boolean isPackageInstalled (String packageName, String userId)
Esegui una query sul dispositivo per trovare un dato nome pacchetto e un dato ID utente per verificare se al momento installato o meno per quell'utente.
Parametri | |
---|---|
packageName |
String : il pacchetto che stiamo controllando se è installato. |
userId |
String : l'ID utente per il quale stiamo controllando l'installazione del pacchetto. Se nullo, l'utente principale
0. |
Ritorni | |
---|---|
boolean |
True se il pacchetto è segnalato come installato. Falso negli altri casi. |
Lanci | |
---|---|
DeviceNotAvailableException |
èPacchettoInstallato
public boolean isPackageInstalled (String packageName)
Esegui una query sul dispositivo per trovare un determinato nome di pacchetto per verificare se il pacchetto è attualmente installato o meno.
Parametri | |
---|---|
packageName |
String |
Ritorni | |
---|---|
boolean |
True se il pacchetto è segnalato come installato. Falso negli altri casi. |
Lanci | |
---|---|
DeviceNotAvailableException |
isRuntimePermissionSupported
public boolean isRuntimePermissionSupported ()
Controlla se la piattaforma sul dispositivo supporta la concessione delle autorizzazioni di runtime
Ritorni | |
---|---|
boolean |
True se le autorizzazioni di runtime sono supportate, false negli altri casi. |
Lanci | |
---|---|
DeviceNotAvailableException |
isStateBootloaderOrFastbootd
public boolean isStateBootloaderOrFastbootd ()
Restituisce true se il dispositivo è in TestDeviceState#FASTBOOT
o TestDeviceState.FASTBOOTD
.
Ritorni | |
---|---|
boolean |
èIn esecuzioneUtente
public boolean isUserRunning (int userId)
Verificare se un determinato utente è in esecuzione.
Parametri | |
---|---|
userId |
int |
Ritorni | |
---|---|
boolean |
True se l'utente è in esecuzione, falso negli altri casi. |
Lanci | |
---|---|
DeviceNotAvailableException |
èUtenteSecondario
public boolean isUserSecondary (int userId)
Indica se l'utente specificato è un utente secondario in base ai flag.
Parametri | |
---|---|
userId |
int |
Ritorni | |
---|---|
boolean |
true se l'utente è secondario, false negli altri casi. |
Lanci | |
---|---|
DeviceNotAvailableException |
UtenteVisibile
public boolean isUserVisible (int userId)
Controlla se l'utente specificato è visibile.
Un "visibile" l'utente è un utente che sta interagendo con l'"umano" all'utente e, di conseguenza, può avviare attività di avvio (di solito, nella visualizzazione predefinita).
Parametri | |
---|---|
userId |
int |
Ritorni | |
---|---|
boolean |
Lanci | |
---|---|
DeviceNotAvailableException |
UtenteVisibileSuDisplay
public boolean isUserVisibleOnDisplay (int userId, int displayId)
Controlla se l'utente è visibile sul display specificato.
Un "visibile" l'utente è un utente che sta interagendo con l'"umano" all'utente e, di conseguenza, può avviare attività di lancio in quel display.
Parametri | |
---|---|
userId |
int |
displayId |
int |
Ritorni | |
---|---|
boolean |
Lanci | |
---|---|
DeviceNotAvailableException |
isVisibileBackgroundUsersOnDefaultDisplaySupported
public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
Indica se il dispositivo consente agli utenti di essere avviati visibili in background in ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
.
In caso affermativo, potresti chiamare startVisibleBackgroundUser(int, int, boolean)
, superando
un display restituito da listDisplayIdsForStartingVisibleBackgroundUsers()
(che
deve includere ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
).
Ritorni | |
---|---|
boolean |
Lanci | |
---|---|
DeviceNotAvailableException |
èVisibileUtentiSfondoSupportato
public boolean isVisibleBackgroundUsersSupported ()
Indica se il dispositivo consente agli utenti di essere avviati visibili in background.
In caso affermativo, potresti chiamare startVisibleBackgroundUser(int, int, boolean)
, superando
un display restituito da listDisplayIdsForStartingVisibleBackgroundUsers()
.
Ritorni | |
---|---|
boolean |
Lanci | |
---|---|
DeviceNotAvailableException |
isWifiEnabled
public boolean isWifiEnabled ()
Verifica che il Wi-Fi sia attivo.
Controlla se il Wi-Fi è attivo sul dispositivo. Utile per dichiarare lo stato del Wi-Fi prima di testare non deve funzionare con Wi-Fi, ad esempio test dei dati mobili.
Ritorni | |
---|---|
boolean |
true se il Wi-Fi è attivo. false se disattivato |
Lanci | |
---|---|
DeviceNotAvailableException |
listDisplayId
publiclistDisplayIds ()
Raccogli l'elenco degli ID dei display disponibili sul dispositivo segnalato da "dumpsys SurfaceFlinger".
Ritorni | |
---|---|
|
L'elenco delle visualizzazioni. L'impostazione predefinita restituisce sempre 0 come visualizzazione predefinita. |
Lanci | |
---|---|
DeviceNotAvailableException |
listDisplayIdsForStartingVisibilityBackgroundUsers
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
Recupera l'elenco di display che possono essere utilizzati per start a user visible in the background
.
Ritorni | |
---|---|
|
Lanci | |
---|---|
DeviceNotAvailableException |
elencoUtenti
publiclistUsers ()
Recupera l'elenco di utenti presenti sul dispositivo. Se output verrà generato DeviceRuntimeException
dal dispositivo non è come previsto.
Ritorni | |
---|---|
|
l'elenco degli ID utente. |
Lanci | |
---|---|
DeviceNotAvailableException |
logAn
public boolean logAnrs (ITestLogger logger)
Raccoglie e registra gli errori ANR dal dispositivo.
Parametri | |
---|---|
logger |
ITestLogger : un ITestLogger per registrare gli errori ANR. |
Ritorni | |
---|---|
boolean |
True se il logging è riuscito, false in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
logBugreport
public boolean logBugreport (String dataName, ITestLogger listener)
Metodo di supporto per inviare una segnalazione di bug e registrarla agli autori di segnalazioni.
Parametri | |
---|---|
dataName |
String : nome con cui verrà segnalata la segnalazione di bug. |
listener |
ITestLogger : un ITestLogger per registrare la segnalazione di bug. |
Ritorni | |
---|---|
boolean |
True se il logging è riuscito, false in caso contrario. |
Dispositivo di accesso
public void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
Registra un messaggio nel logcat del dispositivo. Si tratta di una chiamata sicura che non verrà generata nemmeno la registrazione non va a buon fine.
Parametri | |
---|---|
tag |
String : il tag in base al quale 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 : gli argomenti da sostituire tramite String.format(). |
nonBlockRiavvia
public void nonBlockingReboot ()
Emette un comando per riavviare il dispositivo e ritorna al completamento del comando e quando il dispositivo non è più visibile ad ADB.
Lanci | |
---|---|
DeviceNotAvailableException |
postAdbRootAction
public void postAdbRootAction ()
Esegui l'override se il dispositivo ha bisogno di determinate azioni dopo la root adb e prima del comando il dispositivo è di nuovo online. L'implementazione predefinita non include azioni aggiuntive. Non è garantita l'attivazione di adb root in questa fase.
Lanci | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableEccezione |
DeviceNotAvailableException |
postAdbUnrootAction
public void postAdbUnrootAction ()
Esegui l'override se il dispositivo richiede l'esecuzione di determinate azioni dopo l'unroot dell'adb e prima il dispositivo è di nuovo online. L'implementazione predefinita non include azioni aggiuntive. Non è garantita la disattivazione della directory principale adb in questa fase.
Lanci | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableEccezione |
DeviceNotAvailableException |
configurazione postBoot
public void postBootSetup ()
Segui le istruzioni per configurare il dispositivo e testarlo dopo ogni avvio.
Deve essere chiamata dopo che il dispositivo è completamente avviato/disponibile
In circostanze normali questo metodo non deve essere chiamato esplicitamente, le implementazioni dovrebbero eseguire automaticamente questi passaggi quando si esegue un riavvio.
Potrebbe essere necessario chiamare quando il dispositivo si riavvia a causa di altri eventi (ad esempio, quando il comando di aggiornamento fastboot è stato completato)
Lanci | |
---|---|
DeviceNotAvailableException |
postInvocationTeardown
public void postInvocationTearDown (Throwable exception)
Passaggi aggiuntivi per la pulizia specifica del dispositivo che verranno eseguiti dopo la chiamata al termine dell'operazione.
Parametri | |
---|---|
exception |
Throwable : se presente, l'eccezione finale sollevata dall'errore di chiamata. |
impostazione preInvocation
public 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.
Parametri | |
---|---|
info |
IBuildInfo : il IBuildInfo del dispositivo. |
attributes |
MultiMap : gli attributi archiviati nel contesto di chiamata |
Lanci | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
Dir pull
public boolean pullDir (String deviceFilePath, File localDir, int userId)
Esegui il pull ricorsivo dei contenuti della directory dal dispositivo.
Parametri | |
---|---|
deviceFilePath |
String : il percorso file assoluto dell'origine remota |
localDir |
File : la directory locale in cui estrarre i file |
userId |
int : l'ID utente da cui eseguire il pull |
Ritorni | |
---|---|
boolean |
true se il file è stato estratto correttamente. false in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
Dir pull
public boolean pullDir (String deviceFilePath, File localDir)
Esegui il pull ricorsivo dei contenuti della directory dal dispositivo.
Parametri | |
---|---|
deviceFilePath |
String : il percorso file assoluto dell'origine remota |
localDir |
File : la directory locale in cui estrarre i file |
Ritorni | |
---|---|
boolean |
true se il file è stato estratto correttamente. false in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
PullFile
public boolean pullFile (String remoteFilePath, File localFile)
Recupera un file dal dispositivo.
Parametri | |
---|---|
remoteFilePath |
String : il percorso assoluto al file sul dispositivo. |
localFile |
File : il file locale in cui archiviare i contenuti. Se il campo non è vuoto, i contenuti saranno
sostituite. |
Ritorni | |
---|---|
boolean |
true se il file è stato recuperato correttamente. false in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
PullFile
public File pullFile (String remoteFilePath, int userId)
Recupera un file dal dispositivo, lo archivia in un file ERROR(/File)
temporaneo locale e lo restituisce
File
.
Parametri | |
---|---|
remoteFilePath |
String : il percorso assoluto al file sul dispositivo. |
userId |
int : l'ID utente da cui eseguire il pull |
Ritorni | |
---|---|
File |
Un elemento ERROR(/File) contenente i contenuti del file del dispositivo oppure null se il valore
copia non riuscita per qualsiasi motivo (inclusi problemi con il file system dell'host) |
Lanci | |
---|---|
DeviceNotAvailableException |
PullFile
public File pullFile (String remoteFilePath)
Recupera un file dal dispositivo, lo archivia in un file ERROR(/File)
temporaneo locale e lo restituisce
File
.
Parametri | |
---|---|
remoteFilePath |
String : il percorso assoluto al file sul dispositivo. |
Ritorni | |
---|---|
File |
Un elemento ERROR(/File) contenente i contenuti del file del dispositivo oppure null se il valore
copia non riuscita per qualsiasi motivo (inclusi problemi con il file system dell'host) |
Lanci | |
---|---|
DeviceNotAvailableException |
PullFile
public boolean pullFile (String remoteFilePath, File localFile, int userId)
Recupera un file dal dispositivo.
Parametri | |
---|---|
remoteFilePath |
String : il percorso assoluto al file sul dispositivo. |
localFile |
File : il file locale in cui archiviare i contenuti. Se il campo non è vuoto, i contenuti saranno
sostituite. |
userId |
int : l'ID utente da cui eseguire il pull |
Ritorni | |
---|---|
boolean |
true se il file è stato recuperato correttamente. false in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
pullFileContents
public String pullFileContents (String remoteFilePath)
Recupera un file dal dispositivo e restituisce i contenuti.
Parametri | |
---|---|
remoteFilePath |
String : il percorso assoluto al file sul dispositivo. |
Ritorni | |
---|---|
String |
Un elemento String contenente i contenuti del file del dispositivo oppure null se il valore
copia non riuscita per qualsiasi motivo (inclusi problemi con il file system dell'host) |
Lanci | |
---|---|
DeviceNotAvailableException |
pullFileDaEsterno
public File pullFileFromExternal (String remoteFilePath)
Un metodo pratico per recuperare un file dalla memoria esterna del dispositivo, archivialo in un
ERROR(/File)
temporaneo locale e restituirà un riferimento a tale File
.
Parametri | |
---|---|
remoteFilePath |
String : il percorso del file sul dispositivo in relazione alla memoria esterna del dispositivo
punto di montaggio |
Ritorni | |
---|---|
File |
Un elemento ERROR(/File) contenente i contenuti del file del dispositivo oppure null se il valore
copia non riuscita per qualsiasi motivo (inclusi problemi con il file system dell'host) |
Lanci | |
---|---|
DeviceNotAvailableException |
Dir push
public boolean pushDir (File localFileDir, String deviceFilePath,excludedDirectories)
Esegui il push ricorsivo dei contenuti delle directory al dispositivo, escludendo alcune directory che sono filtrati.
Parametri | |
---|---|
localFileDir |
File : la directory locale di cui eseguire il push |
deviceFilePath |
String : il percorso file assoluto della destinazione remota |
excludedDirectories |
: insieme di nomi di directory escluse di cui non deve essere eseguito il push. |
Ritorni | |
---|---|
boolean |
true se il push del file è stato eseguito correttamente. false in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
Dir push
public boolean pushDir (File localFileDir, String deviceFilePath)
Esegui il push ricorsivo dei contenuti della directory sul dispositivo.
Parametri | |
---|---|
localFileDir |
File : la directory locale di cui eseguire il push |
deviceFilePath |
String : il percorso file assoluto della destinazione remota |
Ritorni | |
---|---|
boolean |
true se il push del file è stato eseguito correttamente. false in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
Dir push
public boolean pushDir (File localFileDir, String deviceFilePath, int userId)
Esegui il push ricorsivo dei contenuti della directory sul dispositivo.
Parametri | |
---|---|
localFileDir |
File : la directory locale di cui eseguire il push |
deviceFilePath |
String : il percorso file assoluto della destinazione remota |
userId |
int : l'ID utente di cui eseguire il push |
Ritorni | |
---|---|
boolean |
true se il push del file è stato eseguito correttamente. false in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
File push
public boolean pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Variante di pushFile(File, String)
che può facoltativamente valutare la necessità
per il fornitore di contenuti.
Parametri | |
---|---|
localFile |
File : il file locale di cui eseguire il push |
remoteFilePath |
String : il percorso del file assoluto di destinazione remota |
evaluateContentProviderNeeded |
boolean : se controllare se abbiamo bisogno del fornitore di contenuti |
Ritorni | |
---|---|
boolean |
true se il push del file è stato eseguito correttamente. false in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
File push
public boolean pushFile (File localFile, String remoteFilePath)
Esegui il push di un file sul dispositivo. Per impostazione predefinita, viene utilizzato un fornitore di contenuti.
Parametri | |
---|---|
localFile |
File : il file locale di cui eseguire il push |
remoteFilePath |
String : il percorso del file assoluto di destinazione remota |
Ritorni | |
---|---|
boolean |
true se il push del file è stato eseguito correttamente. false in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
File push
public boolean pushFile (File localFile, String remoteFilePath, int userId)
Esegui il push di un file sul dispositivo. Per impostazione predefinita, viene utilizzato un fornitore di contenuti.
Parametri | |
---|---|
localFile |
File : il file locale di cui eseguire il push |
remoteFilePath |
String : il percorso del file assoluto di destinazione remota |
userId |
int : lo userId a cui eseguire il push |
Ritorni | |
---|---|
boolean |
true se il push del file è stato eseguito correttamente. false in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
Stringaspinta
public boolean pushString (String contents, String remoteFilePath)
Esegui il push del file creato da una stringa al dispositivo
Parametri | |
---|---|
contents |
String : i contenuti del file di cui eseguire il push |
remoteFilePath |
String : il percorso del file assoluto di destinazione remota |
Ritorni | |
---|---|
boolean |
true se il push della stringa è stato eseguito correttamente. false in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
fai ripartire
public void reboot (String reason)
Riavvia il dispositivo in modalità ADB e l'reason
specificato sarà mantenuto fino al riavvio.
Viene bloccato finché il dispositivo non diventa disponibile.
Puoi ottenere il motivo dell'ultimo riavvio eseguendo una query sulla proprietà sys.boot.reason
.
Parametri | |
---|---|
reason |
String : un motivo per questo riavvio o null se non ne viene specificato alcun motivo. |
Lanci | |
---|---|
DeviceNotAvailableException |
fai ripartire
public void reboot ()
Riavvia il dispositivo in modalità ADB.
Viene bloccato finché il dispositivo non diventa disponibile.
Lanci | |
---|---|
DeviceNotAvailableException |
riavvioIntoBootloader
public void rebootIntoBootloader ()
Riavvia il dispositivo in modalità bootloader.
Si blocca finché il dispositivo non è in modalità bootloader.
Lanci | |
---|---|
DeviceNotAvailableException |
riavvioIntoFastbootd
public void rebootIntoFastbootd ()
Riavvia il dispositivo in modalità Fastbootd.
Si blocca finché il dispositivo non è in modalità fastbootd.
Lanci | |
---|---|
DeviceNotAvailableException |
riavvioIntoRecovery
public void rebootIntoRecovery ()
Riavvia il dispositivo in modalità di ripristino ADB.
Blocca fino all'attivazione del ripristino del dispositivo
Lanci | |
---|---|
DeviceNotAvailableException |
riavvioIntoSideload
public void rebootIntoSideload ()
Riavvia il dispositivo in modalità sideload adb (tieni presente che si tratta di una modalità speciale in fase di ripristino)
Blocco fino all'attivazione della modalità sideload sul dispositivo
Lanci | |
---|---|
DeviceNotAvailableException |
riavvioIntoSideload
public void rebootIntoSideload (boolean autoReboot)
Riavvia il dispositivo in modalità sideload adb (tieni presente che si tratta di una modalità speciale in fase di ripristino)
Blocco fino all'attivazione della modalità sideload sul dispositivo
Parametri | |
---|---|
autoReboot |
boolean : indica se riavviare automaticamente il dispositivo dopo il sideload |
Lanci | |
---|---|
DeviceNotAvailableException |
esegui riavvioUntilOnline
public void rebootUntilOnline ()
Un'alternativa a reboot()
che si blocca solo finché il dispositivo non è online, cioè visibile ad ADB.
Lanci | |
---|---|
DeviceNotAvailableException |
esegui riavvioUntilOnline
public void rebootUntilOnline (String reason)
Un'alternativa a reboot()
che si blocca solo finché il dispositivo non è online, cioè visibile ad ADB.
Parametri | |
---|---|
reason |
String : un motivo per questo riavvio o null se non ne viene specificato alcun motivo. |
Lanci | |
---|---|
DeviceNotAvailableException |
riavvioSpazioutente
public void rebootUserspace ()
Riavvia solo la parte dello spazio utente del dispositivo.
Viene bloccato finché il dispositivo non diventa disponibile.
AVVISO. Il riavvio dello spazio utente è attualmente in fase di sviluppo attivo. Utilizzalo a tuo rischio.
Lanci | |
---|---|
DeviceNotAvailableException |
riavvioSpazioUtenteUntilOnline
public void rebootUserspaceUntilOnline ()
Un'alternativa a rebootUserspace()
()} che viene bloccata soltanto finché il dispositivo non è online, ad esempio
visibile ad ADB.
Lanci | |
---|---|
DeviceNotAvailableException |
ripristinoDispositivo
public boolean recoverDevice ()
Tenta di recuperare la comunicazione del dispositivo.
Ritorni | |
---|---|
boolean |
True se il recupero è stato tentato e riuscito, restituisce False se il recupero è stato saltato |
Lanci | |
---|---|
DeviceNotAvailableException |
se il dispositivo non è più disponibile |
registriDispositivoAzioneRicevitore
public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Registra un IDeviceActionReceiver
per questo dispositivo.
Tutti gli utenti IDeviceActionReceiver
registrati riceveranno una notifica prima di un'azione del dispositivo
l'avvio e il termine dell'azione sul dispositivo.
Parametri | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : un IDeviceActionReceiver che verrà registrato. |
rimontaggioSistemaReadOnly
public void remountSystemReadOnly ()
Imposta la partizione di sistema sul dispositivo come di sola lettura. Il dispositivo potrebbe essere riavviato.
Lanci | |
---|---|
DeviceNotAvailableException |
rimonta SystemWritable
public void remountSystemWritable ()
Rendi scrivibile la partizione di sistema del dispositivo. Il dispositivo potrebbe essere riavviato.
Lanci | |
---|---|
DeviceNotAvailableException |
rimontaVendorReadOnly
public void remountVendorReadOnly ()
Rendi la partizione del fornitore sul dispositivo di sola lettura. Il dispositivo potrebbe essere riavviato.
Lanci | |
---|---|
DeviceNotAvailableException |
rimontareVendorWritable
public void remountVendorWritable ()
Rendi scrivibile la partizione del fornitore sul dispositivo. Il dispositivo potrebbe essere riavviato.
Lanci | |
---|---|
DeviceNotAvailableException |
rimuovereAmministratore
public boolean removeAdmin (String componentName, int userId)
Rimuovi l'amministratore del dispositivo specificato per l'utente e restituisci true
se l'operazione ha esito positivo, false
in caso contrario.
Parametri | |
---|---|
componentName |
String : amministratore del dispositivo da rimuovere. |
userId |
int : dell'utente di cui risiede l'amministratore del dispositivo. |
Ritorni | |
---|---|
boolean |
True se ha esito positivo, falso in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
rimuoviProprietari
public void removeOwners ()
Rimuovi tutti i proprietari di profili esistenti del dispositivo con il massimo impegno.
Lanci | |
---|---|
DeviceNotAvailableException |
rimuovereUtente
public boolean removeUser (int userId)
Rimuovere un determinato utente dal dispositivo.
Parametri | |
---|---|
userId |
int : dell'utente da rimuovere |
Ritorni | |
---|---|
boolean |
true se la rimozione dell'utente è riuscita, false in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
resetContentProviderSetup
public void resetContentProviderSetup ()
Reimposta il flag per la configurazione del fornitore di contenuti per attivarlo di nuovo.
runInstrumentationTest
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Metodo pratico per eseguire ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
con uno o più listener passati come parametri.
Parametri | |
---|---|
runner |
IRemoteAndroidTestRunner : il IRemoteAndroidTestRunner che esegue i test |
listeners |
ITestLifeCycleReceiver : i listener dei risultati del test |
Ritorni | |
---|---|
boolean |
true se il comando di test è stato completato. false se l'operazione non è riuscita
completato, ma il recupero è riuscito |
Lanci | |
---|---|
DeviceNotAvailableException |
runInstrumentationTest
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Esegue test di strumentazione e fornisce il recupero del dispositivo.
Se la connessione al dispositivo viene persa prima del completamento dell'esecuzione del test e il recupero va a buon fine, i listener verranno informati di testRunFailed e "false" verrà restituito. Il comando di test non verranno eseguite nuovamente. I chiamanti possono riprovare se necessario.
Se la connessione al dispositivo si perde prima del completamento dell'esecuzione del test e il ripristino non va a buon fine, i listener verranno informati di testRunFailed e verrà restituito un DeviceNotAvailableException.
Parametri | |
---|---|
runner |
IRemoteAndroidTestRunner : il IRemoteAndroidTestRunner che esegue i test |
listeners |
: i listener dei risultati del test |
Ritorni | |
---|---|
boolean |
true se il comando di test è stato completato. false se l'operazione non è riuscita
completato a causa di un'eccezione di comunicazione del dispositivo, ma il recupero è riuscito |
Lanci | |
---|---|
DeviceNotAvailableException |
eseguiTestInstrumentationAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Uguale a ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
ma
esegue il test per l'utente specificato.
Parametri | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
|
Ritorni | |
---|---|
boolean |
Lanci | |
---|---|
DeviceNotAvailableException |
eseguiTestInstrumentationAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Uguale a ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner,
ITestLifeCycleReceiver...)
, ma esegue il test per un determinato utente.
Parametri | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
ITestLifeCycleReceiver |
Ritorni | |
---|---|
boolean |
Lanci | |
---|---|
DeviceNotAvailableException |
setConfiguration
public void setConfiguration (IConfiguration configuration)
Inserisce IConfiguration
in uso.
Parametri | |
---|---|
configuration |
IConfiguration |
setConnectionAvdInfo
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
Parametri | |
---|---|
avdInfo |
GceAvdInfo |
setDate
public void setDate (Date date)
Imposta la data sul dispositivo
Nota: l'impostazione della data sul dispositivo richiede il root
Parametri | |
---|---|
date |
Date : specifica una data particolare; utilizzerà la data host se null |
Lanci | |
---|---|
DeviceNotAvailableException |
impostaProprietarioDispositivo
public boolean setDeviceOwner (String componentName, int userId)
Imposta un componente di amministrazione del dispositivo come proprietario del dispositivo in un determinato utente.
Parametri | |
---|---|
componentName |
String : dell'amministratore del dispositivo come proprietario. |
userId |
int : dell'utente in cui risiede il proprietario del dispositivo. |
Ritorni | |
---|---|
boolean |
True se ha esito positivo, falso in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
setDeviceState
public void setDeviceState (TestDeviceState deviceState)
Aggiorna lo stato del dispositivo.
Parametri | |
---|---|
deviceState |
TestDeviceState : TestDeviceState |
setEmulatorOutputStream
public void setEmulatorOutputStream (SizeLimitedOutputStream output)
Per l'emulatore imposta SizeLimitedOutputStream
su log output
Parametri | |
---|---|
output |
SizeLimitedOutputStream : per registrare l'output |
setEmulatorProcess
public void setEmulatorProcess (Process p)
Consente di impostare Process
se il dispositivo è un emulatore.
Parametri | |
---|---|
p |
Process |
setFastbootEnabled
public void setFastbootEnabled (boolean fastbootEnabled)
Imposta l'opzione fastboot per il dispositivo. Da impostare quando il dispositivo viene attivato sono state assegnate.
Parametri | |
---|---|
fastbootEnabled |
boolean : se fastboot è disponibile per il dispositivo |
setFastbootPath
public void setFastbootPath (String fastbootPath)
Imposta il percorso del programma binario fastboot da utilizzare.
È comunque necessario che isFastbootEnabled()
sia true e le funzioni fastboot siano abilitate.
Parametri | |
---|---|
fastbootPath |
String |
impostaIDispositivo
public void setIDevice (IDevice newDevice)
Aggiorna l'IDevice associato a questo ITestDevice.
Il nuovo dispositivo deve fare riferimento allo stesso dispositivo fisico come riferimento corrente. Questo metodo verrà chiamato se DCM ha assegnato un nuovo IDevice
Parametri | |
---|---|
newDevice |
IDevice : IDevice |
setLogStartDelay
public void setLogStartDelay (int delay)
Imposta il tempo di attesa in ms prima di avviare l'acquisizione di logcat per un dispositivo online.
Parametri | |
---|---|
delay |
int : il ritardo in ms |
impostaOpzioni
public void setOptions (TestDeviceOptions options)
Imposta TestDeviceOptions
per il dispositivo
Parametri | |
---|---|
options |
TestDeviceOptions |
setProprietà
public boolean setProperty (String propKey, String propValue)
Imposta il valore specificato per la proprietà sul dispositivo. Richiede che la radice ADB sia true.
Parametri | |
---|---|
propKey |
String : la chiave da impostare. |
propValue |
String : il valore della proprietà da impostare. |
Ritorni | |
---|---|
boolean |
restituisce True se il comando setprop è riuscito, False in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
setRecovery
public void setRecovery (IDeviceRecovery recovery)
Imposta il IDeviceRecovery
da usare per questo dispositivo. Da impostare quando il dispositivo viene attivato
sono state assegnate.
Parametri | |
---|---|
recovery |
IDeviceRecovery : IDeviceRecovery |
setRecoveryMode
public void setRecoveryMode (ITestDevice.RecoveryMode mode)
Imposta l'attuale modalità di ripristino da usare per il dispositivo.
Utilizzato per controllare quale metodo di recupero usare quando si verifica un problema di comunicazione del dispositivo riscontrati. Ti consigliamo di utilizzare questo metodo solo con parsimonia quando necessario (ad esempio, quando il framework non è disponibile e così via
Parametri | |
---|---|
mode |
ITestDevice.RecoveryMode : "recupera fino a solo online" deve essere attivata o meno. |
impostazioniImpostazione
public void setSetting (String namespace, String key, String value)
Vedi setSetting(int, String, String, String)
ed eseguita sull'utente del sistema.
Parametri | |
---|---|
namespace |
String |
key |
String |
value |
String |
Lanci | |
---|---|
DeviceNotAvailableException |
impostazioniImpostazione
public void setSetting (int userId, String namespace, String key, String value)
Aggiungi un valore di impostazione allo spazio dei nomi di un determinato utente. Alcune impostazioni saranno disponibili solo dopo un riavvio. lo spazio dei nomi deve essere uno dei seguenti: {"system", "secure", "global"}
Parametri | |
---|---|
userId |
int |
namespace |
String |
key |
String |
value |
String |
Lanci | |
---|---|
DeviceNotAvailableException |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Inserisce l'istanza ITestLogger
Parametri | |
---|---|
testLogger |
ITestLogger |
setTrackingSerial
public void setTrackingSerial (String trackingSerial)
Ai fini della gestione dei dispositivi, traccia il numero di serie che utilizziamo per fare riferimento al dispositivo.
Parametri | |
---|---|
trackingSerial |
String |
ImpostaUsaFastbootReset
public void setUseFastbootErase (boolean useFastbootErase)
Scegli se utilizzare il formato fastboot reset o fastboot per cancellare una partizione sul dispositivo.
Parametri | |
---|---|
useFastbootErase |
boolean : true se è necessario usare l'eliminazione rapida oppure false se è necessario
deve essere usato il formato fastboot. |
StartLogcat
public void startLogcat ()
Avvia l'acquisizione dell'output logcat dal dispositivo in background.
Non avrà alcun effetto se l'output logcat è già in fase di acquisizione. I dati possono essere recuperati in un secondo momento tramite getLogcat.
Quando il dispositivo non è più in uso, è necessario chiamare stopLogcat()
.
startLogcat()
e stopLogcat()
in genere non devono essere chiamati quando
in un contesto di chiamata TF, poiché il framework TF avvia e arresta logcat.
UtenteInizio
public boolean startUser (int userId)
Avvia un determinato utente in background se al momento è arrestato. Se l'utente è già in esecuzione in background, questo metodo è un NOOP.
Parametri | |
---|---|
userId |
int : dell'utente con cui iniziare in background |
Ritorni | |
---|---|
boolean |
true se l'utente è stato avviato correttamente in background. |
Lanci | |
---|---|
DeviceNotAvailableException |
UtenteInizio
public boolean startUser (int userId, boolean waitFlag)
Avvia un determinato utente in background se al momento è arrestato. Se l'utente è già in esecuzione in background, questo metodo è un NOOP. È possibile fornire un flag aggiuntivo da attendere che l'operazione abbia effetto.
Parametri | |
---|---|
userId |
int : dell'utente con cui iniziare in background |
waitFlag |
boolean : attenderà che l'utente venga avviato e sbloccato. |
Ritorni | |
---|---|
boolean |
true se l'utente è stato avviato correttamente in background. |
Lanci | |
---|---|
DeviceNotAvailableException |
inizioVisibileUtenteSfondo
public boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)
Avvia un determinato utente in background, visibile sul display specificato (ad esempio, consentendo all'utente per avviare attività in quel display).
NOTA: questo comando non verifica se l'utente esiste, se la visualizzazione è disponibile, device supports such feature
e così via.
Parametri | |
---|---|
userId |
int : dell'utente con cui iniziare in background |
displayId |
int : display su cui l'utente può essere visibile |
waitFlag |
boolean : attenderà che l'utente venga avviato e sbloccato. |
Ritorni | |
---|---|
boolean |
true se l'utente è stato avviato correttamente visibile in background. |
Lanci | |
---|---|
DeviceNotAvailableException |
stopEmulatorOutput
public void stopEmulatorOutput ()
Chiudi ed elimina l'output dell'emulatore.
stopLogcat
public void stopLogcat ()
Interrompi l'acquisizione dell'output di logcat dal dispositivo ed elimina i dati di logcat attualmente salvati.
Non avrà alcun effetto se l'output logcat non viene acquisito.
Utente bloccato
public boolean stopUser (int userId)
Arresta un determinato utente. Se l'utente è già stato interrotto, questo metodo è un NOOP. Impossibile interrompere l'utente corrente e di sistema.
Parametri | |
---|---|
userId |
int : dell'utente da interrompere. |
Ritorni | |
---|---|
boolean |
true se l'utente è stato arrestato correttamente. |
Lanci | |
---|---|
DeviceNotAvailableException |
Utente bloccato
public boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)
Interrompere un determinato utente. È possibile fornire flag aggiuntivi per attendere l'efficacia dell'operazione. e forzare la chiusura dell'utente. Impossibile interrompere l'utente corrente e di sistema.
Parametri | |
---|---|
userId |
int : dell'utente da interrompere. |
waitFlag |
boolean : attenderà finché l'utente non verrà arrestato. |
forceFlag |
boolean : forza l'interruzione dell'utente. |
Ritorni | |
---|---|
boolean |
true se l'utente è stato arrestato correttamente. |
Lanci | |
---|---|
DeviceNotAvailableException |
switchToAdbTcp
public String switchToAdbTcp ()
Passa alla modalità adb-over-tcp sul dispositivo.
Ritorni | |
---|---|
String |
Il numero di serie tcp o null se non è stato possibile cambiare il dispositivo |
Lanci | |
---|---|
DeviceNotAvailableException |
switchToAdbUsb
public boolean switchToAdbUsb ()
Passa al dispositivo in modalità ADB su USB.
Ritorni | |
---|---|
boolean |
true se il trasferimento va a buon fine, false in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
cambiautente
public boolean switchUser (int userId)
Passa a un altro userId con un timeout predefinito. switchUser(int, long)
.
Parametri | |
---|---|
userId |
int |
Ritorni | |
---|---|
boolean |
True se il nuovo userId corrisponde al provider userId. Falso negli altri casi. |
Lanci | |
---|---|
DeviceNotAvailableException |
cambiautente
public boolean switchUser (int userId, long timeout)
Passa a un altro userId con il timeout fornito come scadenza. Tentativo di disattivare il blocco della tastiera dopo che la modifica dell'utente è andata a buon fine.
Parametri | |
---|---|
userId |
int |
timeout |
long : attendere prima di restituire false per cambio utente non riuscito. |
Ritorni | |
---|---|
boolean |
True se il nuovo userId corrisponde al provider userId. Falso negli altri casi. |
Lanci | |
---|---|
DeviceNotAvailableException |
SyncFiles
public boolean syncFiles (File localFileDir, String deviceFilePath)
Sincronizza in modo incrementale i contenuti di una directory di file locale con il dispositivo.
Decide per quali file eseguire il push confrontando i timestamp dei file locali con il telecomando equivalenti. Solo "più recenti" o file inesistenti verranno inviati al dispositivo. Di conseguenza, l'overhead dovrebbe essere relativamente piccolo se il set di file sul dispositivo è già aggiornato.
I file nascosti (i nomi che iniziano con ".") verranno ignorati.
Esempio di utilizzo: syncFiles("/tmp/files", "/sdcard") crea una directory /sdcard/files se non esiste già, e in modo ricorsivo esegue il push dei contenuti di /tmp/files a /sdcard/files.
Parametri | |
---|---|
localFileDir |
File : la directory dei file locali contenente i file di cui eseguire il push in modo ricorsivo. |
deviceFilePath |
String : la radice del percorso assoluto del file di destinazione remota. Tutte le directory in Thos
il percorso del file deve essere leggibile. Ad esempio, push a /data/local/tmp quando adb non è root
non riuscirà |
Ritorni | |
---|---|
boolean |
true se i file sono stati sincronizzati correttamente. false in caso contrario. |
Lanci | |
---|---|
DeviceNotAvailableException |
prendereBugreport
public Bugreport takeBugreport ()
Prendi una segnalazione di bug e restituila all'interno di un oggetto Bugreport
per gestirla. Restituisce null
in caso di problemi. Il file a cui viene fatto riferimento nell'oggetto Bugreport deve essere cancellato tramite Bugreport.close()
.
Ritorni | |
---|---|
Bugreport |
disinstalla il pacchetto
public String uninstallPackage (String packageName)
Disinstalla un pacchetto Android dal dispositivo.
Parametri | |
---|---|
packageName |
String : il pacchetto Android da disinstallare |
Ritorni | |
---|---|
String |
String con un codice di errore o null in caso di esito positivo. |
Lanci | |
---|---|
DeviceNotAvailableException |
disinstallaPacchettoPerUtente
public String uninstallPackageForUser (String packageName, int userId)
Disinstalla un pacchetto Android dal dispositivo per un determinato utente.
Parametri | |
---|---|
packageName |
String : il pacchetto Android da disinstallare |
userId |
int : l'ID utente intero per il quale eseguire la disinstallazione. |
Ritorni | |
---|---|
String |
String con un codice di errore o null in caso di esito positivo. |
Lanci | |
---|---|
DeviceNotAvailableException |
sbloccaDispositivo
public boolean unlockDevice ()
Sblocca il dispositivo se è in stato criptato.
Questo metodo può riavviare il framework, ma non chiameràpostBootSetup()
. Pertanto,
il dispositivo potrebbe non essere completamente pronto per essere testato quando viene restituito questo metodo.
Ritorni | |
---|---|
boolean |
true se l'operazione ha esito positivo o se il dispositivo non è criptato. |
Lanci | |
---|---|
DeviceNotAvailableException |
waitForBootComplete
public boolean waitForBootComplete (long timeOut)
Si blocca finché non viene impostato il flag di completamento dell'avvio del dispositivo.
Parametri | |
---|---|
timeOut |
long : tempo di attesa in msec per l'impostazione del flag |
Ritorni | |
---|---|
boolean |
true se il flag di avvio completato del dispositivo è impostato entro il timeout |
Lanci | |
---|---|
DeviceNotAvailableException |
attesaPerDispositivoDisponibile
public boolean waitForDeviceAvailable ()
Attende che il dispositivo risponda e sia disponibile per i test. Utilizza il timeout predefinito.
Ritorni | |
---|---|
boolean |
True se il dispositivo è disponibile, False se il ripristino è disattivato e non disponibile. |
Lanci | |
---|---|
DeviceNotAvailableException |
attesaPerDispositivoDisponibile
public boolean waitForDeviceAvailable (long waitTime)
Attende che il dispositivo risponda e sia disponibile per i test.
Parametri | |
---|---|
waitTime |
long : tempo di attesa in ms |
Ritorni | |
---|---|
boolean |
True se il dispositivo è disponibile, False se il ripristino è disattivato e non disponibile. |
Lanci | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailableInFetchPath
public boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Attende che il dispositivo risponda e sia disponibile senza considerare il percorso di ripristino.
Parametri | |
---|---|
waitTime |
long |
Ritorni | |
---|---|
boolean |
True se il dispositivo è disponibile, False se non è disponibile. |
Lanci | |
---|---|
DeviceNotAvailableException |
waitForDeviceBootloader
public void waitForDeviceBootloader ()
Si blocca finché il dispositivo non è visibile tramite fastboot. Usa il timeout predefinito.
Lanci | |
---|---|
DeviceNotAvailableException |
attesaPerDispositivoInRecovery
public boolean waitForDeviceInRecovery (long waitTime)
Blocchi per far sì che il dispositivo si trovi in "recupero ADB" (tieni presente che questo è diverso
IDeviceRecovery
).
Parametri | |
---|---|
waitTime |
long : tempo di attesa in ms |
Ritorni | |
---|---|
boolean |
true se il dispositivo avvia il recupero prima della scadenza del tempo.
false in caso contrario |
attesaPerDispositivoInSideload
public boolean waitForDeviceInSideload (long waitTime)
Blocchi per far sì che il dispositivo si trovi in ''adb sideload'' stato
Parametri | |
---|---|
waitTime |
long : tempo di attesa in ms |
Ritorni | |
---|---|
boolean |
true se il dispositivo viene avviato in sideload prima della scadenza del tempo. false
in caso contrario |
attesaPerDispositivoNonDisponibile
public boolean waitForDeviceNotAvailable (long waitTime)
Blocchi per cui il dispositivo non è disponibile, cioè non è presente nell'ADB
Parametri | |
---|---|
waitTime |
long : tempo di attesa in ms |
Ritorni | |
---|---|
boolean |
true se il dispositivo non diventa disponibile prima della scadenza del tempo.
false in caso contrario |
attesaPerDispositivoOnline
public void waitForDeviceOnline ()
Si blocca finché il dispositivo non è visibile tramite ADB. Usa il timeout predefinito
Tieni presente che il dispositivo potrebbe non rispondere necessariamente ai comandi al completamento. Utilizza le funzionalità di
waitForDeviceAvailable()
in alternativa.
Lanci | |
---|---|
DeviceNotAvailableException |
attesaPerDispositivoOnline
public void waitForDeviceOnline (long waitTime)
Si blocca finché il dispositivo non è visibile tramite ADB.
Tieni presente che il dispositivo potrebbe non rispondere necessariamente ai comandi al completamento. Utilizza le funzionalità di
waitForDeviceAvailable()
in alternativa.
Parametri | |
---|---|
waitTime |
long : tempo di attesa in ms |
Lanci | |
---|---|
DeviceNotAvailableException |
waitForDeviceShell
public boolean waitForDeviceShell (long waitTime)
Attende che il dispositivo risponda a un comando shell adb di base.
Parametri | |
---|---|
waitTime |
long : tempo di attesa in ms |
Ritorni | |
---|---|
boolean |
true se il dispositivo diventa reattivo prima dello scadere di waitTime. |
Metodi protetti
addExtraConnectionBuilderArgs
protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)
Parametri | |
---|---|
builder |
DefaultConnection.ConnectionBuilder |
buildAdbShellCommand
protected String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)
Crea il comando del sistema operativo per la sessione e gli argomenti della shell adb specificati
Parametri | |
---|---|
command |
String |
forceExitStatusDetection |
boolean |
Ritorni | |
---|---|
String[] |
checkApiLevelAgainst
protected void checkApiLevelAgainst (String feature, int strictMinLevel)
Parametri | |
---|---|
feature |
String |
strictMinLevel |
int |
creaRiavviaDeviceAction
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
Crea un RebootDeviceAction
da utilizzare quando si esegue un'azione di riavvio.
Parametri | |
---|---|
rebootMode |
NativeDevice.RebootMode : una modalità di questo riavvio. |
reason |
String : per questo riavvio. |
Ritorni | |
---|---|
NativeDevice.RebootDeviceAction |
l'elemento RebootDeviceAction creato. |
doAdbRiavvia
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
Esegui un riavvio ADB.
Parametri | |
---|---|
rebootMode |
NativeDevice.RebootMode : una modalità di questo riavvio. |
reason |
String : per questo riavvio. |
Lanci | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableEccezione |
DeviceNotAvailableException |
garantireRuntimePermissionSupported
protected void ensureRuntimePermissionSupported ()
metodo helper per generare un'eccezione se l'autorizzazione di runtime non è supportata
Lanci | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableEccezione |
DeviceNotAvailableException |
getApiLevelSafe
protected int getApiLevelSafe ()
Ritorni | |
---|---|
int |
getRunUtil
protected IRunUtil getRunUtil ()
Ottieni l'istanza RunUtil
da utilizzare.
Ritorni | |
---|---|
IRunUtil |
InizializeConnection
protected void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
Parametri | |
---|---|
info |
IBuildInfo |
attributes |
MultiMap |
Lanci | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
internalGetProperty
protected String internalGetProperty (String propName, String fastbootVar, String description)
Recupera una proprietà del dispositivo dalla cache di ddmlib per impostazione predefinita e utilizza sia "adb" shell getprop" o "fastboot getvar" a seconda che il dispositivo sia in Fastboot o meno.
Parametri | |
---|---|
propName |
String : il nome della proprietà del dispositivo restituito da "adb shell getprop" |
fastbootVar |
String : il nome della variabile fastboot equivalente su cui eseguire la query. se null ,
non verrà eseguito alcun tentativo di query fastboot |
description |
String : una semplice descrizione della variabile. La prima lettera deve essere maiuscola. |
Ritorni | |
---|---|
String |
Una stringa, probabilmente null o vuota, contenente il valore della proprietà specificata |
Lanci | |
---|---|
DeviceNotAvailableException |
èInRiavviaCallback
protected boolean isInRebootCallback ()
Indica se i callback di riavvio sono attualmente in esecuzione o meno. Tutte le API pubbliche per Se il valore è true, il riavvio deve essere disattivato.
Ritorni | |
---|---|
boolean |
èPiù recente
protected boolean isNewer (File localFile, IFileEntry entry)
Restituisci true
se il file locale è più recente del file remoto. IFileEntry
in corso
al minuto, in caso di numero uguale, il file sarà considerato più recente.
Parametri | |
---|---|
localFile |
File |
entry |
IFileEntry |
Ritorni | |
---|---|
boolean |
notificaRiavvioTerminato
protected void notifyRebootEnded ()
Invia notifiche a IDeviceActionReceiver
relative all'evento di fine del riavvio.
Lanci | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableEccezione |
DeviceNotAvailableException |
notificaRiavviaAvviato
protected void notifyRebootStarted ()
Invia notifiche a tutti i IDeviceActionReceiver
circa l'evento di avvio del riavvio.
Lanci | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableEccezione |
DeviceNotAvailableException |
performDeviceAction
protected boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Esegue un'azione su questo dispositivo. Tenta di recuperare il dispositivo e, facoltativamente, riprova il comando se non va a buon fine.
Parametri | |
---|---|
actionDescription |
String : una breve descrizione dell'azione da eseguire. Utilizzato per il logging
ai soli scopi. |
action |
NativeDevice.DeviceAction : l'azione da eseguire |
retryAttempts |
int : il nuovo tentativo di eseguire l'azione se non riesce, ma il recupero va a buon fine |
Ritorni | |
---|---|
boolean |
true se l'azione è stata eseguita correttamente |
Lanci | |
---|---|
DeviceNotAvailableException |
se il tentativo di recupero non va a buon fine o il numero massimo di tentativi effettuati senza operazione riuscita |
postAdbRiavvia
protected void postAdbReboot ()
Eventuali azioni aggiuntive che è possibile eseguire dopo un riavvio.
Lanci | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableEccezione |
DeviceNotAvailableException |
Configurazione prePostBoot
protected void prePostBootSetup ()
Consente a ogni tipo di dispositivo (Android NativeDevice, TestDevice) di eseguire l'override di questo metodo per una specifica configurazione post-avvio.
Lanci | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableEccezione |
DeviceNotAvailableException |
pullFileInternal
protected boolean pullFileInternal (String remoteFilePath, File localFile)
Parametri | |
---|---|
remoteFilePath |
String |
localFile |
File |
Ritorni | |
---|---|
boolean |
Lanci | |
---|---|
DeviceNotAvailableException |
impostaOrologio
protected void setClock (Clock clock)
Imposta l'istanza di orologio da utilizzare.
Parametri | |
---|---|
clock |
Clock |
Processo setMicrodroid
protected void setMicrodroidProcess (Process process)
Contrassegna il TestDevice come microdroide e imposta il relativo ID cliente.
Parametri | |
---|---|
process |
Process : processo della VM Microdroid. |
setTestDeviceOptions
protected void setTestDeviceOptions (deviceOptions)
Parametri | |
---|---|
deviceOptions |
|
Comando BasicFastboot
protected CommandResult simpleFastbootCommand (long timeout,envVarMap, String[] fullCmd)
Esegue un semplice comando fastboot con variabili di ambiente e segnala lo stato del .
Parametri | |
---|---|
timeout |
long |
envVarMap |
|
fullCmd |
String |
Ritorni | |
---|---|
CommandResult |
Comando BasicFastboot
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
Esegue un semplice comando fastboot e segnala lo stato del comando.
Parametri | |
---|---|
timeout |
long |
fullCmd |
String |
Ritorni | |
---|---|
CommandResult |
attesaPerDispositivoNonDisponibile
protected boolean waitForDeviceNotAvailable (String operationDesc, long time)
Attendi che il dispositivo diventi non disponibile (interrompi la segnalazione ad adb).
Parametri | |
---|---|
operationDesc |
String : il nome dell'operazione in attesa di non disponibile. |
time |
long : il tempo di attesa prima che si verifichi l'azione non disponibile. |
Ritorni | |
---|---|
boolean |
True se il dispositivo non è più disponibile. |