ITestDevice
public
interface
ITestDevice
implements
INativeDevice
| com.android.tradefed.device.ITestDevice
|
Sottoclassi indirette note
|
Fornisce un'API affidabile e di livello leggermente superiore a ddmlib IDevice.
Ritenta i comandi del dispositivo per un importo configurabile e fornisce un'interfaccia di recupero del dispositivo per i dispositivi che non rispondono.
Riepilogo
Classi nidificate |
|---|
class |
ITestDevice.ApexInfo
Una semplice classe struct per archiviare informazioni su un singolo APEX
|
class |
ITestDevice.MountPointInfo
Una semplice classe struct per archiviare informazioni su un singolo punto di montaggio
|
Metodi pubblici |
|---|
abstract
boolean
|
canSwitchToHeadlessSystemUser()
Restituisce un valore che indica se è consentito passare all'utente di sistema headless.
|
abstract
boolean
|
checkConnectivity()
Verifica che il dispositivo abbia connettività di rete.
|
abstract
boolean
|
clearErrorDialogs()
Tenta di chiudere le finestre di dialogo di errore attualmente visualizzate nell'interfaccia utente del dispositivo.
|
abstract
void
|
clearLastConnectedWifiNetwork()
Cancella l'ultima rete Wi-Fi connessa.
|
abstract
boolean
|
connectToWifiNetwork( wifiSsidToPsk)
Si connette a una rete Wi-Fi.
|
abstract
boolean
|
connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)
Si connette a una rete Wi-Fi.
|
abstract
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk)
Si connette a una rete Wi-Fi.
|
abstract
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)
Si connette a una rete Wi-Fi.
|
abstract
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)
Una variante di connectToWifiNetwork(String, String) che si connette solo se il dispositivo
al momento non ha connettività di rete.
|
abstract
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)
Una variante di connectToWifiNetwork(String, String) che si connette solo se il dispositivo
al momento non ha connettività di rete.
|
abstract
int
|
createUser(String name)
Crea un utente con un nome specificato e flag predefiniti 0.
|
abstract
int
|
createUser(String name, boolean guest, boolean ephemeral)
Crea un utente con un nome specificato e i flag forniti
|
abstract
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Crea un utente con un nome specificato e i flag forniti
|
abstract
int
|
createUserNoThrow(String name)
Crea un utente con un nome specificato e flag predefiniti 0.
|
abstract
void
|
deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Rimuove il IDeviceActionReceiver registrato.
|
abstract
void
|
disableKeyguard()
Tentativi di disattivare la protezione tasti.
|
abstract
boolean
|
disableNetworkMonitor()
Disattiva il monitoraggio della rete sul dispositivo.
|
abstract
boolean
|
disconnectFromWifi()
Si disconnette da una rete Wi-Fi.
|
abstract
boolean
|
doesFileExist(String deviceFilePath, int userId)
Metodo helper per determinare se il file sul dispositivo esiste per un determinato utente.
|
abstract
File
|
dumpHeap(String process, String devicePath)
Prova a scaricare l'heap da system_server.
|
abstract
boolean
|
enableNetworkMonitor()
Attiva il monitoraggio della rete sul dispositivo.
|
abstract
|
getActiveApexes()
Recupera le informazioni sugli APEX attivati sul dispositivo.
|
abstract
|
getAllSettings(String namespace)
Restituisce le coppie chiave-valore dello spazio dei nomi richiesto.
|
abstract
String
|
getAndroidId(int userId)
Trova e restituisce l'android-id associato a un userId, null se non trovato.
|
abstract
|
getAndroidIds()
Crea una mappa degli ID Android trovati che corrispondono agli ID utente.
|
abstract
PackageInfo
|
getAppPackageInfo(String packageName)
Recupera informazioni su un pacchetto installato sul dispositivo.
|
abstract
|
getAppPackageInfos()
Recupera le informazioni sui pacchetti installati sul dispositivo.
|
abstract
InputStreamSource
|
getBugreport()
Recupera una segnalazione di bug dal dispositivo.
|
abstract
InputStreamSource
|
getBugreportz()
Recupera un bugreportz dal dispositivo.
|
abstract
DeviceFoldableState
|
getCurrentFoldableState()
Restituisce lo stato attuale di piegatura del dispositivo o null se si sono verificati alcuni problemi.
|
abstract
int
|
getCurrentUser()
Restituisce l'ID dell'utente attualmente in esecuzione.
|
abstract
|
getFoldableStates()
Restituisce l'elenco degli stati di piegatura sul dispositivo.
|
abstract
|
getInstalledPackageNames()
Recupera i nomi dei pacchetti delle applicazioni presenti sul dispositivo.
|
abstract
String
|
getIpAddress()
Recupera l'indirizzo IP del dispositivo.
|
abstract
KeyguardControllerState
|
getKeyguardState()
Restituisce un oggetto per ottenere lo stato attuale del keyguard o null se non è supportato.
|
abstract
Integer
|
getMainUserId()
Restituisce l'ID utente principale.
|
abstract
|
getMainlineModuleInfo()
Recupera 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()
Questo metodo è obsoleto.
getPrimaryUser è stato ritirato dal servizio UserManager. Utilizza
ERROR(/android.os.UserManager#getMainUserId()) per ottenere il primo utente completo
o 0 per il sistema. Tieni presente che per il sistema headless non si tratta di un utente completo.
|
abstract
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Acquisisce uno screenshot dal dispositivo.
|
abstract
InputStreamSource
|
getScreenshot(long displayId)
Acquisisce uno screenshot dal dispositivo dato l'ID display.
|
abstract
InputStreamSource
|
getScreenshot(String format)
Acquisisce uno screenshot dal dispositivo.
|
abstract
InputStreamSource
|
getScreenshot()
Acquisisce uno screenshot dal dispositivo.
|
abstract
String
|
getSetting(int userId, String namespace, String key)
Restituisce il valore dell'impostazione richiesta.
|
abstract
String
|
getSetting(String namespace, String key)
Consulta getSetting(int, String, String) ed eseguita sull'utente di sistema.
|
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()
Recupera la mappa di useId per UserInfo sul dispositivo.
|
abstract
int
|
getUserSerialNumber(int userId)
Restituisce il numero di serie associato all'ID utente se trovato, -10000 in tutti gli altri casi.
|
abstract
boolean
|
hasFeature(String feature)
Controllare se una funzionalità è 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, int userId, String... extraArgs)
Installa un pacchetto Android sul dispositivo per un determinato utente.
|
abstract
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Installa un pacchetto Android sul dispositivo per un determinato utente.
|
abstract
boolean
|
installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)
Installa APK con modalità incrementale.
|
default
String
|
installPackages( packageFiles, boolean reinstall, String... extraArgs)
Installa un'applicazione Android composta da più file APK (un pacchetto principale e pacchetti di suddivisione aggiuntivi).
|
default
String
|
installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)
Installa un'applicazione Android composta da diversi file APK (uno principale e pacchetti split aggiuntivi)
presenti sul dispositivo Android.
|
default
String
|
installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)
Installa un'applicazione Android composta da diversi file APK (un pacchetto principale e pacchetti split aggiuntivi)
per un determinato utente.
|
default
String
|
installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Installa un'applicazione Android composta da diversi file APK (un pacchetto principale e pacchetti split aggiuntivi)
per un determinato utente.
|
default
String
|
installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs)
Installa un'applicazione Android composta da diversi file APK (un pacchetto principale e pacchetti split aggiuntivi)
che si trovano sul dispositivo Android.
|
default
String
|
installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)
Installa un'applicazione Android composta da diversi file APK (uno principale e pacchetti split aggiuntivi)
presenti sul dispositivo Android.
|
abstract
boolean
|
isHeadlessSystemUserMode()
Indica se il dispositivo utilizza la modalità headless system user.
|
abstract
boolean
|
isMainUserPermanentAdmin()
Restituisce un valore che indica se l'utente principale è un amministratore permanente e non può essere eliminato o declassato a
utente non amministratore.
|
abstract
boolean
|
isMultiUserSupported()
Determina se è supportato l'utilizzo di più utenti.
|
abstract
boolean
|
isPackageInstalled(String packageName, String userId)
Esegui una query sul dispositivo per un determinato nome del pacchetto e un determinato ID utente per verificare se l'app è attualmente
installata o meno per quell'utente.
|
abstract
boolean
|
isPackageInstalled(String packageName)
Esegui una query sul dispositivo per un determinato nome di pacchetto per verificare se è attualmente installato o meno.
|
abstract
boolean
|
isUserRunning(int userId)
Controlla se un determinato utente è in esecuzione.
|
abstract
boolean
|
isUserSecondary(int userId)
Restituisce un valore che indica se l'utente specificato è un utente secondario in base ai relativi flag.
|
abstract
boolean
|
isUserVisible(int userId)
Verifica se l'utente specificato è visibile.
|
abstract
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
Verifica se l'utente specificato è visibile nella visualizzazione indicata.
|
abstract
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
Restituisce un valore che indica se il dispositivo consente agli utenti di essere avviati in modo visibile in background in ERROR(/java.android.view.Display#DEFAULT_DISPLAY).
|
abstract
boolean
|
isVisibleBackgroundUsersSupported()
Restituisce un valore che indica se il dispositivo consente l'avvio visibile in background.
|
abstract
boolean
|
isWifiEnabled()
Verifica se il Wi-Fi è attivo.
|
abstract
|
listDisplayIds()
Raccogli l'elenco degli ID display disponibili sul dispositivo come riportato da "dumpsys
SurfaceFlinger".
|
abstract
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Recupera l'elenco dei display che possono essere utilizzati per start a user visible in the background.
|
abstract
|
listUsers()
Recupera l'elenco degli utenti sul dispositivo.
|
abstract
boolean
|
logBugreport(String dataName, ITestLogger listener)
Metodo helper per acquisire una segnalazione di bug e registrarla per i reporter.
|
default
void
|
notifySnapuserd(SnapuserdWaitPhase waitPhase)
Notifica al dispositivo di attendere il completamento di snapuserd.
|
abstract
void
|
registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Registra un IDeviceActionReceiver per questo dispositivo.
|
abstract
boolean
|
removeAdmin(String componentName, int userId)
Rimuovi l'amministratore del dispositivo specificato nell'utente specificato e restituisci true se l'operazione ha esito positivo, false in caso contrario.
|
abstract
void
|
removeOwners()
Rimuovi tutti i proprietari dei profili dei dispositivi esistenti con il massimo impegno.
|
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 per un determinato utente.
|
abstract
void
|
setSetting(String namespace, String key, String value)
Consulta setSetting(int, String, String, String) ed eseguita 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 arrestato.
|
abstract
boolean
|
startUser(int userId, boolean waitFlag)
Avvia un determinato utente in background se è attualmente arrestato.
|
abstract
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Avvia un determinato utente in background, visibile nel display specificato (ovvero, consente all'utente
di avviare attività in quel display).
|
abstract
boolean
|
stopUser(int userId)
Interrompe un determinato utente.
|
abstract
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Interrompi un determinato utente.
|
abstract
boolean
|
switchUser(int userId)
Passa a un altro userId con un timeout predefinito.
|
abstract
boolean
|
switchUser(int userId, long timeout)
Passa a un altro userId con il timeout fornito come scadenza.
|
abstract
Bugreport
|
takeBugreport()
Prende una segnalazione di bug e la restituisce all'interno di un oggetto Bugreport per gestirla.
|
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.
|
default
void
|
waitForSnapuserd(SnapuserdWaitPhase currentPhase)
Se previsto, attendi il completamento di snapuserd.
|
Metodi pubblici
canSwitchToHeadlessSystemUser
public abstract boolean canSwitchToHeadlessSystemUser ()
Restituisce un valore che indica se è consentito passare all'utente di sistema headless.
checkConnectivity
public abstract boolean checkConnectivity ()
Verifica che il dispositivo abbia connettività di rete.
| Ritorni |
|---|
boolean |
true se il dispositivo ha una connessione di rete funzionante,
false altrimenti. |
clearErrorDialogs
public abstract boolean clearErrorDialogs ()
Tenta di chiudere le finestre di dialogo di errore attualmente visualizzate nell'interfaccia utente del dispositivo.
| Ritorni |
|---|
boolean |
true se non erano presenti dialoghi o se sono stati cancellati correttamente.
false altrimenti. |
clearLastConnectedWifiNetwork
public abstract void clearLastConnectedWifiNetwork ()
Cancella l'ultima rete Wi-Fi connessa. Questo metodo deve essere chiamato all'avvio di una nuova chiamata
per evitare di connettersi alla rete Wi-Fi utilizzata nel test precedente dopo i riavvii del dispositivo.
connectToWifiNetwork
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)
Si connette a una rete Wi-Fi.
Attiva il Wi-Fi e blocca la connessione finché non viene stabilita una connessione corretta con una delle reti Wi-Fi
fornite nella mappa wifiSsidToPsk. Una volta stabilita una connessione, l'istanza tenterà di
ripristinarla dopo ogni riavvio fino a quando non viene chiamato ITestDevice.disconnectFromWifi() o
ITestDevice.clearLastConnectedWifiNetwork().
| Parametri |
|---|
wifiSsidToPsk |
|
| Ritorni |
|---|
boolean |
true se la connessione alla rete Wi-Fi è stata stabilita. false
altrimenti |
connectToWifiNetwork
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk,
boolean scanSsid)
Si connette a una rete Wi-Fi.
Attiva il Wi-Fi e blocca la connessione finché non viene stabilita una connessione corretta con una delle reti Wi-Fi
fornite nella mappa wifiSsidToPsk. Una volta stabilita una connessione, l'istanza tenterà di
ripristinarla dopo ogni riavvio fino a quando non viene chiamato ITestDevice.disconnectFromWifi() o
ITestDevice.clearLastConnectedWifiNetwork().
| Parametri |
|---|
wifiSsidToPsk |
|
scanSsid |
boolean: indica se eseguire la scansione degli SSID nascosti per questa rete. |
| Ritorni |
|---|
boolean |
true se la connessione alla rete Wi-Fi è stata stabilita. false
altrimenti |
connectToWifiNetwork
public abstract boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk)
Si connette a una rete Wi-Fi.
Attiva il Wi-Fi e blocca fino a quando non viene stabilita una connessione alla rete Wi-Fi specificata.
Una volta stabilita una connessione, l'istanza tenterà di ripristinarla dopo ogni riavvio
fino a quando non viene chiamato ITestDevice.disconnectFromWifi() o
ITestDevice.clearLastConnectedWifiNetwork().
| Parametri |
|---|
wifiSsid |
String: l'SSID Wi-Fi a cui connettersi |
wifiPsk |
String: passphrase PSK o null se non criptata |
| Ritorni |
|---|
boolean |
true se la connessione alla rete Wi-Fi è stata stabilita. false
altrimenti |
connectToWifiNetwork
public abstract boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk,
boolean scanSsid)
Si connette a una rete Wi-Fi.
Attiva il Wi-Fi e blocca l'operazione finché non viene stabilita una connessione alla rete Wi-Fi specificata.
Una volta stabilita una connessione, l'istanza tenterà di ripristinarla dopo ogni riavvio
fino a quando non viene chiamato ITestDevice.disconnectFromWifi() o
ITestDevice.clearLastConnectedWifiNetwork().
| Parametri |
|---|
wifiSsid |
String: l'SSID Wi-Fi a cui connettersi |
wifiPsk |
String: passphrase PSK o null se non criptata |
scanSsid |
boolean: indica se eseguire la scansione dell'SSID nascosto per questa rete. |
| Ritorni |
|---|
boolean |
true se la connessione alla rete Wi-Fi è stata stabilita. 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
al momento non ha connettività di rete.
| Parametri |
|---|
scanSsid |
boolean: indica se eseguire la scansione dell'SSID nascosto per questa rete |
| Ritorni |
|---|
boolean |
true se la connessione alla rete Wi-Fi è stata stabilita. false
altrimenti |
connectToWifiNetworkIfNeeded
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk)
Una variante di connectToWifiNetwork(String, String) che si connette solo se il dispositivo
al momento non ha connettività di rete.
| Ritorni |
|---|
boolean |
true se la connessione alla rete Wi-Fi è stata stabilita. false
altrimenti |
createUser
public abstract int createUser (String name)
Crea un utente con un nome specificato e flag predefiniti 0.
| Parametri |
|---|
name |
String: dell'utente da creare sul dispositivo |
| Ritorni |
|---|
int |
l'intero per l'ID utente creato |
createUser
public abstract int createUser (String name,
boolean guest,
boolean ephemeral)
Crea un utente con un nome specificato e i flag forniti
| Parametri |
|---|
name |
String: dell'utente da creare sul dispositivo |
guest |
boolean: attiva il flag utente --guest durante la creazione |
ephemeral |
boolean: attiva il flag utente --ephemeral durante la creazione |
| Ritorni |
|---|
int |
ID dell'utente creato |
createUser
public abstract int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
Crea un utente con un nome specificato e i flag forniti
| Parametri |
|---|
name |
String: dell'utente da creare sul dispositivo |
guest |
boolean: attiva il flag utente --guest durante la creazione |
ephemeral |
boolean: attiva il flag utente --ephemeral durante la creazione |
forTesting |
boolean: attiva il flag di test --for-testing durante la creazione |
| Ritorni |
|---|
int |
ID dell'utente creato |
createUserNoThrow
public abstract int createUserNoThrow (String name)
Crea un utente con un nome specificato e flag predefiniti 0.
| Parametri |
|---|
name |
String: dell'utente da creare sul dispositivo |
| Ritorni |
|---|
int |
l'intero per l'ID utente creato o -1 per errore. |
disableKeyguard
public abstract void disableKeyguard ()
Tentativi di disattivare la protezione tasti.
Innanzitutto, attendi che l'invio dell'input sia pronto. Ciò avviene all'incirca nello stesso momento in cui il
dispositivo segnala BOOT_COMPLETE, apparentemente in modo asincrono, perché l'attuale implementazione
del framework presenta occasionalmente una condizione di competizione. Il comando viene inviato per chiudere Keyguard (funziona
solo su quelli non sicuri)
disableNetworkMonitor
public abstract boolean disableNetworkMonitor ()
Disattiva il monitoraggio della rete sul dispositivo.
| Ritorni |
|---|
boolean |
true se il monitoraggio è disattivato correttamente. false
se non è andato a buon fine. |
disconnectFromWifi
public abstract boolean disconnectFromWifi ()
Si disconnette da una rete Wi-Fi.
Rimuove tutte le reti dall'elenco delle reti note e disattiva il Wi-Fi.
| Ritorni |
|---|
boolean |
true se la disconnessione dalla rete Wi-Fi è andata a buon fine. false
se la disconnessione non è riuscita. |
doesFileExist
public abstract boolean doesFileExist (String deviceFilePath,
int userId)
Metodo helper per determinare se il file sul dispositivo esiste per un determinato utente.
| Parametri |
|---|
deviceFilePath |
String: il percorso assoluto del file sul dispositivo da controllare |
userId |
int: l'ID utente rispetto al quale controllare l'esistenza del file |
| Ritorni |
|---|
boolean |
true se il file esiste, false altrimenti. |
dumpHeap
public abstract File dumpHeap (String process,
String devicePath)
Prova a scaricare l'heap da system_server. È responsabilità del chiamante pulire
il file di dump.
| Parametri |
|---|
process |
String: il nome del processo del dispositivo su cui eseguire dumpheap. |
devicePath |
String: il percorso sul dispositivo in cui inserire il dump. Deve trattarsi di una posizione in cui
le autorizzazioni lo consentono. |
| Ritorni |
|---|
File |
il ERROR(/File) contenente il report. Null se si è verificato un errore. |
enableNetworkMonitor
public abstract boolean enableNetworkMonitor ()
Attiva il monitoraggio della rete sul dispositivo.
| Ritorni |
|---|
boolean |
true se il monitoraggio è stato abilitato correttamente. false
se non è andato a buon fine. |
getActiveApexes
public abstract getActiveApexes ()
Recupera le informazioni sugli APEX attivati sul dispositivo.
getAllSettings
public abstract getAllSettings (String namespace)
Restituisce le coppie chiave-valore dello spazio dei nomi richiesto.
| Parametri |
|---|
namespace |
String: deve essere uno dei seguenti valori: {"system", "secure", "global"} |
| Ritorni |
|---|
|
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'android-id associato a un userId, null se non trovato.
getAndroidIds
public abstract getAndroidIds ()
Crea una mappa degli ID Android trovati che corrispondono agli ID utente. Non è garantito che ogni ID utente
trovi un ID Android associato in questa funzione, quindi alcuni ID utente potrebbero corrispondere a null.
| Ritorni |
|---|
|
Mappa degli ID Android trovati che corrispondono agli ID utente. |
getAppPackageInfo
public abstract PackageInfo getAppPackageInfo (String packageName)
Recupera informazioni su un pacchetto installato sul dispositivo.
| Parametri |
|---|
packageName |
String |
getAppPackageInfos
public abstract getAppPackageInfos ()
Recupera le informazioni sui pacchetti installati sul dispositivo.
getBugreport
public abstract InputStreamSource getBugreport ()
Recupera una segnalazione di bug dal dispositivo.
L'implementazione di questa funzionalità è garantita per continuare a funzionare su un dispositivo senza scheda SD
(o in cui la scheda SD non è ancora montata).
getBugreportz
public abstract InputStreamSource getBugreportz ()
Recupera un bugreportz dal dispositivo. Il report bug in formato zip contiene il report bug principale e
altri file di log utili per il debug.
Supportato solo per "adb version" > 1.0.36
getCurrentFoldableState
public abstract DeviceFoldableState getCurrentFoldableState ()
Restituisce lo stato attuale di piegatura del dispositivo o null se si sono verificati alcuni problemi.
getCurrentUser
public abstract int getCurrentUser ()
Restituisce l'ID dell'utente attualmente in esecuzione. In caso di errore, restituisci -10000.
getFoldableStates
public abstract getFoldableStates ()
Restituisce l'elenco degli stati di piegatura sul dispositivo. Può essere ottenuto con "cmd device_state
print-states".
getInstalledPackageNames
public abstract getInstalledPackageNames ()
Recupera i nomi dei pacchetti delle applicazioni presenti sul dispositivo.
| Ritorni |
|---|
|
ERROR(/Set) dei nomi di pacchetto String attualmente installati sul dispositivo. |
getIpAddress
public abstract String getIpAddress ()
Recupera l'indirizzo IP del dispositivo.
| Ritorni |
|---|
String |
l'indirizzo IP del dispositivo o null se il dispositivo non ha un indirizzo IP |
getKeyguardState
public abstract KeyguardControllerState getKeyguardState ()
Restituisce un oggetto per ottenere lo stato attuale del keyguard o null se non è supportato.
getMainUserId
public abstract Integer getMainUserId ()
Restituisce l'ID utente principale.
| Ritorni |
|---|
Integer |
l'ID utente dell'utente principale, se presente, e null se non è presente alcun utente principale. |
getMainlineModuleInfo
public abstract getMainlineModuleInfo ()
Recupera le informazioni sui moduli mainline installati sul dispositivo.
| Ritorni |
|---|
|
ERROR(/Set) dei moduli mainline String attualmente installati sul dispositivo. |
public abstract int getMaxNumberOfRunningUsersSupported ()
Ottieni il numero massimo di utenti supportati in esecuzione simultanea. Il valore predefinito è 0.
| Ritorni |
|---|
int |
un numero intero che indica il numero di utenti in esecuzione simultanea |
public abstract int getMaxNumberOfUsersSupported ()
Ottieni il numero massimo di utenti supportati. Il valore predefinito è 0.
| Ritorni |
|---|
int |
un numero intero che indica il numero di utenti supportati |
getOptions
public abstract TestDeviceOptions getOptions ()
Recupera le opzioni di test per il dispositivo.
getPrimaryUserId
public abstract Integer getPrimaryUserId ()
Questo metodo è obsoleto.
getPrimaryUser è stato ritirato dal servizio UserManager, utilizza
ERROR(/android.os.UserManager#getMainUserId()) per ottenere il primo utente completo
o 0 per il sistema. Tieni presente che per il sistema headless non si tratta di un utente completo.
Restituisce l'ID utente principale.
| Ritorni |
|---|
Integer |
l'ID utente dell'utente principale, se presente, e null in caso contrario. |
getScreenshot
public abstract InputStreamSource getScreenshot (String format,
boolean rescale)
Acquisisce uno screenshot dal dispositivo. Consigliamo di utilizzare getScreenshot(String)
con codifica JPEG per dimensioni più ridotte.
| 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 (long displayId)
Acquisisce uno screenshot dal dispositivo dato l'ID display. Il formato è PNG.
TODO: extend the implementations above to support 'format' and 'rescale'
| Parametri |
|---|
displayId |
long: l'ID display della schermata da cui acquisire lo screenshot. |
getScreenshot
public abstract InputStreamSource getScreenshot (String format)
Acquisisce uno screenshot dal dispositivo.
Consigliamo di utilizzare getScreenshot(format) con codifica JPEG per dimensioni più ridotte
| Parametri |
|---|
format |
String: PNG, JPEG supportati |
getScreenshot
public abstract InputStreamSource getScreenshot ()
Acquisisce uno screenshot dal dispositivo.
getSetting
public abstract String getSetting (int userId,
String namespace,
String key)
Restituisce il valore dell'impostazione richiesta.
lo spazio dei nomi deve essere uno dei seguenti: {"system", "secure", "global"}
| Parametri |
|---|
userId |
int |
namespace |
String |
key |
String |
| Ritorni |
|---|
String |
il valore associato a namespace:key di un utente. Null se non trovato. |
getSetting
public abstract String getSetting (String namespace,
String key)
Consulta getSetting(int, String, String) ed eseguita sull'utente di sistema.
| Parametri |
|---|
namespace |
String |
key |
String |
getUninstallablePackageNames
public abstract getUninstallablePackageNames ()
Recupera i nomi dei pacchetti dell'applicazione che possono essere disinstallati. Attualmente sono definiti come
pacchetti non di sistema e pacchetti di sistema aggiornati.
| Ritorni |
|---|
|
ERROR(/Set) dei nomi dei pacchetti String disinstallabili 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.
| Ritorni |
|---|
int |
i flag associati all'ID utente fornito, se trovato, -10000 in tutti gli altri casi. |
getUserInfos
public abstract getUserInfos ()
Recupera la mappa di useId per UserInfo sul dispositivo. Genererà DeviceRuntimeException se l'output del dispositivo non è quello previsto.
| Ritorni |
|---|
|
l'elenco degli oggetti UserInfo. |
| Lanci |
|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
|
com.android.tradefed.device.DeviceRuntimeException |
DeviceNotAvailableException |
|
getUserSerialNumber
public abstract int getUserSerialNumber (int userId)
Restituisce il numero di serie associato all'ID utente se trovato, -10000 in tutti gli altri casi.
hasFeature
public abstract boolean hasFeature (String feature)
Controllare se una funzionalità è disponibile su un dispositivo.
| Parametri |
|---|
feature |
String: il cui formato deve essere "feature:" o "" direttamente. |
| Ritorni |
|---|
boolean |
Vero se la funzionalità viene trovata, 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. Per le opzioni disponibili, vedi "adb shell pm -h". |
| Ritorni |
|---|
String |
un 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: chiama questa funzione solo i casi d'uso che richiedono il controllo esplicito della concessione dell'autorizzazione runtime al momento dell'installazione.
| 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. Per le opzioni disponibili, vedi "adb shell pm -h". |
| Ritorni |
|---|
String |
un String con un codice di errore o null in caso di esito positivo. |
| Lanci |
|---|
DeviceNotAvailableException |
se la connessione con il dispositivo viene persa e non può essere
recuperata. |
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 da installare. |
extraArgs |
String: argomenti aggiuntivi facoltativi da passare. Per le opzioni disponibili, vedi "adb shell pm -h". |
| Ritorni |
|---|
String |
un String con un codice di errore o null in caso di esito positivo. |
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: chiama questa funzione solo i casi d'uso che richiedono il controllo esplicito della concessione dell'autorizzazione runtime al momento dell'installazione.
| 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 da installare. |
extraArgs |
String: argomenti aggiuntivi facoltativi da passare. Per le opzioni disponibili, vedi "adb shell pm -h". |
| Ritorni |
|---|
String |
un String con un codice di errore o null in caso di esito positivo. |
| Lanci |
|---|
DeviceNotAvailableException |
se la connessione con il dispositivo viene persa e non può essere
recuperata. |
UnsupportedOperationException |
se l'autorizzazione di runtime non è supportata dalla piattaforma
sul dispositivo. |
installPackageWithIncrementalMode
public abstract boolean installPackageWithIncrementalMode (File[] apkFiles,
String[] extraArgs,
String userId)
Installa APK con modalità incrementale.
| Parametri |
|---|
apkFiles |
File: i file APK da installare. |
extraArgs |
String |
userId |
String |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
Installa un'applicazione Android composta da più file APK (un pacchetto principale e pacchetti di suddivisione aggiuntivi).
Consulta la pagina "https://developer.android.com/studio/build/configure-apk-splits" per scoprire come dividere l'APK in
più file.
| Parametri |
|---|
packageFiles |
|
reinstall |
boolean: true se deve essere eseguita una reinstallazione |
extraArgs |
String: argomenti aggiuntivi facoltativi da passare. Per le opzioni disponibili, vedi "adb shell pm -h". |
| Ritorni |
|---|
String |
un String con un codice di errore o null in caso di esito positivo. |
| Lanci |
|---|
DeviceNotAvailableException |
se la connessione con il dispositivo viene persa e non può essere
recuperata. |
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 (uno principale e pacchetti split aggiuntivi)
presenti sul dispositivo Android. Consulta la pagina
"https://developer.android.com/studio/build/configure-apk-splits" per scoprire come dividere l'APK in
più file.
Nota: chiama questa funzione solo i casi d'uso che richiedono il controllo esplicito della concessione dell'autorizzazione runtime al momento dell'installazione.
| Parametri |
|---|
packageFiles |
|
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. Per le opzioni disponibili, vedi "adb shell pm -h". |
| Ritorni |
|---|
String |
un String con un codice di errore o null in caso di esito positivo. |
| Lanci |
|---|
DeviceNotAvailableException |
se la connessione con il dispositivo viene persa e non può essere
recuperata. |
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 principale e pacchetti split aggiuntivi)
per un determinato utente. Consulta la pagina "https://developer.android.com/studio/build/configure-apk-splits" su
come dividere l'APK in più file.
| Parametri |
|---|
packageFiles |
|
reinstall |
boolean: true se deve essere eseguita una reinstallazione |
userId |
int: l'ID utente intero da installare. |
extraArgs |
String: argomenti aggiuntivi facoltativi da passare. Per le opzioni disponibili, vedi "adb shell pm -h". |
| Ritorni |
|---|
String |
un String con un codice di errore o null in caso di esito positivo. |
| Lanci |
|---|
DeviceNotAvailableException |
se la connessione con il dispositivo viene persa e non può essere
recuperata. |
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 più file APK (un pacchetto principale e pacchetti split aggiuntivi)
per un determinato utente. Consulta la pagina "https://developer.android.com/studio/build/configure-apk-splits" su
come dividere l'APK in più file.
Nota: chiama questa funzione solo i casi d'uso che richiedono il controllo esplicito della concessione dell'autorizzazione runtime al momento dell'installazione.
| Parametri |
|---|
packageFiles |
|
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 da installare. |
extraArgs |
String: argomenti aggiuntivi facoltativi da passare. Per le opzioni disponibili, vedi "adb shell pm -h". |
| Ritorni |
|---|
String |
un String con un codice di errore o null in caso di esito positivo. |
| Lanci |
|---|
DeviceNotAvailableException |
se la connessione con il dispositivo viene persa e non può essere
recuperata. |
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 principale e pacchetti split aggiuntivi)
che si trovano sul dispositivo Android. Consulta la pagina
"https://developer.android.com/studio/build/configure-apk-splits" su come dividere l'APK in
più file.
| Parametri |
|---|
remoteApkPaths |
|
reinstall |
boolean: true se deve essere eseguita una reinstallazione |
extraArgs |
String: argomenti aggiuntivi facoltativi da passare. Per le opzioni disponibili, vedi "adb shell pm -h". |
| Ritorni |
|---|
String |
un String con un codice di errore o null in caso di esito positivo. |
| Lanci |
|---|
DeviceNotAvailableException |
se la connessione con il dispositivo viene persa e non può essere
recuperata. |
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 principale e pacchetti split aggiuntivi)
che si trovano sul dispositivo Android. Consulta la pagina
"https://developer.android.com/studio/build/configure-apk-splits" per scoprire come dividere l'APK in
più file.
Nota: chiama questa funzione solo i casi d'uso che richiedono il controllo esplicito della concessione dell'autorizzazione runtime al momento dell'installazione.
| Parametri |
|---|
remoteApkPaths |
|
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. Per le opzioni disponibili, vedi "adb shell pm -h". |
| Ritorni |
|---|
String |
un String con un codice di errore o null in caso di esito positivo. |
| Lanci |
|---|
DeviceNotAvailableException |
se la connessione con il dispositivo viene persa e non può essere
recuperata. |
UnsupportedOperationException |
se l'autorizzazione di runtime non è supportata dalla piattaforma
sul dispositivo. |
isHeadlessSystemUserMode
public abstract boolean isHeadlessSystemUserMode ()
Indica se il dispositivo utilizza la modalità headless system user.
isMainUserPermanentAdmin
public abstract boolean isMainUserPermanentAdmin ()
Restituisce un valore che indica se l'utente principale è un amministratore permanente e non può essere eliminato o declassato a
utente non amministratore.
isMultiUserSupported
public abstract boolean isMultiUserSupported ()
Determina se è supportato l'utilizzo di più utenti.
| Ritorni |
|---|
boolean |
true se è supportato più utenti, false in caso contrario |
isPackageInstalled
public abstract boolean isPackageInstalled (String packageName,
String userId)
Esegui una query sul dispositivo per un determinato nome del pacchetto e un determinato ID utente per verificare se l'app è attualmente
installata o meno per quell'utente.
| Parametri |
|---|
packageName |
String: il pacchetto di cui stiamo verificando l'installazione. |
userId |
String: l'ID utente per cui stiamo verificando che il pacchetto sia installato. Se è null, verrà utilizzato
zero per l'utente principale. |
| Ritorni |
|---|
boolean |
Vero se il pacchetto è segnalato come installato. Falso negli altri casi. |
isPackageInstalled
public abstract boolean isPackageInstalled (String packageName)
Esegui una query sul dispositivo per un determinato nome di pacchetto per verificare se è attualmente installato o meno.
| Parametri |
|---|
packageName |
String |
| Ritorni |
|---|
boolean |
Vero se il pacchetto è segnalato come installato. Falso negli altri casi. |
isUserRunning
public abstract boolean isUserRunning (int userId)
Controlla se un determinato utente è in esecuzione.
| Ritorni |
|---|
boolean |
Vero se l'utente sta correndo, falso in tutti gli altri casi. |
isUserSecondary
public abstract boolean isUserSecondary (int userId)
Restituisce un valore che indica se l'utente specificato è un utente secondario in base ai relativi flag.
| Ritorni |
|---|
boolean |
true se l'utente è secondario, false in caso contrario. |
isUserVisible
public abstract boolean isUserVisible (int userId)
Verifica se l'utente specificato è visibile.
Un utente "visibile" è un utente che interagisce con l'utente "umano" e quindi è in grado di
avviare attività (in genere nella visualizzazione predefinita).
isUserVisibleOnDisplay
public abstract boolean isUserVisibleOnDisplay (int userId,
int displayId)
Verifica se l'utente specificato è visibile nella visualizzazione indicata.
Un utente "visibile" è un utente che interagisce con l'utente "umano" e quindi è in grado di
avviare attività di avvio in quel display.
| Parametri |
|---|
userId |
int |
displayId |
int |
isWifiEnabled
public abstract boolean isWifiEnabled ()
Verifica se il Wi-Fi è attivo.
Controlla se il Wi-Fi è attivo sul dispositivo. Utile per verificare lo stato del Wi-Fi prima dei test che
non devono essere eseguiti con il Wi-Fi, ad esempio i test dei dati mobili.
| Ritorni |
|---|
boolean |
true se il Wi-Fi è attivo. false se disattivato |
listDisplayIds
public abstract listDisplayIds ()
Raccogli l'elenco degli ID display disponibili sul dispositivo come riportato da "dumpsys
SurfaceFlinger".
| Ritorni |
|---|
|
L'elenco dei display. Default restituisce sempre il display predefinito 0. |
listDisplayIdsForStartingVisibleBackgroundUsers
public abstract listDisplayIdsForStartingVisibleBackgroundUsers ()
Recupera l'elenco dei display che possono essere utilizzati per start a user visible in the background.
listUsers
public abstract listUsers ()
Recupera l'elenco degli utenti sul dispositivo. Genererà DeviceRuntimeException se l'output
del dispositivo non è quello previsto.
| Ritorni |
|---|
|
l'elenco degli ID utente. |
| Lanci |
|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
|
com.android.tradefed.device.DeviceRuntimeException |
DeviceNotAvailableException |
|
logBugreport
public abstract boolean logBugreport (String dataName,
ITestLogger listener)
Metodo helper per acquisire una segnalazione di bug e registrarla per i reporter.
| Parametri |
|---|
dataName |
String: il nome con cui verrà segnalato il report bug. |
listener |
ITestLogger: un ITestLogger per registrare la segnalazione di bug. |
| Ritorni |
|---|
boolean |
Vero se la registrazione è riuscita, falso in caso contrario. |
notifySnapuserd
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
Notifica al dispositivo di attendere il completamento di snapuserd.
| Parametri |
|---|
waitPhase |
SnapuserdWaitPhase |
removeAdmin
public abstract boolean removeAdmin (String componentName,
int userId)
Rimuovi l'amministratore del dispositivo specificato nell'utente specificato e restituisci true se l'operazione ha esito positivo, false in caso contrario.
| Parametri |
|---|
componentName |
String: dell'amministratore del dispositivo da rimuovere. |
userId |
int: dell'utente in cui si trova l'amministratore del dispositivo. |
| Ritorni |
|---|
boolean |
Vero se l'operazione è riuscita, falso in caso contrario. |
removeOwners
public abstract void removeOwners ()
Rimuovi tutti i proprietari dei profili dei dispositivi esistenti con il massimo impegno.
removeUser
public abstract boolean removeUser (int userId)
Rimuovere un determinato utente dal dispositivo.
| Parametri |
|---|
userId |
int: dell'utente da rimuovere |
| Ritorni |
|---|
boolean |
true se la rimozione dell'utente è riuscita, false in caso contrario. |
setDeviceOwner
public abstract boolean setDeviceOwner (String componentName,
int userId)
Imposta un componente di amministrazione del dispositivo come proprietario del dispositivo per un determinato utente.
| Parametri |
|---|
componentName |
String: dell'amministratore del dispositivo per diventare il proprietario del dispositivo. |
userId |
int: dell'utente in cui vive il proprietario del dispositivo. |
| Ritorni |
|---|
boolean |
Vero se l'operazione è riuscita, falso in caso contrario. |
setSetting
public abstract void setSetting (String namespace,
String key,
String value)
Consulta setSetting(int, String, String, String) ed eseguita 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 dei seguenti: {"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 arrestato. Se l'utente è già
in esecuzione in background, questo metodo è un'operazione NOOP.
| Parametri |
|---|
userId |
int: dell'utente da avviare in background |
| Ritorni |
|---|
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 arrestato. Se l'utente è già
in esecuzione in background, questo metodo è un'operazione NOOP. È possibile fornire un flag aggiuntivo per attendere
che l'operazione abbia effetto.
| Parametri |
|---|
userId |
int: dell'utente da avviare in background |
waitFlag |
boolean: il comando attenderà l'avvio e lo sblocco dell'utente. |
| Ritorni |
|---|
boolean |
true se l'utente è stato avviato correttamente in background. |
startVisibleBackgroundUser
public abstract boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Avvia un determinato utente in background, visibile nel display specificato (ovvero, consente all'utente
di avviare attività in quel display).
NOTA : questo comando non verifica se l'utente esiste, se la visualizzazione è disponibile, device supports such feature e così via.
| Parametri |
|---|
userId |
int: dell'utente da avviare in background |
displayId |
int: display to start user visible on |
waitFlag |
boolean: il comando attenderà l'avvio e lo sblocco dell'utente. |
| Ritorni |
|---|
boolean |
true se l'utente è stato avviato correttamente in background. |
stopUser
public abstract boolean stopUser (int userId)
Interrompe un determinato utente. Se l'utente è già stato arrestato, questo metodo è un'operazione NOOP.
Impossibile interrompere l'utente corrente e l'utente di sistema.
| Parametri |
|---|
userId |
int: dell'utente da arrestare. |
| Ritorni |
|---|
boolean |
true se l'utente è stato interrotto. |
stopUser
public abstract boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Interrompi un determinato utente. È possibile fornire flag aggiuntivi per attendere che l'operazione abbia effetto
e forzare la chiusura dell'utente. Impossibile interrompere l'utente corrente e l'utente di sistema.
| Parametri |
|---|
userId |
int: dell'utente da arrestare. |
waitFlag |
boolean: il comando attende che l'utente si fermi. |
forceFlag |
boolean: forzerà l'interruzione dell'utente. |
| Ritorni |
|---|
boolean |
true se l'utente è stato interrotto. |
switchUser
public abstract boolean switchUser (int userId)
Passa a un altro userId con un timeout predefinito. switchUser(int, long).
| Ritorni |
|---|
boolean |
Vero se il nuovo userId corrisponde al fornitore di userId. Falso negli altri casi. |
switchUser
public abstract boolean switchUser (int userId,
long timeout)
Passa a un altro userId con il timeout fornito come scadenza.
Tentativo di disattivare il keyguard dopo la modifica dell'utente.
| Parametri |
|---|
userId |
int |
timeout |
long: per attendere prima di restituire false per il cambio utente non riuscito. |
| Ritorni |
|---|
boolean |
Vero se il nuovo userId corrisponde al fornitore di userId. Falso negli altri casi. |
takeBugreport
public abstract 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 viene fatto riferimento nell'oggetto Bugreport deve essere pulito tramite Bugreport.close().
uninstallPackage
public abstract String uninstallPackage (String packageName)
Disinstalla un pacchetto Android dal dispositivo.
| Parametri |
|---|
packageName |
String: il pacchetto Android da disinstallare |
| Ritorni |
|---|
String |
un 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 da disinstallare. |
| Ritorni |
|---|
String |
un String con un codice di errore o null in caso di esito positivo. |
waitForSnapuserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
Se previsto, attendi il completamento di snapuserd.
| Parametri |
|---|
currentPhase |
SnapuserdWaitPhase |
