ITestDevice
public
interface
ITestDevice
implements
INativeDevice
| com.android.tradefed.device.ITestDevice
|
Sottoclassi indirette note
|
Fornisce un'API affidabile e di livello leggermente superiore a una 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
String
|
adbInstallPackage(File packageFile, boolean reinstall, String... extraArgs)
Installa un pacchetto Android sul dispositivo con il comando adb.
|
abstract
String
|
adbInstallPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Installa un pacchetto Android sul dispositivo con il comando adb.
|
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.
|
default
boolean
|
connectToWifiNetwork(Map<String, String> wifiSsidToPsk, boolean scanSsid)
Questo metodo è obsoleto.
utilizza invece connectToWifiNetworkWithResult(Map,boolean).
|
default
boolean
|
connectToWifiNetwork(Map<String, String> wifiSsidToPsk)
Questo metodo è obsoleto.
utilizza invece connectToWifiNetworkWithResult(Map).
|
default
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk)
Questo metodo è obsoleto.
utilizza invece connectToWifiNetworkWithResult(String,String).
|
default
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)
Questo metodo è obsoleto.
utilizza invece connectToWifiNetworkWithResult(String,String,boolean).
|
default
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)
Questo metodo è obsoleto.
utilizza invece connectToWifiNetworkIfNeededWithResult(String,String,boolean).
|
default
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)
Questo metodo è obsoleto.
utilizza invece connectToWifiNetworkIfNeededWithResult(String,String).
|
abstract
IWifiHelper.WifiConnectionResult
|
connectToWifiNetworkIfNeededWithResult(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
IWifiHelper.WifiConnectionResult
|
connectToWifiNetworkIfNeededWithResult(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
IWifiHelper.WifiConnectionResult
|
connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk, boolean scanSsid)
Si connette a una rete Wi-Fi.
|
abstract
IWifiHelper.WifiConnectionResult
|
connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk)
Si connette a una rete Wi-Fi.
|
abstract
IWifiHelper.WifiConnectionResult
|
connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk, boolean scanSsid)
Si connette a una rete Wi-Fi.
|
abstract
IWifiHelper.WifiConnectionResult
|
connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk)
Si connette a una rete Wi-Fi.
|
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()
Consente il monitoraggio della rete sul dispositivo.
|
abstract
Set<ITestDevice.ApexInfo>
|
getActiveApexes()
Recupera le informazioni sugli APEX attivati sul dispositivo.
|
abstract
Map<String, String>
|
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
Map<Integer, String>
|
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
List<PackageInfo>
|
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
Set<DeviceFoldableState>
|
getFoldableStates()
Restituisce l'elenco degli stati di piegatura sul dispositivo.
|
abstract
Set<String>
|
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
Set<String>
|
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(String userType)
Ottieni il numero massimo di utenti supportati del tipo di utente specificato.
|
abstract
int
|
getMaxNumberOfUsersSupported()
Questo metodo è obsoleto.
utilizza getMaxNumberOfUsersSupported(String userType) per ottenere il numero massimo di
utenti supportati per un determinato tipo di utente.
|
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
int
|
getRemainingCreatableUserCount(String userType)
Restituisce il numero di utenti del tipo specificato che possono essere creati su questo dispositivo.
|
abstract
InputStreamSource
|
getScreenshot(Long displayId, String format, boolean rescale)
Acquisisce uno screenshot dal dispositivo con l'ID display specificato nel formato supportato.
|
abstract
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Acquisisce uno screenshot dal dispositivo.
|
abstract
InputStreamSource
|
getScreenshot(String format)
Acquisisce uno screenshot dal dispositivo.
|
abstract
InputStreamSource
|
getScreenshot(long displayId)
Acquisisce uno screenshot dal dispositivo dato l'ID display.
|
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
Set<String>
|
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
Map<Integer, UserInfo>
|
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
int
|
getUserVisibleOnDisplay(int displayId)
Recupera l'ID utente dell'utente visibile sul display specificato.
|
abstract
boolean
|
hasFeature(String feature)
Controllare se una funzionalità è disponibile su un dispositivo.
|
abstract
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Installa un pacchetto Android sul dispositivo.
|
abstract
String
|
installPackage(File packageFile, boolean reinstall, 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.
|
abstract
boolean
|
installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)
Installa APK con la modalità incrementale.
|
default
String
|
installPackages(List<File> packageFiles, boolean reinstall, String... extraArgs)
Installa un'app per Android composta da più file APK (un pacchetto principale e pacchetti di suddivisione aggiuntivi).
|
default
String
|
installPackages(List<File> packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)
Installa un'app per Android composta da diversi file APK (uno principale e pacchetti split aggiuntivi)
che si trovano sul dispositivo Android.
|
default
String
|
installPackagesForUser(List<File> packageFiles, boolean reinstall, int userId, String... extraArgs)
Installa un'app per Android composta da più file APK (un pacchetto principale e pacchetti split aggiuntivi)
per un determinato utente.
|
default
String
|
installPackagesForUser(List<File> packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Installa un'app per Android composta da più file APK (un pacchetto principale e pacchetti split aggiuntivi)
per un determinato utente.
|
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()
Restituisce un valore che indica se questo dispositivo supporta più utenti commutabili con accesso e
spazio personalizzabile.
|
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 è attualmente
installato 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)
Controlla se l'utente specificato è visibile.
|
abstract
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
Controlla se l'utente specificato è visibile nella visualizzazione specificata.
|
abstract
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
Restituisce un valore che indica se il dispositivo consente agli utenti di avviare la visibilità 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
Set<Long>
|
listDisplayIds()
Raccogli l'elenco degli ID display disponibili sul dispositivo come riportato da "dumpsys
SurfaceFlinger".
|
abstract
Set<Integer>
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Recupera l'elenco dei display che possono essere utilizzati per start a user visible in the background.
|
abstract
ArrayList<Integer>
|
listUsers()
Visualizza 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 dall'utente specificato e restituisci true se l'operazione ha esito positivo, false in caso contrario.
|
abstract
void
|
removeOwners()
Rimuovi tutti i proprietari dei profili dispositivo 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 utente specificato in background se è attualmente arrestato.
|
abstract
boolean
|
startUser(int userId, boolean waitFlag)
Avvia un utente specificato 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, consentendo 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)
Interrompere 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
adbInstallPackage
public abstract String adbInstallPackage (File packageFile,
boolean reinstall,
String... extraArgs)
Installa un pacchetto Android sul dispositivo con il comando adb.
| 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". |
| Resi |
|---|
String |
un String con un codice di errore o null in caso di esito positivo. |
adbInstallPackage
public abstract String adbInstallPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Installa un pacchetto Android sul dispositivo con il comando adb.
Nota: chiama questa funzione solo i casi d'uso che richiedono il controllo esplicito della concessione dell'autorizzazione di 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". |
| Resi |
|---|
String |
un String con un codice di errore o null in caso di esito positivo. |
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.
| Resi |
|---|
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.
| Resi |
|---|
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'inizio di una nuova chiamata
per evitare di connettersi alla rete Wi-Fi utilizzata nel test precedente dopo il riavvio del dispositivo.
connectToWifiNetwork
public boolean connectToWifiNetwork (Map<String, String> wifiSsidToPsk,
boolean scanSsid)
Questo metodo è obsoleto.
utilizza invece connectToWifiNetworkWithResult(Map,boolean).
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 |
Map: una mappa degli SSID Wi-Fi e delle relative password. |
scanSsid |
boolean: indica se eseguire la scansione degli SSID nascosti per questa rete. |
| Resi |
|---|
boolean |
true se la connessione alla rete Wi-Fi è stata stabilita. false
altrimenti |
connectToWifiNetwork
public boolean connectToWifiNetwork (Map<String, String> wifiSsidToPsk)
Questo metodo è obsoleto.
utilizza invece connectToWifiNetworkWithResult(Map).
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 |
Map: una mappa degli SSID Wi-Fi e delle relative password. |
| Resi |
|---|
boolean |
true se la connessione alla rete Wi-Fi è stata stabilita. false
altrimenti |
connectToWifiNetwork
public boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk)
Questo metodo è obsoleto.
utilizza invece connectToWifiNetworkWithResult(String,String).
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 |
| Resi |
|---|
boolean |
true se la connessione alla rete Wi-Fi è stata stabilita. false
altrimenti |
connectToWifiNetwork
public boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk,
boolean scanSsid)
Questo metodo è obsoleto.
utilizza invece connectToWifiNetworkWithResult(String,String,boolean).
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 |
scanSsid |
boolean: indica se eseguire la scansione dell'SSID nascosto per questa rete. |
| Resi |
|---|
boolean |
true se la connessione alla rete Wi-Fi è stata stabilita. false
altrimenti |
connectToWifiNetworkIfNeeded
public boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk,
boolean scanSsid)
Questo metodo è obsoleto.
utilizza connectToWifiNetworkIfNeededWithResult(String,String,boolean)
invece.
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 |
| Resi |
|---|
boolean |
true se la connessione alla rete Wi-Fi è stata stabilita. false
altrimenti |
connectToWifiNetworkIfNeededWithResult
public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (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 |
connectToWifiNetworkWithResult
public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid,
String wifiPsk,
boolean scanSsid)
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 finché 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. |
connectToWifiNetworkWithResult
public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> 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 |
Map: una mappa degli SSID Wi-Fi e delle relative password. |
connectToWifiNetworkWithResult
public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> 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 |
Map: una mappa degli SSID Wi-Fi e delle relative password. |
scanSsid |
boolean: indica se eseguire la scansione degli SSID nascosti per questa rete. |
connectToWifiNetworkWithResult
public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (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 |
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 |
| Resi |
|---|
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 |
| Resi |
|---|
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 |
| Resi |
|---|
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 |
| Resi |
|---|
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 race condition. Il comando viene quindi inviato per chiudere Keyguard (funziona
solo su quelli non sicuri)
disableNetworkMonitor
public abstract boolean disableNetworkMonitor ()
Disattiva il monitoraggio della rete sul dispositivo.
| Resi |
|---|
boolean |
true se il monitoraggio è disabilitato. 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.
| Resi |
|---|
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 |
| Resi |
|---|
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. |
| Resi |
|---|
File |
il File contenente il report. Null se si è verificato un errore. |
enableNetworkMonitor
public abstract boolean enableNetworkMonitor ()
Consente il monitoraggio della rete sul dispositivo.
| Resi |
|---|
boolean |
true se il monitoraggio è stato abilitato correttamente. false
se non è andato a buon fine. |
getActiveApexes
public abstract Set<ITestDevice.ApexInfo> getActiveApexes ()
Recupera le informazioni sugli APEX attivati sul dispositivo.
getAllSettings
public abstract Map<String, String> 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"} |
| Resi |
|---|
Map<String, String> |
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 Map<Integer, String> 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.
| Resi |
|---|
Map<Integer, String> |
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 List<PackageInfo> 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 Set<DeviceFoldableState> getFoldableStates ()
Restituisce l'elenco degli stati di piegatura sul dispositivo. Può essere ottenuto con "cmd device_state
print-states".
getInstalledPackageNames
public abstract Set<String> getInstalledPackageNames ()
Recupera i nomi dei pacchetti delle applicazioni presenti sul dispositivo.
| Resi |
|---|
Set<String> |
Set dei nomi di pacchetto String attualmente installati sul dispositivo. |
getIpAddress
public abstract String getIpAddress ()
Recupera l'indirizzo IP del dispositivo.
| Resi |
|---|
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.
| Resi |
|---|
Integer |
l'ID utente dell'utente principale, se presente, e null in caso contrario. |
getMainlineModuleInfo
public abstract Set<String> getMainlineModuleInfo ()
Recupera le informazioni sui moduli mainline installati sul dispositivo.
| Resi |
|---|
Set<String> |
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.
| Resi |
|---|
int |
un numero intero che indica il numero di utenti in esecuzione simultanea |
public abstract int getMaxNumberOfUsersSupported (String userType)
Ottieni il numero massimo di utenti supportati del tipo di utente specificato. Il valore predefinito è 0.
| Parametri |
|---|
userType |
String: il tipo di utente, come definito in UserManager, ad esempio
"android.os.usertype.full.SECONDARY". |
| Resi |
|---|
int |
Un numero intero che indica il numero di utenti supportati del tipo di utente specificato. |
public abstract int getMaxNumberOfUsersSupported ()
Questo metodo è obsoleto.
utilizza getMaxNumberOfUsersSupported(String userType) per ottenere il numero massimo di
utenti supportati per un determinato tipo di utente.
Ottieni il numero massimo di utenti commutabili supportati, esclusi gli ospiti. Dopo la versione 36 dell'API, non include utenti non commutabili (come i profili). Il valore predefinito è 0.
| Resi |
|---|
int |
Un numero intero che indica il numero di utenti commutabili 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.
| Resi |
|---|
Integer |
l'ID utente dell'utente principale, se presente, e null in caso contrario. |
getRemainingCreatableUserCount
public abstract int getRemainingCreatableUserCount (String userType)
Restituisce il numero di utenti del tipo specificato che possono essere creati su questo dispositivo.
| Parametri |
|---|
userType |
String: il tipo di utente, come definito in UserManager, ad esempio
"android.os.usertype.full.SECONDARY". |
| Resi |
|---|
int |
il numero di utenti del tipo specificato che possono essere aggiunti |
getScreenshot
public abstract InputStreamSource getScreenshot (Long displayId,
String format,
boolean rescale)
Acquisisce uno screenshot dal dispositivo con l'ID display specificato nel formato supportato. Consenti il ridimensionamento per
supportare dimensioni più piccole
| Parametri |
|---|
displayId |
Long: l'ID display dello schermo da cui acquisire lo screenshot. |
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,
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 (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 (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 dello schermo da cui acquisire lo screenshot. |
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.
namespace deve essere uno dei seguenti: {"system", "secure", "global"}
| Parametri |
|---|
userId |
int |
namespace |
String |
key |
String |
| Resi |
|---|
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 Set<String> 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.
| Resi |
|---|
Set<String> |
Set dei nomi di pacchetto 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.
| Resi |
|---|
int |
i flag associati all'ID utente fornito, se trovato, -10000 in tutti gli altri casi. |
getUserInfos
public abstract Map<Integer, UserInfo> getUserInfos ()
Recupera la mappa di useId per UserInfo sul dispositivo. Genererà DeviceRuntimeException se l'output del dispositivo non è quello previsto.
| Resi |
|---|
Map<Integer, UserInfo> |
l'elenco degli oggetti UserInfo. |
| Genera |
|---|
|
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.
getUserVisibleOnDisplay
public abstract int getUserVisibleOnDisplay (int displayId)
Recupera l'ID utente dell'utente visibile sul display specificato.
| Parametri |
|---|
displayId |
int: l'ID del display. |
| Resi |
|---|
int |
l'ID utente dell'utente visibile sul display specificato. Non distingue un utente
in background visibile dall'utente in primo piano attuale, poiché entrambi i tipi sono visibili. Per
differenziare, confronta ulteriormente con il risultato di getCurrentUser(). |
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. |
| Resi |
|---|
boolean |
Vero se la funzionalità viene trovata, falso in caso contrario. |
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 di 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". |
| Resi |
|---|
String |
un String con un codice di errore o null in caso di esito positivo. |
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". |
| Resi |
|---|
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 di 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 per cui eseguire l'installazione. |
extraArgs |
String: argomenti aggiuntivi facoltativi da passare. Per le opzioni disponibili, vedi "adb shell pm -h". |
| Resi |
|---|
String |
un String con un codice di errore o null in caso di esito positivo. |
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 eseguire l'installazione. |
extraArgs |
String: argomenti aggiuntivi facoltativi da passare. Per le opzioni disponibili, vedi "adb shell pm -h". |
| Resi |
|---|
String |
un String con un codice di errore o null in caso di esito positivo. |
installPackageWithIncrementalMode
public abstract boolean installPackageWithIncrementalMode (File[] apkFiles,
String[] extraArgs,
String userId)
Installa APK con la modalità incrementale.
| Parametri |
|---|
apkFiles |
File: i file APK da installare. |
extraArgs |
String |
userId |
String |
installPackages
public String installPackages (List<File> packageFiles,
boolean reinstall,
String... extraArgs)
Installa un'app per 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 |
List: i file APK locali |
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". |
| Resi |
|---|
String |
un String con un codice di errore o null in caso di esito positivo. |
| Genera |
|---|
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 (List<File> packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Installa un'app per Android composta da diversi file APK (uno 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 di runtime al momento dell'installazione.
| Parametri |
|---|
packageFiles |
List: i percorsi dei file APK remoti 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". |
| Resi |
|---|
String |
un String con un codice di errore o null in caso di esito positivo. |
| Genera |
|---|
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 (List<File> packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
Installa un'app per 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" per
scoprire come dividere l'APK in più file.
| Parametri |
|---|
packageFiles |
List: i file APK locali |
reinstall |
boolean: true se deve essere eseguita una reinstallazione |
userId |
int: l'ID utente intero per cui eseguire l'installazione. |
extraArgs |
String: argomenti aggiuntivi facoltativi da passare. Per le opzioni disponibili, vedi "adb shell pm -h". |
| Resi |
|---|
String |
un String con un codice di errore o null in caso di esito positivo. |
| Genera |
|---|
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 (List<File> packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Installa un'app per 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" 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 di runtime al momento dell'installazione.
| Parametri |
|---|
packageFiles |
List: 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 eseguire l'installazione. |
extraArgs |
String: argomenti aggiuntivi facoltativi da passare. Per le opzioni disponibili, vedi "adb shell pm -h". |
| Resi |
|---|
String |
un String con un codice di errore o null in caso di esito positivo. |
| Genera |
|---|
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 ()
Restituisce un valore che indica se questo dispositivo supporta più utenti commutabili con accesso e
spazio personalizzabile.
Tieni presente che, anche se false, più utenti potrebbero comunque essere possibili, a condizione che non sia richiesta alcuna UI di accesso. Ad esempio, i profili potrebbero comunque essere supportati, in quanto non richiedono una UI di accesso.
Viene controllato anche config_enableMultiUserUI. Su richiesta, possiamo presumere che
i dispositivi per i quali questa condizione è vera siano configurati per consentire l'aggiunta di utenti secondari tramite ADB.
| Resi |
|---|
boolean |
se il dispositivo supporta più utenti commutabili. |
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 è attualmente
installato 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. |
| Resi |
|---|
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 |
| Resi |
|---|
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.
| Resi |
|---|
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.
| Resi |
|---|
boolean |
true se l'utente è secondario, false in caso contrario. |
isUserVisible
public abstract boolean isUserVisible (int userId)
Controlla se l'utente specificato è visibile.
Un utente "visibile" è un utente che interagisce con l'utente "umano" e quindi è in grado di
avviare attività di avvio (in genere nella visualizzazione predefinita).
isUserVisibleOnDisplay
public abstract boolean isUserVisibleOnDisplay (int userId,
int displayId)
Controlla se l'utente specificato è visibile nella visualizzazione specificata.
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.
| Resi |
|---|
boolean |
true se il Wi-Fi è attivo. false se disattivato |
listDisplayIds
public abstract Set<Long> listDisplayIds ()
Raccogli l'elenco degli ID display disponibili sul dispositivo come riportato da "dumpsys
SurfaceFlinger".
| Resi |
|---|
Set<Long> |
L'elenco dei display. Default restituisce sempre la visualizzazione predefinita 0. |
listDisplayIdsForStartingVisibleBackgroundUsers
public abstract Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()
Recupera l'elenco dei display che possono essere utilizzati per start a user visible in the background.
listUsers
public abstract ArrayList<Integer> listUsers ()
Recupera l'elenco degli utenti sul dispositivo. Genererà DeviceRuntimeException se l'output
del dispositivo non è quello previsto.
| Resi |
|---|
ArrayList<Integer> |
l'elenco degli ID utente. |
| Genera |
|---|
|
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. |
| Resi |
|---|
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 dall'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. |
| Resi |
|---|
boolean |
Vero se l'operazione è riuscita, falso in caso contrario. |
removeOwners
public abstract void removeOwners ()
Rimuovi tutti i proprietari dei profili dispositivo 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 |
| Resi |
|---|
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. |
| Resi |
|---|
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.
namespace 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 utente specificato 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 |
| Resi |
|---|
boolean |
true se l'utente è stato avviato correttamente in background. |
startUser
public abstract boolean startUser (int userId,
boolean waitFlag)
Avvia un utente specificato 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. |
| Resi |
|---|
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, consentendo 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. |
| Resi |
|---|
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 attuale e quello di sistema.
| Parametri |
|---|
userId |
int: dell'utente da arrestare. |
| Resi |
|---|
boolean |
true se l'utente è stato interrotto. |
stopUser
public abstract boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Interrompere un determinato utente. È possibile fornire flag aggiuntivi per attendere che l'operazione abbia effetto
e forzare la chiusura dell'utente. Impossibile interrompere l'utente attuale e quello di sistema.
| Parametri |
|---|
userId |
int: dell'utente da arrestare. |
waitFlag |
boolean: il comando attenderà finché l'utente non si sarà fermato. |
forceFlag |
boolean: forzerà l'interruzione dell'utente. |
| Resi |
|---|
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).
| Resi |
|---|
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 Keyguard dopo la modifica dell'utente.
| Parametri |
|---|
userId |
int |
timeout |
long: per attendere prima di restituire false per il cambio utente non riuscito. |
| Resi |
|---|
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 |
| Resi |
|---|
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. |
| Resi |
|---|
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 |
