Riprova i comandi del dispositivo per un importo configurabile e fornisce un'interfaccia di ripristino del dispositivo per i dispositivi che non rispondono.
Classi nidificate |
---|
class | ITestDevice.ApexInfo Una semplice classe struct per memorizzare informazioni su un singolo APEX |
class | ITestDevice.MountPointInfo Una semplice classe struct per memorizzare informazioni su un singolo punto di montaggio |
enum | ITestDevice.RecoveryMode |
Metodi pubblici |
---|
abstract boolean | checkConnectivity () Verifica che il dispositivo disponga di connettività di rete. |
abstract boolean | clearErrorDialogs () Tentativo di ignorare eventuali finestre di dialogo di errore attualmente visualizzate sull'interfaccia utente del dispositivo. |
abstract void | clearLastConnectedWifiNetwork () Cancella l'ultima rete wifi connessa. |
abstract boolean | connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) Si collega a una rete wifi. |
abstract boolean | connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk) Si collega a una rete wifi. |
abstract boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk) Si collega a una rete wifi. |
abstract boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid) Si collega a una rete wifi. |
abstract 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. |
abstract 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. |
abstract int | createUser (String name) Crea un utente con un nome dato e flag predefiniti 0. |
abstract int | createUser (String name, boolean guest, boolean ephemeral) Crea un utente con un nome dato e i flag forniti |
abstract int | createUserNoThrow (String name) Crea un utente con un nome dato e flag predefiniti 0. |
abstract void | disableKeyguard () Tenta di disabilitare il keyguard. |
abstract boolean | disableNetworkMonitor () Disabilita il monitoraggio della rete sul dispositivo. |
abstract boolean | disconnectFromWifi () Si disconnette da una rete wifi. |
abstract boolean | doesFileExist (String deviceFilePath, int userId) Metodo di supporto per determinare se esiste un file sul dispositivo per un determinato utente. |
abstract File | dumpHeap (String process, String devicePath) Tentativo di scaricare l'heap da system_server. |
abstract boolean | enableNetworkMonitor () Abilita il monitoraggio della rete sul dispositivo. |
abstract | getActiveApexes () Recupera le informazioni sugli APEX attivati sul dispositivo. |
abstract | getAllSettings (String namespace) Restituisce coppie di valori chiave dello spazio dei nomi richiesto. |
abstract String | getAndroidId (int userId) Trova e restituisce l'ID Android associato a un ID utente, null se non trovato. |
abstract | getAndroidIds () Crea una mappa degli ID Android trovati corrispondenti agli ID utente. |
abstract PackageInfo | getAppPackageInfo (String packageName) Recupera le informazioni su un pacchetto installato sul dispositivo. |
abstract | getAppPackageInfos () Recupera le informazioni sui pacchetti installati sul dispositivo. |
abstract DeviceFoldableState | getCurrentFoldableState () Restituisce lo stato pieghevole corrente del dispositivo o null se si sono verificati alcuni problemi. |
abstract int | getCurrentUser () Restituisce l'ID dell'utente corrente in esecuzione. |
abstract | getFoldableStates () Restituisce l'elenco degli stati ripiegabili sul dispositivo. |
abstract | getInstalledPackageNames () Recupera i nomi dei pacchetti dell'applicazione presenti sul dispositivo. |
abstract String | getIpAddress () Ottiene l'indirizzo IP del dispositivo. |
abstract KeyguardControllerState | getKeyguardState () Restituisce un oggetto per ottenere lo stato corrente del keyguard o null se non supportato. |
abstract | getMainlineModuleInfo () Ottieni le informazioni sui moduli mainline installati sul dispositivo. |
abstract int | getMaxNumberOfRunningUsersSupported () Ottieni il numero massimo di utenti supportati in esecuzione simultanea. |
abstract int | getMaxNumberOfUsersSupported () Ottieni il numero massimo di utenti supportati. |
abstract TestDeviceOptions | getOptions () Recupera le opzioni di test per il dispositivo. |
abstract Integer | getPrimaryUserId () Restituisce l'ID utente principale. |
abstract InputStreamSource | getScreenshot () Cattura uno screenshot dal dispositivo. |
abstract InputStreamSource | getScreenshot (String format, boolean rescale) Cattura uno screenshot dal dispositivo. |
abstract InputStreamSource | getScreenshot (String format) Cattura uno screenshot dal dispositivo. |
abstract InputStreamSource | getScreenshot (long displayId) Cattura uno screenshot dal dispositivo con ID display. |
abstract String | getSetting (String namespace, String key) Vedere getSetting(int, String, String) ed eseguito sull'utente di sistema. |
abstract String | getSetting (int userId, String namespace, String key) Restituisce il valore dell'impostazione richiesta. |
abstract | getUninstallablePackageNames () Recupera i nomi dei pacchetti dell'applicazione che possono essere disinstallati. |
abstract int | getUserFlags (int userId) Trova e restituisci i flag di un determinato utente. |
abstract | getUserInfos () Ottiene la mappa di useId in UserInfo sul dispositivo. |
abstract int | getUserSerialNumber (int userId) Restituire il numero di serie associato all'ID utente se trovato, -10000 negli altri casi. |
abstract boolean | hasFeature (String feature) Verifica se una funzione è disponibile su un dispositivo. |
abstract String | installPackage (File packageFile, boolean reinstall, String... extraArgs) Installa un pacchetto Android sul dispositivo. |
abstract String | installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Installa un pacchetto Android sul dispositivo. |
abstract String | installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Installa un pacchetto Android sul dispositivo per un determinato utente. |
abstract String | installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs) Installa un pacchetto Android sul dispositivo per un determinato utente. |
default String | installPackages ( packageFiles, boolean reinstall, String... extraArgs) installPackages ( packageFiles, boolean reinstall, String... extraArgs) Installa un'applicazione Android composta da diversi file APK (un pacchetto diviso principale ed extra). |
default String | installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) Installa un'applicazione Android composta da diversi file APK (un pacchetto diviso principale ed extra) che si trovano sul dispositivo Android. |
default String | installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Installa un'applicazione Android composta da diversi file APK (un pacchetto diviso principale ed extra) per un determinato utente. |
default String | installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) Installa un'applicazione Android composta da diversi file APK (un pacchetto diviso principale ed extra) per un determinato utente. |
default String | installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) Installa un'applicazione Android composta da diversi file APK (un pacchetto diviso principale ed extra) che si trovano sul dispositivo Android. |
default String | installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) Installa un'applicazione Android composta da diversi file APK (un pacchetto diviso principale ed extra) che si trovano sul dispositivo Android. |
abstract boolean | isMultiUserSupported () Determina se il multiutente è supportato. |
abstract boolean | isPackageInstalled (String packageName) Interroga il dispositivo per un determinato nome di pacchetto per verificare se è attualmente installato o meno. |
abstract 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. |
abstract boolean | isUserRunning (int userId) Controlla se un determinato utente è in esecuzione. |
abstract boolean | isUserSecondary (int userId) Restituisce se l'utente specificato è un utente secondario in base ai suoi flag. |
abstract boolean | isWifiEnabled () Verifica se il wifi è abilitato. |
abstract | listDisplayIds () Raccogli l'elenco degli ID display disponibili sul dispositivo come riportato da "dumpsys SurfaceFlinger". |
abstract | listUsers () Ottiene l'elenco degli utenti sul dispositivo. |
abstract 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. |
abstract void | removeOwners () Rimuovi tutti i proprietari di profili dispositivo esistenti con il massimo sforzo. |
abstract boolean | removeUser (int userId) Rimuovere un determinato utente dal dispositivo. |
abstract boolean | setDeviceOwner (String componentName, int userId) Imposta un componente di amministrazione del dispositivo come proprietario del dispositivo in un determinato utente. |
abstract void | setSetting (String namespace, String key, String value) Vedere setSetting(int, String, String, String) ed eseguito sull'utente di sistema. |
abstract void | setSetting (int userId, String namespace, String key, String value) Aggiungi un valore di impostazione allo spazio dei nomi di un determinato utente. |
abstract boolean | startUser (int userId) Avvia un determinato utente in background se è attualmente interrotto. |
abstract boolean | startUser (int userId, boolean waitFlag) Avvia un determinato utente in background se è attualmente interrotto. |
abstract boolean | stopUser (int userId, boolean waitFlag, boolean forceFlag) Arresta un determinato utente. |
abstract boolean | stopUser (int userId) Arresta un determinato utente. |
abstract boolean | switchUser (int userId) Passa a un altro ID utente con un timeout predefinito. |
abstract boolean | switchUser (int userId, long timeout) Passa a un altro ID utente con il timeout fornito come scadenza. |
abstract String | uninstallPackage (String packageName) Disinstalla un pacchetto Android dal dispositivo. |
abstract String | uninstallPackageForUser (String packageName, int userId) Disinstalla un pacchetto Android dal dispositivo per un determinato utente. |
Metodi pubblici
checkConnettività
public abstract boolean checkConnectivity ()
Verifica che il dispositivo disponga di connettività di rete.
ritorna |
---|
boolean | true se il dispositivo ha una connessione di rete funzionante, false al contrario. |
clearErrorDialogs
public abstract 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. |
clearLastConnectedWifiNetwork
public abstract void clearLastConnectedWifiNetwork ()
Cancella l'ultima rete wifi connessa. Dovrebbe essere chiamato quando si avvia una nuova chiamata per evitare la connessione alla rete wifi utilizzata nel test precedente dopo il riavvio del dispositivo.
ConnectToWiFiNetwork
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk,
boolean scanSsid)
Si collega a una rete wifi.
Attiva il wifi e si blocca fino a quando non viene stabilita una connessione riuscita con una delle reti wifi fornite nella mappa wifiSsidToPsk. Una volta stabilita una connessione, l'istanza tenterà di ripristinare la connessione dopo ogni riavvio finché non viene chiamato ITestDevice#disconnectFromWifi()
o ITestDevice#clearLastConnectedWifiNetwork()
.
Parametri |
---|
wifiSsidToPsk | : una mappa degli SSID Wi-Fi alle password. |
scanSsid | boolean : se cercare SSID nascosti per questa rete. |
ritorna |
---|
boolean | true se connesso alla rete wifi con successo. false altrimenti |
ConnectToWiFiNetwork
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)
Si collega a una rete wifi.
Attiva il wifi e si blocca fino a quando non viene stabilita una connessione riuscita con una delle reti wifi fornite nella mappa wifiSsidToPsk. Una volta stabilita una connessione, l'istanza tenterà di ripristinare la connessione dopo ogni riavvio finché non viene chiamato ITestDevice#disconnectFromWifi()
o ITestDevice#clearLastConnectedWifiNetwork()
.
Parametri |
---|
wifiSsidToPsk | : una mappa degli SSID Wi-Fi alle password. |
ritorna |
---|
boolean | true se connesso alla rete wifi con successo. false altrimenti |
ConnectToWiFiNetwork
public abstract boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk)
Si collega a una rete wifi.
Attiva il Wi-Fi e si blocca finché non viene stabilita una connessione riuscita alla rete Wi-Fi specificata. Una volta stabilita una connessione, l'istanza tenterà di ripristinare la connessione dopo ogni riavvio finché non viene chiamato
ITestDevice#disconnectFromWifi()
o
ITestDevice#clearLastConnectedWifiNetwork()
.
Parametri |
---|
wifiSsid | String : il ssid wifi a cui connettersi |
wifiPsk | String : passphrase PSK o null se non crittografato |
ritorna |
---|
boolean | true se connesso alla rete wifi con successo. false altrimenti |
ConnectToWiFiNetwork
public abstract boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk,
boolean scanSsid)
Si collega a una rete wifi.
Attiva il Wi-Fi e si blocca finché non viene stabilita una connessione riuscita alla rete Wi-Fi specificata. Una volta stabilita una connessione, l'istanza tenterà di ripristinare la connessione dopo ogni riavvio finché non viene chiamato
ITestDevice#disconnectFromWifi()
o
ITestDevice#clearLastConnectedWifiNetwork()
.
Parametri |
---|
wifiSsid | String : il ssid wifi a cui connettersi |
wifiPsk | String : passphrase PSK o null se non crittografato |
scanSsid | boolean : se cercare SSID nascosto per questa rete. |
ritorna |
---|
boolean | true se connesso alla rete wifi con successo. false altrimenti |
ConnectToWifiNetworkIfNeeded
public abstract 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 SSID nascosto per questa rete |
ritorna |
---|
boolean | true se connesso alla rete wifi con successo. false altrimenti |
ConnectToWifiNetworkIfNeeded
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk)
Una variante di connectToWifiNetwork(String, String)
che si connette solo se il dispositivo attualmente non dispone di connettività di rete.
ritorna |
---|
boolean | true se connesso alla rete wifi con successo. false altrimenti |
creare un utente
public abstract 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 |
creare un utente
public abstract 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 |
createUserNoThrow
public abstract 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. |
disabilitare Keyguard
public abstract 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)
disabilitare NetworkMonitor
public abstract boolean disableNetworkMonitor ()
Disabilita il monitoraggio della rete sul dispositivo.
ritorna |
---|
boolean | true se il monitoraggio è disabilitato correttamente. false se ha fallito. |
disconnetti dal Wi-Fi
public abstract boolean disconnectFromWifi ()
Si disconnette da una rete wifi.
Rimuove tutte le reti dall'elenco delle reti conosciute e disabilita il wifi.
ritorna |
---|
boolean | true se disconnesso dalla rete wifi con successo. false se la disconnessione non è riuscita. |
faFileExist
public abstract 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. |
dumpHeap
public abstract 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. |
enableNetworkMonitor
public abstract boolean enableNetworkMonitor ()
Abilita il monitoraggio della rete sul dispositivo.
ritorna |
---|
boolean | true se il monitoraggio è abilitato correttamente. false se ha fallito. |
getActiveApex
public abstract getActiveApexes ()
Recupera le informazioni sugli APEX attivati sul dispositivo.
getAllSettings
public abstract 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. |
getAndroidId
public abstract String getAndroidId (int userId)
Trova e restituisce l'ID Android associato a un ID utente, null se non trovato.
getAndroidIds
public abstract 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. |
getAppPackageInfo
public abstract PackageInfo getAppPackageInfo (String packageName)
Recupera le informazioni su un pacchetto installato sul dispositivo.
Parametri |
---|
packageName | String |
getAppPackageInfos
public abstract getAppPackageInfos ()
Recupera le informazioni sui pacchetti installati sul dispositivo.
getCurrentFoldableState
public abstract DeviceFoldableState getCurrentFoldableState ()
Restituisce lo stato pieghevole corrente del dispositivo o null se si sono verificati alcuni problemi.
getCurrentUser
public abstract int getCurrentUser ()
Restituisce l'ID dell'utente corrente in esecuzione. In caso di errore, restituire -10000.
getFoldableStates
public abstract getFoldableStates ()
Restituisce l'elenco degli stati ripiegabili sul dispositivo. Può essere ottenuto con "cmd device_state print-states".
getInstalledPackageNames
public abstract getInstalledPackageNames ()
Recupera i nomi dei pacchetti dell'applicazione presenti sul dispositivo.
ritorna |
---|
| ERROR(/Set) dei nomi dei pacchetti String attualmente installati sul dispositivo. |
getIndirizzoIp
public abstract String getIpAddress ()
Ottiene l'indirizzo IP del dispositivo.
ritorna |
---|
String | l'indirizzo IP del dispositivo o null se il dispositivo non ha un indirizzo IP |
getKeyguardState
public abstract KeyguardControllerState getKeyguardState ()
Restituisce un oggetto per ottenere lo stato corrente del keyguard o null se non supportato.
getMainlineModuleInfo
public abstract getMainlineModuleInfo ()
Ottieni le informazioni sui moduli mainline installati sul dispositivo.
ritorna |
---|
| ERROR(/Set) dei moduli della linea principale String attualmente installati sul dispositivo. |
public abstract 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 |
public abstract 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 |
getOptions
public abstract TestDeviceOptions getOptions ()
Recupera le opzioni di test per il dispositivo.
getPrimaryUserId
public abstract 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. |
getScreenshot
public abstract InputStreamSource getScreenshot ()
Cattura uno screenshot dal dispositivo.
getScreenshot
public abstract 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 |
getScreenshot
public abstract 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 abstract 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. |
getSetting
public abstract String getSetting (String namespace,
String key)
Vedere getSetting(int, String, String)
ed eseguito sull'utente di sistema.
Parametri |
---|
namespace | String |
key | String |
getSetting
public abstract 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. |
getUninstallablePackageNames
public abstract 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 abstract 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.
ritorna |
---|
int | i flag associati allo userId fornito se trovato, -10000 negli altri casi. |
getUserInfos
public abstract 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. |
getUserSerialNumber
public abstract int getUserSerialNumber (int userId)
Restituire il numero di serie associato all'ID utente se trovato, -10000 negli altri casi.
haCaratteristica
public abstract 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. |
installPackage
public abstract 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. |
installPackage
public abstract 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 | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
UnsupportedOperationException | se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo. |
installPackageForUser
public abstract 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 | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
UnsupportedOperationException | se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo. |
installPackageForUser
public abstract 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. |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
Installa un'applicazione Android composta da diversi file APK (un pacchetto diviso principale ed extra). Vedi "https://developer.android.com/studio/build/configure-apk-splits" su come dividere apk in più file.
Parametri |
---|
packageFiles | : i file apk locali |
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 | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
UnsupportedOperationException | se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo. |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Installa un'applicazione Android composta da diversi file APK (un pacchetto diviso principale ed extra) che si trovano sul dispositivo Android. Vedi "https://developer.android.com/studio/build/configure-apk-splits" su come dividere apk in più file.
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 |
---|
packageFiles | : i percorsi del file apk remoto 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 | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
UnsupportedOperationException | se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo. |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Installa un'applicazione Android composta da diversi file APK (un pacchetto diviso principale ed extra) per un determinato utente. Vedi "https://developer.android.com/studio/build/configure-apk-splits" su come dividere apk in più file.
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 |
---|
packageFiles | : i file apk locali |
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 | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
UnsupportedOperationException | se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo. |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
Installa un'applicazione Android composta da diversi file APK (un pacchetto diviso principale ed extra) per un determinato utente. Vedi "https://developer.android.com/studio/build/configure-apk-splits" su come dividere apk in più file.
Parametri |
---|
packageFiles | : i file apk locali |
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 | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
UnsupportedOperationException | se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo. |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Installa un'applicazione Android composta da diversi file APK (un pacchetto diviso principale ed extra) che si trovano sul dispositivo Android. Vedi "https://developer.android.com/studio/build/configure-apk-splits" su come dividere apk in più file.
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 |
---|
remoteApkPaths | : i percorsi dei file apk remoti |
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 | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
UnsupportedOperationException | se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo. |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
Installa un'applicazione Android composta da diversi file APK (un pacchetto diviso principale ed extra) che si trovano sul dispositivo Android. Vedi "https://developer.android.com/studio/build/configure-apk-splits" su come dividere apk in più file.
Parametri |
---|
remoteApkPaths | : i percorsi dei file apk remoti |
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 | se la connessione con il dispositivo viene persa e non può essere ripristinata. |
UnsupportedOperationException | se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo. |
isMultiUserSupported
public abstract boolean isMultiUserSupported ()
Determina se il multiutente è supportato.
ritorna |
---|
boolean | true se multiutente è supportato, false in caso contrario |
isPackageInstalled
public abstract 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. |
isPackageInstalled
public abstract 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. |
isUserRunning
public abstract boolean isUserRunning (int userId)
Controlla se un determinato utente è in esecuzione.
ritorna |
---|
boolean | True se l'utente è in esecuzione, false in tutti gli altri casi. |
isUserSecondary
public abstract 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 in caso contrario. |
isWifiEnabled
public abstract boolean isWifiEnabled ()
Verifica se il wifi è abilitato.
Verifica se il wifi è abilitato sul dispositivo. Utile per affermare lo stato del wifi prima di test che non dovrebbero essere eseguiti con il wifi, ad es. test di dati mobili.
ritorna |
---|
boolean | true se il wifi è abilitato. false se disabilitato |
listDisplayIds
public abstract 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. |
listUsers
public abstract listUsers ()
Ottiene l'elenco degli utenti sul dispositivo. DeviceRuntimeException
se l'output dal dispositivo non è come previsto.
ritorna |
---|
| l'elenco degli ID utente. |
removeAdmin
public abstract 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. |
rimuovereProprietari
public abstract void removeOwners ()
Rimuovi tutti i proprietari di profili dispositivo esistenti con il massimo sforzo.
removeUser
public abstract 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. |
setDeviceOwner
public abstract 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. |
setSetting
public abstract 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 |
setSetting
public abstract 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 |
startUser
public abstract 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. |
startUser
public abstract 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. |
stopUser
public abstract 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 abstract 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. |
cambia utente
public abstract boolean switchUser (int userId)
Passa a un altro ID utente con un timeout predefinito. switchUser(int, long)
.
ritorna |
---|
boolean | True se il nuovo userId corrisponde al provider userId. Falso altrimenti. |
cambia utente
public abstract 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. |
uninstallPackage
public abstract 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. |
uninstallPackageForUser
public abstract 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. |
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 2022-08-15 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Mancano le informazioni di cui ho bisogno"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Troppo complicato/troppi passaggi"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Obsoleti"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problema di traduzione"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Problema relativo a esempi/codice"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Altra"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Facile da capire"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Il problema è stato risolto"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Altra"
}]