Dispositivo di test

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

Comandi utilizzabili per ignorare il blocco tastiera.

Dispositivo di test

public TestDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

CANNOT TRANSLATE

public boolean canSwitchToHeadlessSystemUser ()

Indica se è consentito passare all'utente SYSTEM headless.

Finestra di dialogo di errore

public boolean clearErrorDialogs ()

Prova a chiudere le eventuali finestre di dialogo di errore attualmente visualizzate nell'interfaccia utente del dispositivo.

CreaUtente

public int createUser (String name)

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

CreaUtente

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

Crea un utente con un determinato nome e i flag forniti

CreaUtente

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

Crea un utente con un determinato nome e i flag forniti

CreaUtenteNoThrow

public int createUserNoThrow (String name)

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

disattiva KeyGuard

public void disableKeyguard ()

Tenta di disattivare il blocco della tastiera.

Prima di tutto attendi che l'invio di input sia pronto, questo avviene più o meno nello stesso momento in cui dispositivo segnala BOOT_COMPLETE, apparentemente in modo asincrono, perché il framework attuale l'implementazione presenta race condizione occasionali. Viene quindi inviato un comando per ignorare il blocco tastiera (funziona solo su quelle non sicure)

fileExist

public boolean doesFileExist (String deviceFilePath)

Metodo di supporto per determinare se il file esiste sul dispositivo.

fileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

Metodo di supporto per determinare se esiste un file sul dispositivo per un determinato utente.

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Tenta di eseguire il dump dell'heap da system_server. È responsabilità del chiamante ripulire del file di cui è stato eseguito il dump.

getActiveApexes

public  getActiveApexes ()

Recupera le informazioni sugli APEX attivati sul dispositivo.

getAllSettings

public  getAllSettings (String namespace)

Restituisce coppie chiave-valore dello spazio dei nomi richiesto.

getAndroidId

public String getAndroidId (int userId)

Trova e restituisci l'android-id associato a un userId, null se non trovato.

getAndroidId

public  getAndroidIds ()

Crea una mappa degli ID Android trovati con ID utente corrispondenti. Non esiste alcuna assicurazione che ogni utente id troverà un ID Android associato in questa funzione, pertanto alcuni ID utente potrebbero corrispondere a un valore nullo.

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Recupera informazioni su un pacchetto installato sul dispositivo.

getAppPackageInfos

public  getAppPackageInfos ()

Recupera informazioni sui pacchetti installati sul dispositivo.

getBugreport

public InputStreamSource getBugreport ()

Recupera una segnalazione di bug dal dispositivo.

L'implementazione di questa funzionalità garantisce che il dispositivo continui a funzionare su un dispositivo privo di scheda SD (o nel punto in cui la scheda SD non è ancora montata).

getBugreportz

public InputStreamSource getBugreportz ()

Recupera una segnalazione di bug dal dispositivo. La segnalazione di bug in formato ZIP contiene la segnalazione di bug principale e altri file di log utili per il debug.

Supportata solo per la "versione adb" > 1,0.36

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Restituisce l'attuale stato pieghevole del dispositivo o nullo se si sono verificati alcuni problemi.

getCurrentUser

public int getCurrentUser ()

Restituisce l'ID dell'utente corrente in esecuzione. In caso di errore, restituisci -10000.

getFoldableStates

public  getFoldableStates ()

Restituisce l'elenco di stati pieghevoli sul dispositivo. Può essere ottenuto con "cmd device_state" stati di stampa".

getInstallaPackageNames

public  getInstalledPackageNames ()

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

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Restituisci un oggetto per ottenere lo stato attuale del blocco della tastiera o null se non supportato.

getMainUserId

public Integer getMainUserId ()

Restituisce l'ID utente principale.

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Recupera le informazioni sui moduli di linea principali installati sul dispositivo.

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

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

IDUtentePrincipale

public Integer getPrimaryUserId ()

Restituisce l'ID utente principale.

getScreenshot

public InputStreamSource getScreenshot ()

Acquisisce uno screenshot dal dispositivo.

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

Acquisisce uno screenshot dal dispositivo. È consigliabile usare invece getScreenshot(String) con codifica JPEG per dimensioni inferiori.

getScreenshot

public InputStreamSource getScreenshot (String format)

Acquisisce uno screenshot dal dispositivo. Si consiglia di utilizzare getScreenshot(format) con codifica JPEG per dimensioni inferiori

getScreenshot

public InputStreamSource getScreenshot (long displayId)

Recupera uno screenshot dall'ID display del dispositivo specificato. Il formato è PNG.

DA FARE: estendi le implementazioni precedenti per supportare il "formato" e poi scalare

getImpostazione

public String getSetting (String namespace, 
                String key)

Vedi getSetting(int, String, String) ed eseguita sull'utente del sistema.

getImpostazione

public 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"}

getDisinstallaablePackageNames

public  getUninstallablePackageNames ()

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

Flag User

public int getUserFlags (int userId)

Trova e restituisci i flag di un determinato utente. I flag sono definiti in "android.content.pm.UserInfo" nel progetto open source Android.

OttieniInfoUtente

public  getUserInfos ()

Recupera la mappa di useId per UserInfo sul dispositivo. Se l'output dal dispositivo non è quello previsto, verrà generato DeviceRuntimeException.

getUserSerialNumber

public int getUserSerialNumber (int userId)

Restituisce il numero di serie associato allo userId, se trovato, -10000 in tutti gli altri casi.

hasFeature

public boolean hasFeature (String feature)

Controlla se una funzionalità è disponibile su un dispositivo.

installPackage

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

Installa un pacchetto Android sul dispositivo.

installPackage

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

Installa un pacchetto Android sul dispositivo.

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

installPackage

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

Installa un pacchetto Android sul dispositivo.

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

installPackageForUser

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

Installa un pacchetto Android sul dispositivo di un determinato utente.

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

installPackageForUser

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

Installa un pacchetto Android sul dispositivo di un determinato utente.

installPackages

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

installPackages

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

installPackagesForUser

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

installPackagesForUser

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

installRemotePackages

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

installRemotePackages

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

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

Controllare se la piattaforma sul dispositivo supporta l'enumerazione delle app

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

Indica se il dispositivo utilizza la modalità utente di sistema headless.

èAmministratorePermanenteUtentePrincipale

public boolean isMainUserPermanentAdmin ()

Indica se l'utente principale è un amministratore permanente e non può essere eliminato o eseguito il downgrade a non amministratore.

isMultiUserSupported

public boolean isMultiUserSupported ()

Determina se la funzionalità multiutente è supportata.

èPacchettoInstallato

public boolean isPackageInstalled (String packageName)

Esegui una query sul dispositivo per trovare un determinato nome di pacchetto per verificare se il pacchetto è attualmente installato o meno.

èPacchettoInstallato

public boolean isPackageInstalled (String packageName, 
                String userId)

Esegui una query sul dispositivo per trovare un dato nome pacchetto e un dato ID utente per verificare se al momento installato o meno per quell'utente.

èIn esecuzioneUtente

public boolean isUserRunning (int userId)

Verificare se un determinato utente è in esecuzione.

èUtenteSecondario

public boolean isUserSecondary (int userId)

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

UtenteVisibile

public boolean isUserVisible (int userId)

Controlla se l'utente specificato è visibile.

Un "visibile" l'utente è un utente che sta interagendo con l'"umano" all'utente e, di conseguenza, può avviare attività di avvio (di solito, nella visualizzazione predefinita).

UtenteVisibileSuDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Controlla se l'utente è visibile sul display specificato.

Un "visibile" l'utente è un utente che sta interagendo con l'"umano" all'utente e, di conseguenza, può avviare attività di lancio in quel display.

isVisibileBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Indica se il dispositivo consente agli utenti di essere avviati visibili in background in ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

In caso affermativo, potresti chiamare startVisibleBackgroundUser(int, int, boolean), superando un display restituito da listDisplayIdsForStartingVisibleBackgroundUsers() (che deve includere ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

èVisibileUtentiSfondoSupportato

public boolean isVisibleBackgroundUsersSupported ()

Indica se il dispositivo consente agli utenti di essere avviati visibili in background.

In caso affermativo, potresti chiamare startVisibleBackgroundUser(int, int, boolean), superando un display restituito da listDisplayIdsForStartingVisibleBackgroundUsers().

listDisplayId

public  listDisplayIds ()

Raccogli l'elenco degli ID dei display disponibili sul dispositivo segnalato da "dumpsys SurfaceFlinger".

listDisplayIdsForStartingVisibilityBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

Recupera l'elenco di display che possono essere utilizzati per start a user visible in the background.

elencoUtenti

public  listUsers ()

Recupera l'elenco di utenti presenti sul dispositivo. Se output verrà generato DeviceRuntimeException dal dispositivo non è come previsto.

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

Metodo di supporto per inviare una segnalazione di bug e registrarla agli autori di segnalazioni.

avvisaSnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

postInvocationTeardown

public void postInvocationTearDown (Throwable exception)

Passaggi aggiuntivi per la pulizia specifica del dispositivo che verranno eseguiti dopo la chiamata al termine dell'operazione.

rimuovereAmministratore

public boolean removeAdmin (String componentName, 
                int userId)

Rimuovi l'amministratore del dispositivo specificato per l'utente e restituisci true se l'operazione ha esito positivo, false in caso contrario.

rimuoviProprietari

public void removeOwners ()

Rimuovi tutti i proprietari di profili esistenti del dispositivo con il massimo impegno.

rimuovereUtente

public boolean removeUser (int userId)

Rimuovere un determinato utente dal dispositivo.

impostaProprietarioDispositivo

public boolean setDeviceOwner (String componentName, 
                int userId)

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

impostazioniImpostazione

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

Vedi setSetting(int, String, String, String) ed eseguita sull'utente del sistema.

impostazioniImpostazione

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

Aggiungi un valore di impostazione allo spazio dei nomi di un determinato utente. Alcune impostazioni saranno disponibili solo dopo un riavvio. lo spazio dei nomi deve essere uno dei seguenti: {"system", "secure", "global"}

ChiusuraMicrodroide

public void shutdownMicrodroid (ITestDevice microdroidDevice)

Arresta il microdroide, se presente.

UtenteInizio

public boolean startUser (int userId)

Avvia un determinato utente in background se al momento è arrestato. Se l'utente è già in esecuzione in background, questo metodo è un NOOP.

UtenteInizio

public boolean startUser (int userId, 
                boolean waitFlag)

Avvia un determinato utente in background se al momento è arrestato. Se l'utente è già in esecuzione in background, questo metodo è un NOOP. È possibile fornire un flag aggiuntivo da attendere che l'operazione abbia effetto.

inizioVisibileUtenteSfondo

public boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

Avvia un determinato utente in background, visibile sul display specificato (ad esempio, consentendo all'utente per 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.

Utente bloccato

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

Interrompere un determinato utente. È possibile fornire flag aggiuntivi per attendere l'efficacia dell'operazione. e forzare la chiusura dell'utente. Impossibile interrompere l'utente corrente e di sistema.

Utente bloccato

public boolean stopUser (int userId)

Arresta un determinato utente. Se l'utente è già stato interrotto, questo metodo è un NOOP. Impossibile interrompere l'utente corrente e di sistema.

supportaMicrodroide

public boolean supportsMicrodroid ()

Controlla le condizioni preliminari per eseguire un microdroide.

supportaMicrodroide

public boolean supportsMicrodroid (boolean protectedVm)

Controlla le condizioni preliminari per eseguire un microdroide.

cambiautente

public boolean switchUser (int userId)

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

cambiautente

public boolean switchUser (int userId, 
                long timeout)

Passa a un altro userId con il timeout fornito come scadenza. Tentativo di disattivare il blocco della tastiera dopo che la modifica dell'utente è andata a buon fine.

prendereBugreport

public Bugreport takeBugreport ()

Prendi una segnalazione di bug e restituila 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 cancellato tramite Bugreport.close().

disinstalla il pacchetto

public String uninstallPackage (String packageName)

Disinstalla un pacchetto Android dal dispositivo.

disinstallaPacchettoPerUtente

public String uninstallPackageForUser (String packageName, 
                int userId)

Disinstalla un pacchetto Android dal dispositivo per un determinato utente.

attendeSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

creareanalizzatore

protected AaptParser createParser (File appFile)

doAdbRiavvia

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

Esegui un riavvio ADB.

getBugreportInternal

protected InputStreamSource getBugreportInternal ()

getBugreportzInterno

protected File getBugreportzInternal ()

Metodo di helper interno per ottenere il file ZIP bugreportz come ERROR(/File).

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

Esposizione per i test.

getHostAttuale

protected long getHostCurrentTime ()

Esposizione per i test

Configurazione prePostBoot

protected void prePostBootSetup ()

Consente a ogni tipo di dispositivo (Android NativeDevice, TestDevice) di eseguire l'override di questo metodo per una specifica configurazione post-avvio.