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 disattivare lo scudo tastiera. |
Metodi pubblici |
---|
boolean | canSwitchToHeadlessSystemUser () Restituisce se è consentito passare all'utente SYSTEM senza testa. |
boolean | clearErrorDialogs () Tentare di eliminare eventuali finestre di dialogo di errore attualmente visualizzate sull'interfaccia utente del dispositivo. |
int | createUser (String name) Crea un utente con un determinato nome e flag predefiniti 0. |
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, boolean guest, boolean ephemeral) Crea un utente con un determinato nome e i flag forniti |
int | createUserNoThrow (String name) Crea un utente con un determinato nome e flag predefiniti 0. |
void | disableKeyguard () Tenta di disattivare lo scudo tastiera. |
boolean | doesFileExist (String deviceFilePath) Metodo di supporto per determinare se esiste un file 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 chiave-valore dello spazio dei nomi richiesto. |
String | getAndroidId (int userId) Trova e restituisce l'ID Android associato a un userId, null se non trovato. |
| getAndroidIds () Crea una mappa degli ID Android trovati corrispondenti agli ID utente. |
PackageInfo | getAppPackageInfo (String packageName) Recupera informazioni su un pacchetto installato sul dispositivo. |
| getAppPackageInfos () Recupera le informazioni sui pacchetti installati sul dispositivo. |
InputStreamSource | getBugreport () Recupera una segnalazione di bug dal dispositivo. |
InputStreamSource | getBugreportz () Recupera una segnalazione di bug dal dispositivo. |
DeviceFoldableState | getCurrentFoldableState () Restituisce lo stato pieghevole corrente del dispositivo o null se si sono verificati alcuni problemi. |
int | getCurrentUser () Restituisce l'id dell'utente attualmente in esecuzione. |
| getFoldableStates () Restituisce l'elenco degli stati pieghevoli nel dispositivo. |
| getInstalledPackageNames () Recupera i nomi dei pacchetti dell'applicazione presenti sul dispositivo. |
KeyguardControllerState | getKeyguardState () Restituisce un oggetto per ottenere lo stato corrente dello scudo tastiera o null se non supportato. |
Integer | getMainUserId () Restituisce l'ID utente principale. |
| getMainlineModuleInfo () Ottieni informazioni sui moduli della linea principale installati sul dispositivo. |
int | getMaxNumberOfRunningUsersSupported () Ottieni il numero massimo di utenti supportati con esecuzione simultanea. |
int | getMaxNumberOfUsersSupported () Ottieni il numero massimo di utenti supportati. |
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 a cui è stato fornito l'ID di visualizzazione. |
String | getSetting (String namespace, String key) Vedere getSetting(int, String, String) ed eseguito sull'utente del 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 restituisce i flag di un determinato utente. |
| getUserInfos () Ottiene la mappa di useId in UserInfo nel dispositivo. |
int | getUserSerialNumber (int userId) Restituisce il numero seriale associato allo userId se trovato, -10000 negli altri casi. |
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 | installPackage (File packageFile, File certFile, boolean reinstall, 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, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) |
String | installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) |
boolean | isAppEnumerationSupported () Controlla se la piattaforma sul dispositivo supporta l'enumerazione delle app |
boolean | isHeadlessSystemUserMode () Restituisce se il dispositivo utilizza la modalità utente del sistema headless. |
boolean | isMainUserPermanentAdmin () Indica se l'utente principale è un amministratore permanente e non può essere eliminato o declassato allo stato non amministratore. |
boolean | isMultiUserSupported () Determina se è supportato il multiutente. |
boolean | isPackageInstalled (String packageName) Interroga il dispositivo per un determinato nome di pacchetto per verificare se è attualmente installato o meno. |
boolean | isPackageInstalled (String packageName, String userId) Interroga il dispositivo per un determinato nome di pacchetto e un determinato ID utente per verificare se è attualmente installato o meno per quell'utente. |
boolean | isUserRunning (int userId) Controlla se un determinato utente è in esecuzione. |
boolean | isUserSecondary (int userId) Restituisce se l'utente specificato è un utente secondario in base ai suoi flag. |
boolean | isUserVisible (int userId) Controlla se l'utente specificato è visibile. |
boolean | isUserVisibleOnDisplay (int userId, int displayId) Controlla se l'utente specificato è visibile nel display specificato. |
boolean | isVisibleBackgroundUsersOnDefaultDisplaySupported () Restituisce se il dispositivo consente agli utenti di essere avviati in modo visibile in background in ERROR(/java.android.view.Display#DEFAULT_DISPLAY) . |
boolean | isVisibleBackgroundUsersSupported () Indica se il dispositivo consente agli utenti di essere avviati in modo visibile in background. |
| listDisplayIds () Raccogli l'elenco degli ID display disponibili sul dispositivo come riportato da "dumpsys SurfaceFlinger". |
| listDisplayIdsForStartingVisibleBackgroundUsers () Ottiene l'elenco delle visualizzazioni che possono essere utilizzate per start a user visible in the background . |
| listUsers () Ottiene l'elenco degli utenti nel dispositivo. |
boolean | logBugreport (String dataName, ITestLogger listener) Metodo di supporto per acquisire una segnalazione di bug e registrarla per i reporter. |
void | notifySnapuserd ( SnapuserdWaitPhase waitPhase) |
void | postInvocationTearDown (Throwable exception) Passaggi aggiuntivi per la pulizia richiesta specifica del dispositivo che verranno eseguiti al termine della chiamata. |
boolean | removeAdmin (String componentName, int userId) Rimuovi l'amministratore del dispositivo in un determinato utente e restituisci true se l'operazione ha esito positivo, false altrimenti. |
void | removeOwners () Rimuovi tutti i proprietari di profili dispositivo esistenti con il massimo sforzo. |
boolean | removeUser (int userId) Rimuovi un determinato utente dal dispositivo. |
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 ne esiste uno. |
boolean | startUser (int userId) Avvia un determinato utente in background se è attualmente arrestato. |
boolean | startUser (int userId, boolean waitFlag) Avvia un determinato utente in background se è attualmente arrestato. |
boolean | startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag) Avvia un determinato utente in background, visibile in un determinato display (ovvero, consentendo all'utente di avviare attività in quel display). |
boolean | stopUser (int userId, boolean waitFlag, boolean forceFlag) Arresta un determinato utente. |
boolean | stopUser (int userId) Arresta un determinato utente. |
boolean | supportsMicrodroid () Controlla i prerequisiti per eseguire un microdroid. |
boolean | supportsMicrodroid (boolean protectedVm) Controlla 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. |
Bugreport | takeBugreport () Prende una segnalazione di bug e la restituisce all'interno di un oggetto Bugreport per gestirla. |
String | uninstallPackage (String packageName) Disinstallare un pacchetto Android dal dispositivo. |
String | uninstallPackageForUser (String packageName, int userId) Disinstalla un pacchetto Android dal dispositivo per un determinato utente. |
void | waitForSnapuserd ( SnapuserdWaitPhase currentPhase) |
Campi
DISMISS_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
Comandi che possono essere utilizzati per disattivare lo scudo tastiera.
Costruttori pubblici
Metodi pubblici
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Restituisce se è consentito passare all'utente SYSTEM senza testa.
clearErrorDialogs
public boolean clearErrorDialogs ()
Tentare di eliminare eventuali finestre di dialogo di errore attualmente visualizzate sull'interfaccia utente del dispositivo.
ritorna |
---|
boolean | true se non erano presenti finestre di dialogo o le finestre di dialogo sono state cancellate correttamente. false altrimenti. |
creare un utente
public int createUser (String name)
Crea un utente con un determinato nome e flag predefiniti 0.
Parametri |
---|
name | String : dell'utente da creare sul dispositivo |
ritorna |
---|
int | il numero intero per l'ID utente creato |
creare un utente
public int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
Crea un utente con un determinato nome e i flag forniti
Parametri |
---|
name | String : dell'utente da creare sul dispositivo |
guest | boolean : abilita il flag utente --guest durante la creazione |
ephemeral | boolean : abilita il flag utente --ephemeral durante la creazione |
forTesting | boolean : abilita il flag di test --for-testing durante la creazione |
ritorna |
---|
int | ID dell'utente creato |
creare un utente
public int createUser (String name,
boolean guest,
boolean ephemeral)
Crea un utente con un determinato nome e i flag forniti
Parametri |
---|
name | String : dell'utente da creare sul dispositivo |
guest | boolean : abilita il flag utente --guest durante la creazione |
ephemeral | boolean : abilita il flag utente --ephemeral durante la creazione |
ritorna |
---|
int | ID dell'utente creato |
createUserNoThrow
public int createUserNoThrow (String name)
Crea un utente con un determinato nome e flag predefiniti 0.
Parametri |
---|
name | String : dell'utente da creare sul dispositivo |
ritorna |
---|
int | il numero intero per l'ID utente creato o -1 per errore. |
disabilitaKeyguard
public void disableKeyguard ()
Tenta di disattivare lo scudo tastiera.
Per prima cosa attendi che l'invio dell'input sia pronto, ciò avviene più o meno nello stesso momento in cui il dispositivo segnala BOOT_COMPLETE, apparentemente in modo asincrono, perché l'attuale implementazione del framework presenta condizioni di competizione occasionali. Quindi viene inviato il comando per rimuovere lo scudo tastiera (funziona solo su quelli non sicuri)
faFileExist
public boolean doesFileExist (String deviceFilePath)
Metodo di supporto per determinare se esiste un file sul dispositivo.
Parametri |
---|
deviceFilePath | String : il percorso assoluto del file sul dispositivo da controllare |
ritorna |
---|
boolean | true se il file esiste, false altrimenti. |
faFileExist
public boolean doesFileExist (String deviceFilePath,
int userId)
Metodo di supporto per determinare se esiste un file sul dispositivo per un determinato utente.
Parametri |
---|
deviceFilePath | String : il percorso assoluto del file sul dispositivo da controllare |
userId | int : l'ID utente rispetto al quale verificare l'esistenza del file |
ritorna |
---|
boolean | true se il file esiste, false altrimenti. |
dumpHeap
public File dumpHeap (String process,
String devicePath)
Tentativo di scaricare l'heap da system_server. È responsabilità del chiamante ripulire il file scaricato.
Parametri |
---|
process | String : il nome del processo del dispositivo su cui eseguire il dumpheap. |
devicePath | String : il percorso sul dispositivo in cui inserire il dump. Deve trattarsi di una posizione in cui le autorizzazioni lo consentono. |
ritorna |
---|
File | l' ERROR(/File) contenente il rapporto. Null se qualcosa fallisce. |
getActiveApex
public getActiveApexes ()
Recupera le informazioni sugli APEX attivati sul dispositivo.
getAllSettings
public getAllSettings (String namespace)
Restituisce coppie chiave-valore dello spazio dei nomi richiesto.
Parametri |
---|
namespace | String : deve essere una tra {"system", "secure", "global"} |
ritorna |
---|
| la mappa delle coppie chiave-valore. Null se lo spazio dei nomi non è supportato. |
getAndroidId
public String getAndroidId (int userId)
Trova e restituisce l'ID Android associato a un userId, null se non trovato.
getAndroidId
public getAndroidIds ()
Crea una mappa degli ID Android trovati corrispondenti agli ID utente. Non vi è alcuna garanzia che ciascun ID utente trovi un ID Android associato a questa funzione, quindi alcuni ID utente potrebbero corrispondere a null.
ritorna |
---|
| Mappa degli ID Android trovati corrispondenti agli ID utente. |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Recupera informazioni su un pacchetto installato sul dispositivo.
Parametri |
---|
packageName | String |
getAppPackageInfos
public getAppPackageInfos ()
Recupera le informazioni sui pacchetti installati sul dispositivo.
getBugrereport
public InputStreamSource getBugreport ()
Recupera una segnalazione di bug dal dispositivo.
L'implementazione di questo garantisce che continui a funzionare su un dispositivo senza scheda SD (o dove la scheda SD non è ancora montata).
getBugreportz
public InputStreamSource getBugreportz ()
Recupera una segnalazione di bug dal dispositivo. Il bugreport in formato zip contiene il bugreport principale e altri file di registro utili per il debug.
Supportato solo per la 'versione adb' > 1.0.36
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Restituisce lo stato pieghevole corrente del dispositivo o null se si sono verificati alcuni problemi.
getCurrentUser
public int getCurrentUser ()
Restituisce l'id dell'utente attualmente in esecuzione. In caso di errore, restituisce -10000.
getFoldableStates
public getFoldableStates ()
Restituisce l'elenco degli stati pieghevoli nel dispositivo. Può essere ottenuto con "cmd device_state print-states".
getInstalledPackageNames
public getInstalledPackageNames ()
Recupera i nomi dei pacchetti dell'applicazione presenti sul dispositivo.
ritorna |
---|
| ERROR(/Set) di nomi di pacchetti String attualmente installati sul dispositivo. |
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Restituisce un oggetto per ottenere lo stato corrente dello scudo tastiera o null se non supportato.
getIdUtenteMain
public Integer getMainUserId ()
Restituisce l'ID utente principale.
ritorna |
---|
Integer | l'ID utente dell'utente principale, se presente, e null se non è presente alcun utente principale. |
getMainlineModuleInfo
public getMainlineModuleInfo ()
Ottieni informazioni sui moduli della linea principale installati sul dispositivo.
ritorna |
---|
| ERROR(/Set) di moduli della linea principale String attualmente installati sul dispositivo. |
public int getMaxNumberOfRunningUsersSupported ()
Ottieni il numero massimo di utenti supportati con esecuzione simultanea. Il valore predefinito è 0.
ritorna |
---|
int | un numero intero che indica il numero di utenti in esecuzione contemporaneamente |
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 |
getPrimaryUserId
public Integer getPrimaryUserId ()
Restituisce l'ID utente principale.
ritorna |
---|
Integer | l'ID utente dell'utente primario, se presente, e null se non è presente alcun utente primario. |
getScreenshot
public InputStreamSource getScreenshot ()
Cattura uno screenshot dal dispositivo.
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 la dimensione dell'immagine risultante |
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 |
getScreenshot
public InputStreamSource getScreenshot (long displayId)
Cattura uno screenshot dal dispositivo a cui è stato fornito l'ID di visualizzazione. 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. |
getSetting
public String getSetting (String namespace,
String key)
Vedere getSetting(int, String, String)
ed eseguito sull'utente del sistema.
Parametri |
---|
namespace | String |
key | String |
getSetting
public String getSetting (int userId,
String namespace,
String key)
Restituisce il valore dell'impostazione richiesta. lo spazio dei nomi deve essere uno tra: {"system", "secure", "global"}
Parametri |
---|
userId | int |
namespace | String |
key | String |
ritorna |
---|
String | il valore associato al namespace:key di un utente. Null se non trovato. |
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. |
getUserFlags
public int getUserFlags (int userId)
Trova e restituisce i flag di un determinato utente. I flag sono definiti nella classe "android.content.pm.UserInfo" nel progetto Android Open Source.
ritorna |
---|
int | i flag associati allo userId fornito se trovato, -10000 in tutti gli altri casi. |
getUserInfos
public getUserInfos ()
Ottiene la mappa di useId in UserInfo
nel dispositivo. Lancerà DeviceRuntimeException
se l'output dal dispositivo non è quello previsto.
ritorna |
---|
| l'elenco degli oggetti UserInfo. |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Restituisce il numero seriale associato allo userId se trovato, -10000 negli altri casi.
hasFeature
public boolean hasFeature (String feature)
Controlla se una funzionalità è disponibile su un dispositivo.
Parametri |
---|
feature | String : quale formato dovrebbe essere "funzione: " O " "direttamente. |
ritorna |
---|
boolean | Vero se viene trovata la funzionalità, falso altrimenti. |
installPacchetto
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 opzionali da passare. Vedi "adb shell pm -h" per le opzioni disponibili. |
ritorna |
---|
String | una String con un codice di errore o null in caso di successo. |
installPacchetto
public String installPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Installa un pacchetto Android sul dispositivo.
Nota: solo i casi d'uso che richiedono il controllo esplicito della concessione dell'autorizzazione di runtime al momento dell'installazione dovrebbero chiamare questa funzione.
Parametri |
---|
packageFile | File : il file apk da installare |
reinstall | boolean : true se è necessario eseguire una reinstallazione |
grantPermissions | boolean : se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione |
extraArgs | String : argomenti aggiuntivi opzionali da passare. Vedi "adb shell pm -h" per le opzioni disponibili. |
ritorna |
---|
String | una String con un codice di errore o null in caso di successo. |
installPacchetto
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 dovrebbero chiamare questa funzione.
Parametri |
---|
packageFile | File : il file apk da installare |
certFile | File : true se è necessario eseguire una reinstallazione |
reinstall | boolean : se tutte le autorizzazioni di runtime devono essere concesse al momento dell'installazione |
extraArgs | String : argomenti aggiuntivi opzionali da passare. Vedi "adb shell pm -h" per le opzioni disponibili. |
ritorna |
---|
String | una String con un codice di errore o null in caso di successo. |
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 dovrebbero 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 cui eseguire l'installazione. |
extraArgs | String : argomenti aggiuntivi opzionali da passare. Vedi "adb shell pm -h" per le opzioni disponibili. |
ritorna |
---|
String | una String con un codice di errore o null in caso di successo. |
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 è necessario eseguire una reinstallazione |
userId | int : l'ID utente intero per cui effettuare l'installazione. |
extraArgs | String : argomenti aggiuntivi opzionali da passare. Vedi "adb shell pm -h" per le opzioni disponibili. |
ritorna |
---|
String | una String con un codice di errore o null in caso di successo. |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
Parametri |
---|
packageFiles | |
reinstall | boolean |
extraArgs | String |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Parametri |
---|
packageFiles | |
reinstall | boolean |
grantPermissions | boolean |
extraArgs | String |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Parametri |
---|
packageFiles | |
reinstall | boolean |
grantPermissions | boolean |
userId | int |
extraArgs | String |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
Parametri |
---|
packageFiles | |
reinstall | boolean |
userId | int |
extraArgs | String |
installareRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
Parametri |
---|
remoteApkPaths | |
reinstall | boolean |
extraArgs | String |
installareRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Parametri |
---|
remoteApkPaths | |
reinstall | boolean |
grantPermissions | boolean |
extraArgs | String |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Controlla se la piattaforma sul dispositivo supporta l'enumerazione delle app
ritorna |
---|
boolean | Vero se l'enumerazione dell'app è supportata, falso in caso contrario |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Restituisce se il dispositivo utilizza la modalità utente del sistema headless.
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Indica se l'utente principale è un amministratore permanente e non può essere eliminato o declassato allo stato non amministratore.
è multiutente supportato
public boolean isMultiUserSupported ()
Determina se è supportato il multiutente.
ritorna |
---|
boolean | true se è supportato il multiutente, false altrimenti |
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 | Vero se il pacchetto viene segnalato come installato. Falso altrimenti. |
isPackageInstalled
public boolean isPackageInstalled (String packageName,
String userId)
Interroga il dispositivo per un determinato nome di pacchetto e un determinato ID utente per verificare se è attualmente installato o meno per quell'utente.
Parametri |
---|
packageName | String : il pacchetto che stiamo controllando se è installato. |
userId | String : l'ID utente per il quale stiamo verificando l'installazione del pacchetto. Se null, verrà utilizzato l'utente primario zero. |
ritorna |
---|
boolean | Vero se il pacchetto viene segnalato come installato. Falso altrimenti. |
isUserRunning
public boolean isUserRunning (int userId)
Controlla se un determinato utente è in esecuzione.
ritorna |
---|
boolean | Vero se l'utente è in esecuzione, falso in tutti gli altri casi. |
isUserSecondary
public boolean isUserSecondary (int userId)
Restituisce se l'utente specificato è un utente secondario in base ai suoi flag.
ritorna |
---|
boolean | true se l'utente è secondario, false altrimenti. |
isUserVisible
public boolean isUserVisible (int userId)
Controlla se l'utente specificato è visibile.
Un utente "visibile" è un utente che interagisce con l'utente "umano" e quindi è in grado di avviare attività di lancio (in genere nella visualizzazione predefinita).
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId,
int displayId)
Controlla se l'utente specificato è visibile nel display specificato.
Un utente "visibile" è un utente che interagisce con l'utente "umano" e quindi è in grado di avviare attività di lancio in quella visualizzazione.
Parametri |
---|
userId | int |
displayId | int |
listDisplayId
public listDisplayIds ()
Raccogli l'elenco degli ID display disponibili sul dispositivo come riportato da "dumpsys SurfaceFlinger".
ritorna |
---|
| L'elenco dei display. Default restituisce sempre la visualizzazione predefinita 0. |
listDisplayIdsForStartingVisibleBackgroundUsers
public listDisplayIdsForStartingVisibleBackgroundUsers ()
Ottiene l'elenco delle visualizzazioni che possono essere utilizzate per start a user visible in the background
.
listUsers
public listUsers ()
Ottiene l'elenco degli utenti nel dispositivo. Lancerà DeviceRuntimeException
se l'output dal dispositivo non è quello previsto.
ritorna |
---|
| l'elenco degli ID utente. |
logBugreport
public boolean logBugreport (String dataName,
ITestLogger listener)
Metodo di supporto per acquisire una segnalazione di bug e registrarla per i reporter.
Parametri |
---|
dataName | String : nome sotto il quale verrà riportato il bugreport. |
listener | ITestLogger : un ITestLogger per registrare la segnalazione di bug. |
ritorna |
---|
boolean | Vero se la registrazione ha avuto esito positivo, falso altrimenti. |
notifica Snapuserd
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
Parametri |
---|
waitPhase | SnapuserdWaitPhase |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Passaggi aggiuntivi per la pulizia richiesta specifica del dispositivo che verranno eseguiti al termine della chiamata.
Parametri |
---|
exception | Throwable : se presente, l'eccezione finale sollevata dal fallimento dell'invocazione. |
rimuoviAdmin
public boolean removeAdmin (String componentName,
int userId)
Rimuovi l'amministratore del dispositivo in un determinato utente e restituisci true
se l'operazione ha esito positivo, false
altrimenti.
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 altrimenti. |
rimuoviProprietari
public void removeOwners ()
Rimuovi tutti i proprietari di profili dispositivo esistenti con il massimo sforzo.
rimuoviUser
public boolean removeUser (int userId)
Rimuovi un determinato utente dal dispositivo.
Parametri |
---|
userId | int : dell'utente da rimuovere |
ritorna |
---|
boolean | true se siamo riusciti a rimuovere l'utente, false altrimenti. |
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 : l'amministratore del dispositivo deve essere il proprietario del dispositivo. |
userId | int : dell'utente in cui vive il proprietario del dispositivo. |
ritorna |
---|
boolean | Vero se ha successo, falso altrimenti. |
setImpostazione
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 |
setImpostazione
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 tra: {"system", "secure", "global"}
Parametri |
---|
userId | int |
namespace | String |
key | String |
value | String |
shutdownMicrodroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
Spegne il dispositivo microdroid, se ne esiste uno.
Parametri |
---|
microdroidDevice | ITestDevice |
startUser
public boolean startUser (int userId)
Avvia un determinato utente in background se è attualmente arrestato. Se l'utente è già in esecuzione in background, questo metodo è un NOOP.
Parametri |
---|
userId | int : dell'utente da avviare in background |
ritorna |
---|
boolean | true se l'utente è stato avviato correttamente in background. |
startUser
public boolean startUser (int userId,
boolean waitFlag)
Avvia un determinato utente in background se è attualmente arrestato. 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 da avviare in background |
waitFlag | boolean : farà attendere il comando fino all'avvio e allo sblocco dell'utente. |
ritorna |
---|
boolean | true se l'utente è stato avviato correttamente in background. |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Avvia un determinato utente in background, visibile in un determinato display (ovvero, consentendo all'utente di avviare attività in quel display).
NOTA: questo comando non controlla se l'utente esiste, il display è disponibile, device supports such feature
, ecc.
Parametri |
---|
userId | int : dell'utente da avviare in background |
displayId | int : display su cui avviare l'utente visibile |
waitFlag | boolean : farà attendere il comando fino all'avvio e allo sblocco dell'utente. |
ritorna |
---|
boolean | true se l'utente è stato avviato correttamente visibile in background. |
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. |
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. |
supportaMicrodroid
public boolean supportsMicrodroid ()
Controlla i prerequisiti per eseguire un microdroid.
ritorna |
---|
boolean | restituisce vero se le precondizioni sono soddisfatte, falso altrimenti. |
supportaMicrodroid
public boolean supportsMicrodroid (boolean protectedVm)
Controlla i prerequisiti per eseguire un microdroid.
Parametri |
---|
protectedVm | boolean : vero se microdroid è destinato a funzionare su VM protetta. |
ritorna |
---|
boolean | restituisce vero se le precondizioni sono soddisfatte, falso altrimenti. |
cambia utente
public boolean switchUser (int userId)
Passa a un altro ID utente con un timeout predefinito. switchUser(int, long)
.
ritorna |
---|
boolean | Vero se il nuovo userId corrisponde al provider userId. Falso altrimenti. |
cambia utente
public boolean switchUser (int userId,
long timeout)
Passa a un altro ID utente con il timeout fornito come scadenza. Tentativo di disattivare lo scudo tastiera dopo che la modifica dell'utente è riuscita.
Parametri |
---|
userId | int |
timeout | long : attendere prima di restituire false per il cambio utente non riuscito. |
ritorna |
---|
boolean | Vero se il nuovo userId corrisponde al provider userId. Falso altrimenti. |
takeBugrereport
public Bugreport takeBugreport ()
Prende una segnalazione di bug e la restituisce all'interno di un oggetto Bugreport
per gestirla. Restituisce null in caso di problemi. Il file a cui si fa riferimento nell'oggetto Bugreport deve essere pulito tramite Bugreport.close()
.
uninstallPackage
public String uninstallPackage (String packageName)
Disinstallare 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 successo. |
disinstallarePackageForUser
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 eseguire la disinstallazione. |
ritorna |
---|
String | una String con un codice di errore o null in caso di successo. |
waitForSnauserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
Parametri |
---|
currentPhase | SnapuserdWaitPhase |
Metodi protetti
createParser
protected AaptParser createParser (File appFile)
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. |
getBugreportzInternal
protected File getBugreportzInternal ()
Metodo di supporto interno per ottenere il file zip bugreportz come ERROR(/File)
.
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
Esposto per test.
getHostCurrentTime
protected long getHostCurrentTime ()
Esposto per test
prePostBootSetup
protected void prePostBootSetup ()
Consente a ciascun tipo di dispositivo (AndroidNativeDevice, TestDevice) di sovrascrivere questo metodo per una specifica configurazione post-avvio.
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2024-04-02 UTC.
[]
[]
{
"last_modified": "Ultimo aggiornamento 2024-04-02 UTC.",
"state": ""
}