Dispositivo di prova

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

Comandi che possono essere utilizzati per disattivare lo scudo tastiera.

Dispositivo di prova

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

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Restituisce se è consentito passare all'utente SYSTEM senza testa.

clearErrorDialogs

public boolean clearErrorDialogs ()

Tentare di eliminare eventuali finestre di dialogo di errore attualmente visualizzate sull'interfaccia utente del dispositivo.

creare un utente

public int createUser (String name)

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

creare un utente

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

Crea un utente con un determinato nome e i flag forniti

creare un utente

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

Crea un utente con un determinato nome e i flag forniti

createUserNoThrow

public int createUserNoThrow (String name)

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

disabilitaKeyguard

public void disableKeyguard ()

Tenta di disattivare lo scudo tastiera.

Per prima cosa attendi che l'invio dell'input sia pronto, ciò avviene più o meno nello stesso momento in cui il dispositivo segnala BOOT_COMPLETE, apparentemente in modo asincrono, perché l'attuale implementazione del framework presenta condizioni di competizione occasionali. Quindi viene inviato il comando per rimuovere lo scudo tastiera (funziona solo su quelli non sicuri)

faFileExist

public boolean doesFileExist (String deviceFilePath)

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

faFileExist

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)

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

getActiveApex

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 restituisce l'ID Android associato a un userId, null se non trovato.

getAndroidId

public  getAndroidIds ()

Crea una mappa degli ID Android trovati corrispondenti agli ID utente. Non vi è alcuna garanzia che ciascun ID utente trovi un ID Android associato a questa funzione, quindi alcuni ID utente potrebbero corrispondere a null.

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Recupera informazioni su un pacchetto installato sul dispositivo.

getAppPackageInfos

public  getAppPackageInfos ()

Recupera le informazioni sui pacchetti installati sul dispositivo.

getBugrereport

public InputStreamSource getBugreport ()

Recupera una segnalazione di bug dal dispositivo.

L'implementazione di questo garantisce che continui a funzionare su un dispositivo senza scheda SD (o dove la scheda SD non è ancora montata).

getBugreportz

public InputStreamSource getBugreportz ()

Recupera una segnalazione di bug dal dispositivo. Il bugreport in formato zip contiene il bugreport principale e altri file di registro utili per il debug.

Supportato solo per la 'versione adb' > 1.0.36

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Restituisce lo stato pieghevole corrente del dispositivo o null se si sono verificati alcuni problemi.

getCurrentUser

public int getCurrentUser ()

Restituisce l'id dell'utente attualmente in esecuzione. In caso di errore, restituisce -10000.

getFoldableStates

public  getFoldableStates ()

Restituisce l'elenco degli stati pieghevoli nel dispositivo. Può essere ottenuto con "cmd device_state print-states".

getInstalledPackageNames

public  getInstalledPackageNames ()

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

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Restituisce un oggetto per ottenere lo stato corrente dello scudo tastiera o null se non supportato.

getIdUtenteMain

public Integer getMainUserId ()

Restituisce l'ID utente principale.

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Ottieni informazioni sui moduli della linea principale installati sul dispositivo.

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

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

getPrimaryUserId

public Integer getPrimaryUserId ()

Restituisce l'ID utente principale.

getScreenshot

public InputStreamSource getScreenshot ()

Cattura uno screenshot dal dispositivo.

getScreenshot

public 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.

getScreenshot

public InputStreamSource getScreenshot (String format)

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

getScreenshot

public InputStreamSource getScreenshot (long displayId)

Cattura uno screenshot dal dispositivo a cui è stato fornito l'ID di visualizzazione. Il formato è PNG.

TODO: estendere le implementazioni di cui sopra per supportare 'formattazione' e 'ridimensionamento'

getSetting

public String getSetting (String namespace, 
                String key)

Vedere getSetting(int, String, String) ed eseguito sull'utente del sistema.

getSetting

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

Restituisce il valore dell'impostazione richiesta. lo spazio dei nomi deve essere uno tra: {"system", "secure", "global"}

getUninstallablePackageNames

public  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.

getUserFlags

public 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 Android Open Source.

getUserInfos

public  getUserInfos ()

Ottiene la mappa di useId in UserInfo nel dispositivo. Lancerà DeviceRuntimeException se l'output dal dispositivo non è quello previsto.

getUserSerialNumber

public int getUserSerialNumber (int userId)

Restituisce il numero seriale associato allo userId se trovato, -10000 negli altri casi.

hasFeature

public boolean hasFeature (String feature)

Controlla se una funzionalità è disponibile su un dispositivo.

installPacchetto

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

Installa un pacchetto Android sul dispositivo.

installPacchetto

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 momento dell'installazione dovrebbero chiamare questa funzione.

installPacchetto

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 momento dell'installazione dovrebbero chiamare questa funzione.

installPackageForUser

public 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 dovrebbero chiamare questa funzione.

installPackageForUser

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

Installa un pacchetto Android sul dispositivo per 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)

installareRemotePackages

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

installareRemotePackages

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

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

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

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

Restituisce se il dispositivo utilizza la modalità utente del sistema headless.

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

Indica se l'utente principale è un amministratore permanente e non può essere eliminato o declassato allo stato non amministratore.

è multiutente supportato

public boolean isMultiUserSupported ()

Determina se è supportato il multiutente.

isPackageInstalled

public boolean isPackageInstalled (String packageName)

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

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

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

isUserRunning

public boolean isUserRunning (int userId)

Controlla se un determinato utente è in esecuzione.

isUserSecondary

public boolean isUserSecondary (int userId)

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

isUserVisible

public 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 lancio (in genere nella visualizzazione predefinita).

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Controlla se l'utente specificato è visibile nel display specificato.

Un utente "visibile" è un utente che interagisce con l'utente "umano" e quindi è in grado di avviare attività di lancio in quella visualizzazione.

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

In tal caso, è possibile chiamare startVisibleBackgroundUser(int, int, boolean) , passando un display restituito da listDisplayIdsForStartingVisibleBackgroundUsers() (che dovrebbe includere ERROR(/java.android.view.Display#DEFAULT_DISPLAY) ).

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

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

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

listDisplayId

public  listDisplayIds ()

Raccogli l'elenco degli ID display disponibili sul dispositivo come riportato da "dumpsys SurfaceFlinger".

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

Ottiene l'elenco delle visualizzazioni che possono essere utilizzate per start a user visible in the background .

listUsers

public  listUsers ()

Ottiene l'elenco degli utenti nel dispositivo. Lancerà DeviceRuntimeException se l'output dal dispositivo non è quello previsto.

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

Metodo di supporto per acquisire una segnalazione di bug e registrarla per i reporter.

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

Passaggi aggiuntivi per la pulizia richiesta specifica del dispositivo che verranno eseguiti al termine della chiamata.

rimuoviAdmin

public boolean removeAdmin (String componentName, 
                int userId)

Rimuovi l'amministratore del dispositivo in un determinato utente e restituisci true se l'operazione ha esito positivo, false altrimenti.

rimuoviProprietari

public void removeOwners ()

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

rimuoviUser

public boolean removeUser (int userId)

Rimuovi un determinato utente dal dispositivo.

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

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

setImpostazione

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

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

setImpostazione

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 tra: {"system", "secure", "global"}

shutdownMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

Spegne il dispositivo microdroid, se ne esiste uno.

startUser

public boolean startUser (int userId)

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

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

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

startVisibleBackgroundUser

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

Avvia un determinato utente in background, visibile in un determinato display (ovvero, consentendo all'utente di avviare attività in quel display).

NOTA: questo comando non controlla se l'utente esiste, il display è disponibile, device supports such feature , ecc.

stopUser

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

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

stopUser

public boolean stopUser (int userId)

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

supportaMicrodroid

public boolean supportsMicrodroid ()

Controlla i prerequisiti per eseguire un microdroid.

supportaMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

Controlla i prerequisiti per eseguire un microdroid.

cambia utente

public boolean switchUser (int userId)

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

cambia utente

public boolean switchUser (int userId, 
                long timeout)

Passa a un altro ID utente con il timeout fornito come scadenza. Tentativo di disattivare lo scudo tastiera dopo che la modifica dell'utente è riuscita.

takeBugrereport

public 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 si fa riferimento nell'oggetto Bugreport deve essere pulito tramite Bugreport.close() .

uninstallPackage

public String uninstallPackage (String packageName)

Disinstallare un pacchetto Android dal dispositivo.

disinstallarePackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

Disinstalla un pacchetto Android dal dispositivo per un determinato utente.

createParser

protected AaptParser createParser (File appFile)

doAdbReboot

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

Esegui un riavvio adb.

getBugreportInternal

protected InputStreamSource getBugreportInternal ()

getBugreportzInternal

protected File getBugreportzInternal ()

Metodo di supporto interno per ottenere il file zip bugreportz come ERROR(/File) .

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

Esposto per test.

getHostCurrentTime

protected long getHostCurrentTime ()

Esposto per test

prePostBootSetup

protected void prePostBootSetup ()

Consente a ciascun tipo di dispositivo (AndroidNativeDevice, TestDevice) di sovrascrivere questo metodo per una specifica configurazione post-avvio.