Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Dispositivo di prova

public class TestDevice
extends NativeDevice

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


Implementazione di un ITestDevice per un dispositivo Android full stack

Riepilogo

Classi nidificate

class TestDevice.MicrodroidBuilder

Un builder utilizzato per creare un Microdroid TestDevice.

Campi

public static final String DISMISS_KEYGUARD_CMD

Comandi che possono essere utilizzati per chiudere il keyguard.

Costruttori pubblici

TestDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Metodi pubblici

boolean clearErrorDialogs ()

Tentativo di ignorare eventuali finestre di dialogo di errore attualmente visualizzate sull'interfaccia utente del dispositivo.

int createUser (String name)

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

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

Crea un utente con un nome dato e i flag forniti

int createUserNoThrow (String name)

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

void disableKeyguard ()

Tenta di disabilitare il keyguard.

boolean doesFileExist (String deviceFilePath)

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

boolean doesFileExist (String deviceFilePath, int userId)

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

File dumpHeap (String process, String devicePath)

Tentativo di scaricare l'heap da system_server.

getActiveApexes ()

Recupera le informazioni sugli APEX attivati ​​sul dispositivo.

getAllSettings (String namespace)

Restituisce coppie di valori chiave dello spazio dei nomi richiesto.

String getAndroidId (int userId)

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

getAndroidIds ()

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

PackageInfo getAppPackageInfo (String packageName)

Recupera le informazioni su un pacchetto installato sul dispositivo.

getAppPackageInfos ()

Recupera le informazioni sui pacchetti installati sul dispositivo.

DeviceFoldableState getCurrentFoldableState ()

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

int getCurrentUser ()

Restituisce l'ID dell'utente corrente in esecuzione.

getFoldableStates ()

Restituisce l'elenco degli stati ripiegabili sul dispositivo.

getInstalledPackageNames ()

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

KeyguardControllerState getKeyguardState ()

Restituisce un oggetto per ottenere lo stato corrente del keyguard o null se non supportato.

getMainlineModuleInfo ()

Ottieni le informazioni sui moduli mainline installati sul dispositivo.

int getMaxNumberOfRunningUsersSupported ()

Ottieni il numero massimo di utenti supportati in esecuzione simultanea.

int getMaxNumberOfUsersSupported ()

Ottieni il numero massimo di utenti supportati.

String getMicrodroidCID ()
Integer getPrimaryUserId ()

Restituisce l'ID utente principale.

InputStreamSource getScreenshot ()

Cattura uno screenshot dal dispositivo.

InputStreamSource getScreenshot (String format, boolean rescale)

Cattura uno screenshot dal dispositivo.

InputStreamSource getScreenshot (String format)

Cattura uno screenshot dal dispositivo.

InputStreamSource getScreenshot (long displayId)

Cattura uno screenshot dal dispositivo con ID display.

String getSetting (String namespace, String key)

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

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

Restituisce il valore dell'impostazione richiesta.

getUninstallablePackageNames ()

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

int getUserFlags (int userId)

Trova e restituisci i flag di un determinato utente.

getUserInfos ()

Ottiene la mappa di useId in UserInfo sul dispositivo.

int getUserSerialNumber (int userId)

Restituire il numero di serie associato all'ID utente se trovato, -10000 negli altri casi.

boolean hasFeature (String feature)

Verifica se una funzione è disponibile su un dispositivo.

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

Installa un pacchetto Android sul dispositivo.

String installPackage (File packageFile, File certFile, 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, boolean grantPermissions, int userId, String... extraArgs)

Installa un pacchetto Android sul dispositivo per un determinato utente.

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

Installa un pacchetto Android sul dispositivo per un determinato utente.

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

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

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

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

String installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)

String installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs)

boolean isAppEnumerationSupported ()

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

boolean isMultiUserSupported ()

Determina se il multiutente è supportato.

boolean isPackageInstalled (String packageName)

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

boolean isPackageInstalled (String packageName, String userId)

Esegui una query sul dispositivo per un determinato nome di pacchetto e un determinato ID utente per verificare se è attualmente installato o meno per quell'utente.

boolean isUserRunning (int userId)

Controlla se un determinato utente è in esecuzione.

boolean isUserSecondary (int userId)

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

listDisplayIds ()

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

listUsers ()

Ottiene l'elenco degli utenti sul dispositivo.

void postInvocationTearDown (Throwable exception)

Passaggi aggiuntivi per la pulizia specifica del dispositivo richiesta che verrà eseguita al termine della chiamata.

boolean removeAdmin (String componentName, int userId)

Rimuovere l'amministratore del dispositivo specificato in un determinato utente e restituire true se ha esito positivo, false in caso contrario.

void removeOwners ()

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

boolean removeUser (int userId)

Rimuovere un determinato utente dal dispositivo.

boolean setDeviceOwner (String componentName, int userId)

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

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

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

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

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

void shutdownMicrodroid ( ITestDevice microdroidDevice)

Spegne il dispositivo microdroid, se presente.

boolean startUser (int userId)

Avvia un determinato utente in background se è attualmente interrotto.

boolean startUser (int userId, boolean waitFlag)

Avvia un determinato utente in background se è attualmente interrotto.

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

Arresta un determinato utente.

boolean stopUser (int userId)

Arresta un determinato utente.

boolean supportsMicrodroid ()

Verifica i presupposti per eseguire un microdroid.

boolean supportsMicrodroid (boolean protectedVm)

Verifica i presupposti per eseguire un microdroid.

boolean switchUser (int userId)

Passa a un altro ID utente con un timeout predefinito.

boolean switchUser (int userId, long timeout)

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

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.

Metodi protetti

AaptParser createParser (File appFile)
void doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason)

Esegui un riavvio adb.

long getCheckNewUserSleep ()

Esposto per test.

long getHostCurrentTime ()

Esposto per test

void prePostBootSetup ()

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

Campi

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

Comandi che possono essere utilizzati per chiudere il keyguard.

Costruttori pubblici

Dispositivo di prova

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

Metodi pubblici

clearErrorDialogs

public boolean clearErrorDialogs ()

Tentativo di ignorare eventuali finestre di dialogo di errore attualmente visualizzate sull'interfaccia utente del dispositivo.

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

Tiri
DeviceNotAvailableException

creare un utente

public int createUser (String name)

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

Parametri
name String : dell'utente da creare sul dispositivo

ritorna
int il numero intero per l'ID utente creato

Tiri
DeviceNotAvailableException

creare un utente

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

Crea un utente con un nome dato e i flag forniti

Parametri
name String : dell'utente da creare sul dispositivo

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

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

ritorna
int ID dell'utente creato

Tiri
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

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

Parametri
name String : dell'utente da creare sul dispositivo

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

Tiri
DeviceNotAvailableException

disabilitare Keyguard

public void disableKeyguard ()

Tenta di disabilitare il keyguard.

Aspetta prima che l'invio dell'input sia pronto, questo accade più o meno nello stesso momento in cui il dispositivo segnala BOOT_COMPLETE, apparentemente in modo asincrono, perché l'implementazione del framework attuale ha condizioni di competizione occasionali. Quindi viene inviato il comando per eliminare keyguard (funziona solo su quelli non sicuri)

Tiri
DeviceNotAvailableException

faFileExist

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 controllare

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

Tiri
DeviceNotAvailableException

faFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

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

Tiri
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

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

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

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

ritorna
File l' ERROR(/File) contenente il rapporto. Null se qualcosa non è riuscito.

Tiri
DeviceNotAvailableException

getActiveApex

public  getActiveApexes ()

Recupera le informazioni sugli APEX attivati ​​sul dispositivo.

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

Tiri
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

Restituisce coppie di valori chiave dello spazio dei nomi richiesto.

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

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

Tiri
DeviceNotAvailableException

getAndroidId

public String getAndroidId (int userId)

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

Parametri
userId int

ritorna
String

Tiri
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

Crea una mappa degli ID Android trovati corrispondenti agli ID utente. Non vi è alcuna assicurazione che ogni ID utente troverà un ID Android associato a questa funzione, quindi alcuni ID utente potrebbero corrispondere a null.

ritorna
Mappa degli ID Android trovati ID utente corrispondenti.

Tiri
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Recupera le informazioni su un pacchetto installato sul dispositivo.

Parametri
packageName String

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

Tiri
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

Recupera le informazioni sui pacchetti installati sul dispositivo.

ritorna
ERROR(/List) di PackageInfo s installati sul dispositivo.

Tiri
DeviceNotAvailableException

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

ritorna
DeviceFoldableState

Tiri
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

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

ritorna
int

Tiri
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

Restituisce l'elenco degli stati ripiegabili sul dispositivo. Può essere ottenuto con "cmd device_state print-states".

ritorna

Tiri
DeviceNotAvailableException

getInstalledPackageNames

public  getInstalledPackageNames ()

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

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

Tiri
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Restituisce un oggetto per ottenere lo stato corrente del keyguard o null se non supportato.

ritorna
KeyguardControllerState un KeyguardControllerState contenente uno snapshot dello stato del keyguard e restituisce Null se la query Keyguard non è supportata.

Tiri
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Ottieni le informazioni sui moduli mainline installati sul dispositivo.

ritorna
ERROR(/Set) dei moduli della linea principale String attualmente installati sul dispositivo.

Tiri
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

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

Tiri
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

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

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

Tiri
DeviceNotAvailableException

getMicrodroidCID

public String getMicrodroidCID ()

ritorna
String Restituisce il CID del microdroid vm. Se TestDevice non è un microdroid, restituisce null.

getPrimaryUserId

public Integer getPrimaryUserId ()

Restituisce l'ID utente principale.

ritorna
Integer l'ID utente dell'utente principale, se presente, e null se non esiste un utente principale.

Tiri
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot ()

Cattura uno screenshot dal dispositivo.

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

Tiri
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

Cattura uno screenshot dal dispositivo. Si consiglia di utilizzare getScreenshot(String) invece con la codifica JPEG per dimensioni inferiori.

Parametri
format String : PNG, JPEG supportati

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

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

Tiri
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (String format)

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

Parametri
format String : PNG, JPEG supportati

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

Tiri
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (long displayId)

Cattura uno screenshot dal dispositivo con ID display. Il formato è PNG.

TODO: estendere le implementazioni di cui sopra per supportare "formattazione" e "ridimensionamento"

Parametri
displayId long : l'id di visualizzazione dello schermo da cui ottenere lo screenshot.

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

Tiri
DeviceNotAvailableException

getSetting

public String getSetting (String namespace, 
                String key)

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

Parametri
namespace String

key String

ritorna
String

Tiri
DeviceNotAvailableException

getSetting

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

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

Parametri
userId int

namespace String

key String

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

Tiri
DeviceNotAvailableException

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

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

Tiri
DeviceNotAvailableException

getUserFlags

public int getUserFlags (int userId)

Trova e restituisci i flag di un determinato utente. I flag sono definiti nella classe "android.content.pm.UserInfo" in Android Open Source Project.

Parametri
userId int

ritorna
int i flag associati allo userId fornito se trovato, -10000 negli altri casi.

Tiri
DeviceNotAvailableException

getUserInfos

public  getUserInfos ()

Ottiene la mappa di useId in UserInfo sul dispositivo. DeviceRuntimeException se l'output dal dispositivo non è come previsto.

ritorna
l'elenco degli oggetti UserInfo.

Tiri
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

Restituire il numero di serie associato all'ID utente se trovato, -10000 negli altri casi.

Parametri
userId int

ritorna
int

Tiri
DeviceNotAvailableException

haCaratteristica

public boolean hasFeature (String feature)

Verifica se una funzione è disponibile su un dispositivo.

Parametri
feature String : quale formato dovrebbe essere "feature: " o " "direttamente.

ritorna
boolean Vero se viene trovata una funzione, falso in caso contrario.

Tiri
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 deve essere eseguita una reinstallazione

extraArgs String : argomenti aggiuntivi facoltativi da passare. Vedere 'adb shell pm -h' per le opzioni disponibili.

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

Tiri
DeviceNotAvailableException

installPackage

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

Installa un pacchetto Android sul dispositivo.

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

Parametri
packageFile File : il file apk da installare

certFile File : true se deve essere eseguita una reinstallazione

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

extraArgs String : argomenti aggiuntivi facoltativi da passare. Vedere 'adb shell pm -h' per le opzioni disponibili.

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

Tiri
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 momento dell'installazione devono chiamare questa funzione.

Parametri
packageFile File : il file apk da installare

reinstall boolean : true se deve essere eseguita una reinstallazione

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

extraArgs String : argomenti aggiuntivi facoltativi da passare. Vedere 'adb shell pm -h' per le opzioni disponibili.

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

Tiri
DeviceNotAvailableException

installPackageForUser

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

Installa un pacchetto Android sul dispositivo per un determinato utente.

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

Parametri
packageFile File : il file apk da installare

reinstall boolean : true se deve essere eseguita una reinstallazione

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

userId int : l'ID utente intero per cui installare.

extraArgs String : argomenti aggiuntivi facoltativi da passare. Vedere 'adb shell pm -h' per le opzioni disponibili.

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

Tiri
DeviceNotAvailableException

installPackageForUser

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

Installa un pacchetto Android sul dispositivo per un determinato utente.

Parametri
packageFile File : il file apk da installare

reinstall boolean : true se deve essere eseguita una reinstallazione

userId int : l'ID utente intero per cui installare.

extraArgs String : argomenti aggiuntivi facoltativi da passare. Vedere 'adb shell pm -h' per le opzioni disponibili.

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

Tiri
DeviceNotAvailableException

installPackages

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

Parametri
packageFiles

reinstall boolean

extraArgs String

ritorna
String

Tiri
DeviceNotAvailableException

installPackages

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

Parametri
packageFiles

reinstall boolean

grantPermissions boolean

extraArgs String

ritorna
String

Tiri
DeviceNotAvailableException

installPackagesForUser

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

Parametri
packageFiles

reinstall boolean

grantPermissions boolean

userId int

extraArgs String

ritorna
String

Tiri
DeviceNotAvailableException

installPackagesForUser

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

Parametri
packageFiles

reinstall boolean

userId int

extraArgs String

ritorna
String

Tiri
DeviceNotAvailableException

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Parametri
remoteApkPaths

reinstall boolean

grantPermissions boolean

extraArgs String

ritorna
String

Tiri
DeviceNotAvailableException

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                String... extraArgs)

Parametri
remoteApkPaths

reinstall boolean

extraArgs String

ritorna
String

Tiri
DeviceNotAvailableException

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

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

ritorna
boolean True se l'enumerazione dell'app è supportata, false in caso contrario

Tiri
DeviceNotAvailableException

isMultiUserSupported

public boolean isMultiUserSupported ()

Determina se il multiutente è supportato.

ritorna
boolean true se multiutente è supportato, false in caso contrario

Tiri
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName)

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

Parametri
packageName String

ritorna
boolean True se il pacchetto viene segnalato come installato. Falso altrimenti.

Tiri
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

Esegui una query sul dispositivo per un determinato nome di pacchetto e un determinato ID utente per verificare se è attualmente installato o meno per quell'utente.

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

userId String : l'ID utente per cui stiamo controllando il pacchetto è installato. Se null, verrà utilizzato l'utente primario zero.

ritorna
boolean True se il pacchetto viene segnalato come installato. Falso altrimenti.

Tiri
DeviceNotAvailableException

isUserRunning

public boolean isUserRunning (int userId)

Controlla se un determinato utente è in esecuzione.

Parametri
userId int

ritorna
boolean True se l'utente è in esecuzione, false in tutti gli altri casi.

Tiri
DeviceNotAvailableException

isUserSecondary

public boolean isUserSecondary (int userId)

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

Parametri
userId int

ritorna
boolean true se l'utente è secondario, false in caso contrario.

Tiri
DeviceNotAvailableException

listDisplayIds

public  listDisplayIds ()

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

ritorna
L'elenco dei display. Predefinito restituisce sempre la visualizzazione predefinita 0.

Tiri
DeviceNotAvailableException

listUsers

public  listUsers ()

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

ritorna
l'elenco degli ID utente.

Tiri
DeviceNotAvailableException

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

Passaggi aggiuntivi per la pulizia specifica del dispositivo richiesta che verrà eseguita al termine della chiamata.

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

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

Rimuovere l'amministratore del dispositivo specificato in un determinato utente e restituire true se ha esito positivo, false in caso contrario.

Parametri
componentName String : dell'amministratore del dispositivo da rimuovere.

userId int : dell'utente in cui risiede l'amministratore del dispositivo.

ritorna
boolean Vero se ha successo, falso in caso contrario.

Tiri
DeviceNotAvailableException

rimuovereProprietari

public void removeOwners ()

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

Tiri
DeviceNotAvailableException

removeUser

public boolean removeUser (int userId)

Rimuovere un determinato utente dal dispositivo.

Parametri
userId int : dell'utente da rimuovere

ritorna
boolean true se siamo riusciti a rimuovere l'utente, false in caso contrario.

Tiri
DeviceNotAvailableException

setDeviceOwner

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 del dispositivo.

userId int : dell'utente in cui risiede il proprietario del dispositivo.

ritorna
boolean Vero se ha successo, falso in caso contrario.

Tiri
DeviceNotAvailableException

setSetting

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

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

Parametri
namespace String

key String

value String

Tiri
DeviceNotAvailableException

setSetting

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 di: {"system", "secure", "global"}

Parametri
userId int

namespace String

key String

value String

Tiri
DeviceNotAvailableException

spegnimentoMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

Spegne il dispositivo microdroid, se presente.

Parametri
microdroidDevice ITestDevice

Tiri
DeviceNotAvailableException

startUser

public boolean startUser (int userId)

Avvia un determinato utente in background se è attualmente interrotto. Se l'utente è già in esecuzione in background, questo metodo è un NOOP.

Parametri
userId int : dell'utente per iniziare in background

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

Tiri
DeviceNotAvailableException

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

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

Parametri
userId int : dell'utente per iniziare in background

waitFlag boolean : farà attendere il comando fino a quando l'utente non viene avviato e sbloccato.

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

Tiri
DeviceNotAvailableException

stopUser

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

Arresta un determinato utente. È possibile fornire flag aggiuntivi per attendere che l'operazione abbia effetto e forzare la chiusura dell'utente. Impossibile arrestare l'utente corrente e di sistema.

Parametri
userId int : dell'utente da interrompere.

waitFlag boolean : farà attendere il comando fino all'arresto dell'utente.

forceFlag boolean : forzerà l'arresto dell'utente.

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

Tiri
DeviceNotAvailableException

stopUser

public boolean stopUser (int userId)

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

Parametri
userId int : dell'utente da interrompere.

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

Tiri
DeviceNotAvailableException

supportaMicrodroid

public boolean supportsMicrodroid ()

Verifica i presupposti per eseguire un microdroid.

ritorna
boolean restituisce true se le precondizioni sono soddisfatte, false in caso contrario.

supportaMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

Verifica i presupposti per eseguire un microdroid.

Parametri
protectedVm boolean : true se il microdroid deve essere eseguito su una macchina virtuale protetta.

ritorna
boolean restituisce true se le precondizioni sono soddisfatte, false in caso contrario.

cambia utente

public boolean switchUser (int userId)

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

Parametri
userId int

ritorna
boolean True se il nuovo userId corrisponde al provider userId. Falso altrimenti.

Tiri
DeviceNotAvailableException

cambia utente

public boolean switchUser (int userId, 
                long timeout)

Passa a un altro ID utente con il timeout fornito come scadenza. Tentativo di disabilitare Keyguard dopo che la modifica dell'utente è andata a buon fine.

Parametri
userId int

timeout long : attendere prima di restituire false per switch-user non riuscito.

ritorna
boolean True se il nuovo userId corrisponde al provider userId. Falso altrimenti.

Tiri
DeviceNotAvailableException

uninstallPackage

public String uninstallPackage (String packageName)

Disinstalla un pacchetto Android dal dispositivo.

Parametri
packageName String : il pacchetto Android da disinstallare

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

Tiri
DeviceNotAvailableException

uninstallPackageForUser

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 cui disinstallare.

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

Tiri
DeviceNotAvailableException

Metodi protetti

createParser

protected AaptParser createParser (File appFile)

Parametri
appFile File

ritorna
AaptParser

doAdbReboot

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.

Tiri
DeviceNotAvailableException

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

Esposto per test.

ritorna
long

getHostCurrentTime

protected long getHostCurrentTime ()

Esposto per test

ritorna
long

prePostBootSetup

protected void prePostBootSetup ()

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

Tiri
DeviceNotAvailableException