Google si impegna a promuovere l'equità razziale per le comunità nere. Vedi come.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


Fornisce un'API di livello affidabile e leggermente superiore a un IDdice IDevice .

Riprova i comandi del dispositivo per un importo configurabile e fornisce un'interfaccia di ripristino del dispositivo per i dispositivi che non rispondono.

Sommario

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 mountpoint

enum ITestDevice.RecoveryMode

Metodi pubblici

abstract boolean checkConnectivity ()

Verificare che il dispositivo disponga di connettività di rete.

abstract boolean clearErrorDialogs ()

Tentare di chiudere tutte le finestre di dialogo di errore attualmente visualizzate sull'interfaccia utente del dispositivo.

abstract void clearLastConnectedWifiNetwork ()

Cancella l'ultima rete wifi connessa.

abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

Si collega a una rete wifi.

abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)

Si collega a una rete wifi.

abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)

Una variante di connectToWifiNetwork(String, String) che si connette solo se il dispositivo attualmente non dispone di connettività di rete.

abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)

Una variante di connectToWifiNetwork(String, String) che si connette solo se il dispositivo attualmente non dispone di connettività di rete.

abstract int createUser (String name)

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

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

Crea un utente con un determinato nome e i flag forniti

abstract int createUserNoThrow (String name)

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

abstract void disableKeyguard ()

Tentativi di disabilitare il blocco tastiera.

abstract boolean disableNetworkMonitor ()

Disabilita il monitoraggio della rete sul dispositivo.

abstract boolean disconnectFromWifi ()

Disconnette da una rete wifi.

abstract File dumpHeap (String process, String devicePath)

Tentativo di scaricare l'heap da system_server.

abstract boolean enableNetworkMonitor ()

Abilita il monitoraggio della rete sul dispositivo.

abstract getActiveApexes ()

Recupera le informazioni sugli APEX attivati ​​sul dispositivo.

abstract getAllSettings (String namespace)

Restituisce le coppie valore-chiave dello spazio dei nomi richiesto.

abstract String getAndroidId (int userId)

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

abstract getAndroidIds ()

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

abstract PackageInfo getAppPackageInfo (String packageName)

Recupera informazioni su un pacchetto installato sul dispositivo.

abstract int getCurrentUser ()

Restituisce l'id dell'utente corrente in esecuzione.

abstract getInstalledPackageNames ()

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

abstract String getIpAddress ()

Ottiene l'indirizzo IP del dispositivo.

abstract KeyguardControllerState getKeyguardState ()

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

abstract int getMaxNumberOfRunningUsersSupported ()

Ottieni il numero massimo di utenti supportati che eseguono contemporaneamente.

abstract int getMaxNumberOfUsersSupported ()

Ottieni il numero massimo di utenti supportati.

abstract TestDeviceOptions getOptions ()

Recupera le opzioni di test per il dispositivo.

abstract Integer getPrimaryUserId ()

Restituisce l'ID utente principale.

abstract InputStreamSource getScreenshot ()

Cattura uno screenshot dal dispositivo.

abstract InputStreamSource getScreenshot (String format, boolean rescale)

Cattura uno screenshot dal dispositivo.

abstract InputStreamSource getScreenshot (int displayId)

Cattura uno screenshot dall'ID di visualizzazione del dispositivo.

abstract InputStreamSource getScreenshot (String format)

Cattura uno screenshot dal dispositivo.

abstract String getSetting (String namespace, String key)

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

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

Restituisce il valore dell'impostazione richiesta.

abstract getUninstallablePackageNames ()

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

abstract int getUserFlags (int userId)

Trova e restituisce i flag di un determinato utente.

abstract getUserInfos ()

Ottiene la Mappa di useId per UserInfo sul dispositivo.

abstract int getUserSerialNumber (int userId)

Restituisce il numero seriale associato a userId se trovato, -10000 in tutti gli altri casi.

abstract boolean hasFeature (String feature)

Controlla se una funzione è disponibile su un dispositivo.

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

Installa un pacchetto Android sul dispositivo.

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

Installa un pacchetto Android sul dispositivo.

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

Installa un pacchetto Android sul dispositivo per un determinato utente.

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

Installa un pacchetto Android sul dispositivo per un determinato utente.

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

Installa un'applicazione Android composta da diversi file APK (uno principale e pacchetti di divisione extra).

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

Installa un'applicazione Android composta da diversi file APK (uno principale e pacchetti separati extra) che si trovano sul dispositivo Android.

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

Installa un'applicazione Android composta da diversi file APK (uno principale e pacchetti di divisione extra) per un determinato utente.

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

Installa un'applicazione Android composta da diversi file APK (uno principale e pacchetti di divisione extra) per un determinato utente.

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

Installa un'applicazione Android composta da diversi file APK (uno principale e pacchetti separati extra) che si trovano sul dispositivo Android.

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

Installa un'applicazione Android composta da diversi file APK (uno principale e pacchetti separati extra) che si trovano sul dispositivo Android.

abstract boolean isMultiUserSupported ()

Determina se il multiutente è supportato.

abstract boolean isPackageInstalled (String packageName)

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

abstract boolean isPackageInstalled (String packageName, String userId)

Richiedi al dispositivo un determinato nome di pacchetto e un determinato ID utente per verificare se è attualmente installato o meno per quell'utente.

abstract boolean isUserRunning (int userId)

Controlla se un determinato utente è in esecuzione.

abstract boolean isUserSecondary (int userId)

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

abstract boolean isWifiEnabled ()

Verifica se il wifi è abilitato.

abstract listDisplayIds ()

Raccogliere l'elenco degli ID di visualizzazione disponibili sul dispositivo come riportato da "dumpsys SurfaceFlinger".

abstract listUsers ()

Ottiene l'elenco degli utenti sul dispositivo.

abstract boolean removeAdmin (String componentName, int userId)

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

abstract void removeOwners ()

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

abstract boolean removeUser (int userId)

Rimuovi un determinato utente dal dispositivo.

abstract boolean setDeviceOwner (String componentName, int userId)

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

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

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

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

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

abstract boolean startUser (int userId)

Avvia un determinato utente in background se è attualmente arrestato.

abstract boolean startUser (int userId, boolean waitFlag)

Avvia un determinato utente in background se è attualmente arrestato.

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

Ferma un determinato utente.

abstract boolean stopUser (int userId)

Ferma un determinato utente.

abstract boolean switchUser (int userId)

Passa a un altro ID utente con un timeout predefinito.

abstract boolean switchUser (int userId, long timeout)

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

abstract String uninstallPackage (String packageName)

Disinstallare un pacchetto Android dal dispositivo.

Metodi pubblici

checkConnectivity

public abstract boolean checkConnectivity ()

Verificare che il dispositivo disponga di connettività di rete.

ritorna
boolean true se il dispositivo ha una connessione di rete funzionante, false eccesso.

Genera
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

Tentare di chiudere tutte le finestre di dialogo di errore attualmente visualizzate sull'interfaccia utente del dispositivo.

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

Genera
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

Cancella l'ultima rete wifi connessa. Questo dovrebbe essere chiamato quando si avvia una nuova chiamata per evitare la connessione alla rete wifi utilizzata nel test precedente dopo il riavvio del dispositivo.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Si collega a una rete wifi.

Attiva il wifi e si blocca fino a quando non viene stabilita una connessione corretta alla rete wifi specificata. Una volta stabilita una connessione, l'istanza proverà a ripristinare la connessione dopo ogni riavvio fino a quando ITestDevice#disconnectFromWifi() viene chiamato ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork() .

parametri
wifiSsid String : lo ssid wifi a cui connettersi

wifiPsk String : passphrase PSK o null se non crittografato

ritorna
boolean true se connesso correttamente alla rete wifi. false altrimenti

Genera
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Si collega a una rete wifi.

Attiva il wifi e si blocca fino a quando non viene stabilita una connessione corretta alla rete wifi specificata. Una volta stabilita una connessione, l'istanza proverà a ripristinare la connessione dopo ogni riavvio fino alla ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork() .

parametri
wifiSsid String : lo ssid wifi a cui connettersi

wifiPsk String : passphrase PSK o null se non crittografato

scanSsid boolean : se cercare SSID nascosto per questa rete.

ritorna
boolean true se connesso correttamente alla rete wifi. false altrimenti

Genera
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Una variante di connectToWifiNetwork(String, String) che si connette solo se il dispositivo attualmente non dispone di connettività di rete.

parametri
scanSsid boolean : se cercare SSID nascosto per questa rete

ritorna
boolean true se connesso correttamente alla rete wifi. false altrimenti

Genera
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Una variante di connectToWifiNetwork(String, String) che si connette solo se il dispositivo attualmente non dispone di connettività di rete.

ritorna
boolean true se connesso correttamente alla rete wifi. false altrimenti

Genera
DeviceNotAvailableException

creare un utente

public abstract int createUser (String name)

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

parametri
name String : dell'utente da creare sul dispositivo

ritorna
int il numero intero per l'id utente creato

Genera
DeviceNotAvailableException

creare un utente

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

Crea un utente con un determinato nome e i flag forniti

parametri
name String : dell'utente da creare sul dispositivo

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

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

ritorna
int ID dell'utente creato

Genera
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

parametri
name String : dell'utente da creare sul dispositivo

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

Genera
DeviceNotAvailableException

disableKeyguard

public abstract void disableKeyguard ()

Tentativi di disabilitare il blocco tastiera.

Prima attendi che l'invio dell'input sia pronto, ciò accade nello stesso momento in cui il dispositivo segnala BOOT_COMPLETE, apparentemente in modo asincrono, poiché l'attuale implementazione del framework presenta condizioni di gara occasionali. Quindi viene inviato il comando per chiudere il blocco tastiera (funziona solo su quelli non sicuri)

Genera
DeviceNotAvailableException

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

Disabilita il monitoraggio della rete sul dispositivo.

ritorna
boolean true se il monitoraggio è disabilitato correttamente. false se fallito.

Genera
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

Disconnette da una rete wifi.

Rimuove tutte le reti dall'elenco delle reti conosciute e disabilita il wifi.

ritorna
boolean true se disconnesso correttamente dalla rete wifi. false se la disconnessione non è riuscita.

Genera
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

dumpheap

public abstract File dumpHeap (String process, 
                String devicePath)

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

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

devicePath String : il percorso sul dispositivo in cui posizionare il dump. Questa deve essere una posizione in cui le autorizzazioni lo consentono.

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

Genera
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Abilita il monitoraggio della rete sul dispositivo.

ritorna
boolean true se il monitoraggio è abilitato correttamente. false se fallito.

Genera
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

getActiveApexes

public abstract  getActiveApexes ()

Recupera le informazioni sugli APEX attivati ​​sul dispositivo.

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

Genera
DeviceNotAvailableException

GetAllSettings

public abstract  getAllSettings (String namespace)

Restituisce le coppie valore-chiave dello spazio dei nomi richiesto.

parametri
namespace String : deve essere uno di {"system", "secure", "global"}

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

Genera
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

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

parametri
userId int

ritorna
String

Genera
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

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

ritorna
Mappa di ID Android trovati ID utente corrispondenti.

Genera
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

Recupera informazioni su un pacchetto installato sul dispositivo.

parametri
packageName String

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

Genera
DeviceNotAvailableException

GetCurrentUser

public abstract int getCurrentUser ()

Restituisce l'id dell'utente corrente in esecuzione.

ritorna
int

Genera
DeviceNotAvailableException
DeviceRuntimeException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

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

Genera
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Ottiene l'indirizzo IP del dispositivo.

ritorna
String l'indirizzo IP del dispositivo o null se il dispositivo non ha un indirizzo IP

Genera
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

ritorna
KeyguardControllerState un KeyguardControllerState contenente un'istantanea dello stato del keyguard e restituisce Null se la query di Keyguard non è supportata.

Genera
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

ritorna
int un numero intero che indica il numero di utenti che eseguono simultaneamente

Genera
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

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

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

Genera
DeviceNotAvailableException

GetOptions

public abstract TestDeviceOptions getOptions ()

Recupera le opzioni di test per il dispositivo.

ritorna
TestDeviceOptions TestDeviceOptions relative al dispositivo in prova.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Restituisce l'ID utente principale.

ritorna
Integer userId dell'utente primario, se presente, e null se non vi è alcun utente primario.

Genera
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException se l'uscita dal dispositivo non è come previsto.
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

Cattura uno screenshot dal dispositivo.

ritorna
InputStreamSource una InputStreamSource dello screenshot in formato png o null se lo screenshot non ha avuto esito positivo.

Genera
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

parametri
format String : PNG supportato, JPEG

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

ritorna
InputStreamSource una InputStreamSource dello screenshot in formato o null se lo screenshot non ha avuto esito positivo.

Genera
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (int displayId)

Cattura uno screenshot dall'ID di visualizzazione del dispositivo. Il formato è PNG.

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

parametri
displayId int : l'id di visualizzazione dello schermo per ottenere lo screenshot.

ritorna
InputStreamSource una InputStreamSource dello screenshot in formato o null se lo screenshot non ha avuto esito positivo.

Genera
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

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

parametri
format String : PNG supportato, JPEG

ritorna
InputStreamSource una InputStreamSource dello screenshot in formato o null se lo screenshot non ha avuto esito positivo.

Genera
DeviceNotAvailableException

GetSetting

public abstract String getSetting (String namespace, 
                String key)

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

parametri
namespace String

key String

ritorna
String

Genera
DeviceNotAvailableException

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

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

Genera
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

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

Genera
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

Trova e restituisce i flag di un determinato utente. I flag sono definiti nella classe "android.content.pm.UserInfo" nel progetto Open Source Android.

parametri
userId int

ritorna
int i flag associati a userId forniti se trovati, -10000 in tutti gli altri casi.

Genera
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

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

ritorna
l'elenco di oggetti UserInfo.

Genera
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

Restituisce il numero seriale associato a userId se trovato, -10000 in tutti gli altri casi.

parametri
userId int

ritorna
int

Genera
DeviceNotAvailableException

hasFeature

public abstract boolean hasFeature (String feature)

Controlla se una funzione è disponibile su un dispositivo.

parametri
feature String : quale formato dovrebbe essere "caratteristica: ".

ritorna
boolean Vero se viene trovata la funzione, falso altrimenti.

Genera
DeviceNotAvailableException

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 è necessario eseguire una reinstallazione

extraArgs String : argomenti extra facoltativi da passare. Vedi 'adb shell pm install --help' per le opzioni disponibili.

ritorna
String una String con un codice di errore o null caso di successo.

Genera
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

InstallPackage

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

Installa un pacchetto Android sul dispositivo.

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

parametri
packageFile File : il file apk da installare

reinstall boolean : true se è necessario eseguire una reinstallazione

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

extraArgs String : argomenti extra facoltativi da passare. Vedi 'adb shell pm install --help' per le opzioni disponibili.

ritorna
String una String con un codice di errore o null caso di successo.

Genera
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.
UnsupportedOperationException se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

installPackageForUser

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

Installa un pacchetto Android sul dispositivo per un determinato utente.

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

parametri
packageFile File : il file apk da installare

reinstall boolean : true se è necessario eseguire una reinstallazione

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

userId int : l'id utente intero da installare.

extraArgs String : argomenti extra facoltativi da passare. Vedi 'adb shell pm install --help' per le opzioni disponibili.

ritorna
String una String con un codice di errore o null caso di successo.

Genera
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.
UnsupportedOperationException se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

installPackageForUser

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

Installa un pacchetto Android sul dispositivo per un determinato utente.

parametri
packageFile File : il file apk da installare

reinstall boolean : true se è necessario eseguire una reinstallazione

userId int : l'id utente intero da installare.

extraArgs String : argomenti extra facoltativi da passare. Vedi 'adb shell pm install --help' per le opzioni disponibili.

ritorna
String una String con un codice di errore o null caso di successo.

Genera
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

InstallPackages

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

Installa un'applicazione Android composta da diversi file APK (uno principale e pacchetti di divisione extra). Vedi "https://developer.android.com/studio/build/configure-apk-splits" su come dividere l'apk in più file.

parametri
packageFiles : i file apk locali

reinstall boolean : true se è necessario eseguire una reinstallazione

extraArgs String : argomenti extra facoltativi da passare. Vedi 'adb shell pm install --help' per le opzioni disponibili.

ritorna
String una String con un codice di errore o null caso di successo.

Genera
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.
UnsupportedOperationException se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

InstallPackages

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

Installa un'applicazione Android composta da diversi file APK (uno principale e pacchetti separati extra) che si trovano sul dispositivo Android. Vedi "https://developer.android.com/studio/build/configure-apk-splits" su come dividere l'apk in più file.

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

parametri
packageFiles : i percorsi dei file apk remoti da installare

reinstall boolean : true se è necessario eseguire una reinstallazione

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

extraArgs String : argomenti extra facoltativi da passare. Vedi 'adb shell pm install --help' per le opzioni disponibili.

ritorna
String una String con un codice di errore o null caso di successo.

Genera
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.
UnsupportedOperationException se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

installPackagesForUser

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

Installa un'applicazione Android composta da diversi file APK (uno principale e pacchetti di divisione extra) per un determinato utente. Vedi "https://developer.android.com/studio/build/configure-apk-splits" su come dividere l'apk in più file.

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

parametri
packageFiles : i file apk locali

reinstall boolean : true se è necessario eseguire una reinstallazione

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

userId int : l'id utente intero da installare.

extraArgs String : argomenti extra facoltativi da passare. Vedi 'adb shell pm install --help' per le opzioni disponibili.

ritorna
String una String con un codice di errore o null caso di successo.

Genera
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.
UnsupportedOperationException se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

installPackagesForUser

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

Installa un'applicazione Android composta da diversi file APK (uno principale e pacchetti di divisione extra) per un determinato utente. Vedi "https://developer.android.com/studio/build/configure-apk-splits" su come dividere l'apk in più file.

parametri
packageFiles : i file apk locali

reinstall boolean : true se è necessario eseguire una reinstallazione

userId int : l'id utente intero da installare.

extraArgs String : argomenti extra facoltativi da passare. Vedi 'adb shell pm install --help' per le opzioni disponibili.

ritorna
String una String con un codice di errore o null caso di successo.

Genera
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.
UnsupportedOperationException se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

installRemotePackages

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

Installa un'applicazione Android composta da diversi file APK (uno principale e pacchetti separati extra) che si trovano sul dispositivo Android. Vedi "https://developer.android.com/studio/build/configure-apk-splits" su come dividere l'apk in più file.

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

parametri
remoteApkPaths : i percorsi dei file apk remoti

reinstall boolean : true se è necessario eseguire una reinstallazione

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

extraArgs String : argomenti extra facoltativi da passare. Vedi 'adb shell pm install --help' per le opzioni disponibili.

ritorna
String una String con un codice di errore o null caso di successo.

Genera
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.
UnsupportedOperationException se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

installRemotePackages

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

Installa un'applicazione Android composta da diversi file APK (uno principale e pacchetti separati extra) che si trovano sul dispositivo Android. Vedi "https://developer.android.com/studio/build/configure-apk-splits" su come dividere l'apk in più file.

parametri
remoteApkPaths : i percorsi dei file apk remoti

reinstall boolean : true se è necessario eseguire una reinstallazione

extraArgs String : argomenti extra facoltativi da passare. Vedi 'adb shell pm install --help' per le opzioni disponibili.

ritorna
String una String con un codice di errore o null caso di successo.

Genera
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.
UnsupportedOperationException se l'autorizzazione di runtime non è supportata dalla piattaforma sul dispositivo.

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

Determina se il multiutente è supportato.

ritorna
boolean vero se il multiutente è supportato, falso altrimenti

Genera
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

parametri
packageName String

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

Genera
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

Richiedi al dispositivo un determinato nome di pacchetto e un determinato ID utente per verificare se è attualmente installato o meno per quell'utente.

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

userId String : l'id utente per il quale stiamo controllando il pacchetto è installato. Se null, verrà utilizzato lo zero dell'utente primario.

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

Genera
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

Controlla se un determinato utente è in esecuzione.

parametri
userId int

ritorna
boolean Vero se l'utente è in esecuzione, falso in tutti gli altri casi.

Genera
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

parametri
userId int

ritorna
boolean vero se l'utente è secondario, falso altrimenti.

Genera
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Verifica se il wifi è abilitato.

Verifica se il wifi è abilitato sul dispositivo. Utile per affermare lo stato del wifi prima dei test che non dovrebbero essere eseguiti con il wifi, ad es. Test dei dati mobili.

ritorna
boolean true se il wifi è abilitato. false se disabilitato

Genera
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.

listDisplayIds

public abstract  listDisplayIds ()

Raccogliere l'elenco degli ID di visualizzazione disponibili sul dispositivo come riportato da "dumpsys SurfaceFlinger".

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

Genera
DeviceNotAvailableException

Listusers

public abstract  listUsers ()

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

ritorna
l'elenco degli ID utente.

Genera
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException
DeviceNotAvailableException

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

parametri
componentName String : String del dispositivo da rimuovere.

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

ritorna
boolean Vero se ha successo, falso altrimenti.

Genera
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

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

Genera
DeviceNotAvailableException

removeuser

public abstract boolean removeUser (int userId)

Rimuovi un determinato utente dal dispositivo.

parametri
userId int : dell'utente da rimuovere

ritorna
boolean vero se riuscissimo a rimuovere l'utente, falso altrimenti.

Genera
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

parametri
componentName String : String del dispositivo come proprietario del dispositivo.

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

ritorna
boolean Vero se ha successo, falso altrimenti.

Genera
DeviceNotAvailableException

setSetting

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

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

parametri
namespace String

key String

value String

Genera
DeviceNotAvailableException

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 il riavvio. lo spazio dei nomi deve essere uno dei seguenti: {"system", "secure", "global"}

parametri
userId int

namespace String

key String

value String

Genera
DeviceNotAvailableException

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 è NOOP.

parametri
userId int : dell'utente per iniziare in background

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

Genera
DeviceNotAvailableException

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 è NOOP. È possibile fornire un flag aggiuntivo per attendere che l'operazione abbia effetto.

parametri
userId int : dell'utente per iniziare in background

waitFlag boolean : farà attendere il comando fino all'avvio e allo sblocco dell'utente.

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

Genera
DeviceNotAvailableException

stopUser

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

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

parametri
userId int : dell'utente da interrompere.

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

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

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

Genera
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

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

parametri
userId int : dell'utente da interrompere.

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

Genera
DeviceNotAvailableException

cambia utente

public abstract boolean switchUser (int userId)

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

parametri
userId int

ritorna
boolean Vero se il nuovo ID utente corrisponde al provider ID utente. Falso altrimenti.

Genera
DeviceNotAvailableException

cambia utente

public abstract boolean switchUser (int userId, 
                long timeout)

Passa a un altro ID utente con il timeout fornito come scadenza. Tentare di disabilitare il blocco tastiera dopo che la modifica dell'utente ha avuto esito positivo.

parametri
userId int

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

ritorna
boolean Vero se il nuovo ID utente corrisponde al provider ID utente. Falso altrimenti.

Genera
DeviceNotAvailableException

uninstallPackage

public abstract String uninstallPackage (String packageName)

Disinstallare un pacchetto Android dal dispositivo.

parametri
packageName String : il pacchetto Android da disinstallare

ritorna
String una String con un codice di errore o null caso di successo.

Genera
DeviceNotAvailableException se la connessione con il dispositivo viene persa e non può essere ripristinata.