A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release anziché aosp-main per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.

Questa pagina è stata tradotta dall'API Cloud Translation.

ProcessUtil

public final class ProcessUtil
extends Object

java.lang.Object
↳	com.android.sts.common.ProcessUtil

Vari helper per trovare, attendere e terminare i processi sul dispositivo

Riepilogo

Classi nidificate
`class`	`ProcessUtil.KillException`

Costanti
`long`	`PROCESS_POLL_PERIOD_MS`
`long`	`PROCESS_WAIT_TIMEOUT_MS`

Metodi pubblici
`static Optional<IFileEntry>`	`findFileLoadedByProcess(ITestDevice device, String process, String filenameSubstr)` Restituisce la voce del file del primo file caricato dal processo specificato con il nome specificato
`static Optional<List<String>>`	`findFilesLoadedByProcess(ITestDevice device, int pid, Pattern filePattern)` Restituisce i nomi dei file specificati, caricati dal processo specificato.
`static Optional<String>`	`getProcessName(ITestDevice device, int pid)` Recupera i contenuti da /proc/pid/cmdline.
`static boolean`	`killAll(ITestDevice device, String pgrepRegex, long timeoutMs, boolean expectExist)` Invia SIGKILL a tutti i processi corrispondenti a un pattern.
`static boolean`	`killAll(ITestDevice device, String pgrepRegex, long timeoutMs)` Invia SIGKILL a tutti i processi corrispondenti a un pattern.
`static void`	`killPid(ITestDevice device, int pid, long timeoutMs)` Invia SIGKILL a un processo e attendi che venga chiuso.
`static void`	`killPid(ITestDevice device, int pid, int signal, long timeoutMs)` Invia un segnale a un processo e attendi che venga chiuso.
`static Optional<List<String>>`	`listOpenFiles(ITestDevice device, int pid)` Restituisce i nomi dei file attualmente aperti del processo specificato.
`static Optional<Integer>`	`pidOf(ITestDevice device, String pgrepRegex)` Recupera un singolo pid corrispondente a un pattern passato a "pgrep".
`static Optional<Map<Integer, String>>`	`pidsOf(ITestDevice device, String pgrepRegex)` Recupera i pid corrispondenti a un pattern passato a "pgrep".
`static void`	`waitPidExited(ITestDevice device, int pid)` Attendi l'uscita da un processo.
`static void`	`waitPidExited(ITestDevice device, int pid, long timeoutMs)` Attendi l'uscita da un processo.
`static Map<Integer, String>`	`waitProcessRunning(ITestDevice device, String pgrepRegex, long timeoutMs)` Attendi fino a quando non viene trovato un processo in esecuzione per una determinata regex.
`static Map<Integer, String>`	`waitProcessRunning(ITestDevice device, String pgrepRegex)` Attendi fino a quando non viene trovato un processo in esecuzione per una determinata regex.
`static AutoCloseable`	`withProcessKill(ITestDevice device, String pgrepRegex, Runnable beforeCloseKill, long timeoutMs)` Uccidere un processo all'inizio e alla fine di un test.
`static AutoCloseable`	`withProcessKill(ITestDevice device, String pgrepRegex, Runnable beforeCloseKill)` Uccidere un processo all'inizio e alla fine di un test.

Costanti

PROCESS_POLL_PERIOD_MS

public static final long PROCESS_POLL_PERIOD_MS

Valore costante: 250 (0x00000000000000fa)

PROCESS_WAIT_TIMEOUT_MS

public static final long PROCESS_WAIT_TIMEOUT_MS

Valore costante: 10000 (0x0000000000002710)

Metodi pubblici

findFileLoadedByProcess

public static Optional<IFileEntry> findFileLoadedByProcess (ITestDevice device, 
                String process, 
                String filenameSubstr)

Restituisce la voce del file del primo file caricato dal processo specificato con il nome specificato

Parametri
`device`	`ITestDevice`: dispositivo su cui eseguire il comando
`process`	`String`: pattern pgrep del processo da cercare
`filenameSubstr`	`String`: parte del nome/del percorso del file caricato dal processo

Ritorni
`Optional<IFileEntry>`	Un elemento facoltativo di IFileEntry del percorso del file sul dispositivo, se esistente.

Lanci
`DeviceNotAvailableException`

findFilesLoadedByProcess

public static Optional<List<String>> findFilesLoadedByProcess (ITestDevice device, 
                int pid, 
                Pattern filePattern)

Restituisce i nomi dei file specificati, caricati dal processo specificato.

Parametri
`device`	`ITestDevice`: dispositivo su cui eseguire il comando
`pid`	`int`: l'ID del processo da cercare
`filePattern`	`Pattern`: un pattern dei nomi dei file da restituire

Ritorni
`Optional<List<String>>`	Un valore facoltativo dei file filtrati; vuoto se il processo non è stato trovato o se non è stato possibile leggere i file aperti.

Lanci
`DeviceNotAvailableException`

getProcessName

public static Optional<String> getProcessName (ITestDevice device, 
                int pid)

Recupera i contenuti da /proc/pid/cmdline.

Parametri
`device`	`ITestDevice`: il dispositivo da utilizzare
`pid`	`int`: l'ID del processo di cui recuperare il nome

Ritorni
`Optional<String>`	Una stringa facoltativa dei contenuti di /proc/pid/cmdline; vuota se non è stato possibile trovare il pid

Lanci
`DeviceNotAvailableException`

killAll

public static boolean killAll (ITestDevice device, 
                String pgrepRegex, 
                long timeoutMs, 
                boolean expectExist)

Invia SIGKILL a tutti i processi corrispondenti a un pattern.

Parametri
`device`	`ITestDevice`: il dispositivo da utilizzare
`pgrepRegex`	`String`: una stringa che rappresenta l'espressione regolare per pgrep
`timeoutMs`	`long`: il tempo di attesa prima di lanciare un'eccezione TimeoutException
`expectExist`	`boolean`: indica se deve essere lanciata un'eccezione quando non sono stati interrotti processi

Ritorni
`boolean`	se sono stati interrotti processi

Lanci
`DeviceNotAvailableException`
`TimeoutException`
`ProcessUtil.KillException`

killAll

public static boolean killAll (ITestDevice device, 
                String pgrepRegex, 
                long timeoutMs)

Invia SIGKILL a tutti i processi corrispondenti a un pattern.

Parametri
`device`	`ITestDevice`: il dispositivo da utilizzare
`pgrepRegex`	`String`: una stringa che rappresenta l'espressione regolare per pgrep
`timeoutMs`	`long`: il tempo di attesa prima di lanciare un'eccezione TimeoutException

Ritorni
`boolean`	se sono stati interrotti processi

Lanci
`DeviceNotAvailableException`
`TimeoutException`
`ProcessUtil.KillException`

killPid

public static void killPid (ITestDevice device, 
                int pid, 
                long timeoutMs)

Invia SIGKILL a un processo e attendi che venga chiuso.

Parametri
`device`	`ITestDevice`: il dispositivo da utilizzare
`pid`	`int`: l'ID del processo in attesa dell'uscita
`timeoutMs`	`long`: il tempo di attesa prima di lanciare un'eccezione TimeoutException

Lanci
`DeviceNotAvailableException`
`TimeoutException`
`ProcessUtil.KillException`

killPid

public static void killPid (ITestDevice device, 
                int pid, 
                int signal, 
                long timeoutMs)

Invia un segnale a un processo e attendi che venga chiuso.

Parametri
`device`	`ITestDevice`: il dispositivo da utilizzare
`pid`	`int`: l'ID del processo in attesa dell'uscita
`signal`	`int`: l'indicatore da inviare al processo
`timeoutMs`	`long`: il tempo di attesa prima di lanciare un'eccezione TimeoutException

Lanci
`DeviceNotAvailableException`
`TimeoutException`
`ProcessUtil.KillException`

listOpenFiles

public static Optional<List<String>> listOpenFiles (ITestDevice device, 
                int pid)

Restituisce i nomi dei file attualmente aperti del processo specificato.

Parametri
`device`	`ITestDevice`: dispositivo su cui eseguire il comando
`pid`	`int`: l'ID del processo da cercare

Ritorni
`Optional<List<String>>`	Un Optional dei file aperti; vuoto se il processo non è stato trovato o se non è stato possibile leggere i file aperti.

Lanci
`DeviceNotAvailableException`

pidOf

public static Optional<Integer> pidOf (ITestDevice device, 
                String pgrepRegex)

Recupera un singolo pid corrispondente a un pattern passato a "pgrep". Genera un IllegalArgumentException quando sono presenti più PID corrispondenti al pattern.

Parametri
`device`	`ITestDevice`: il dispositivo da utilizzare
`pgrepRegex`	`String`: una stringa che rappresenta l'espressione regolare per pgrep

Ritorni
`Optional<Integer>`	Un numero intero facoltativo del pid; vuoto se pgrep non ha restituito EXIT_SUCCESS

Lanci
`DeviceNotAvailableException`
`IllegalArgumentException`

pidsOf

public static Optional<Map<Integer, String>> pidsOf (ITestDevice device, 
                String pgrepRegex)

Recupera i pid corrispondenti a un pattern passato a "pgrep". Poiché /proc/pid/comm è troncato, "pgrep" viene passato con "-f" per controllare la riga di comando completa.

Parametri
`device`	`ITestDevice`: il dispositivo da utilizzare
`pgrepRegex`	`String`: una stringa che rappresenta l'espressione regolare per pgrep

Ritorni
`Optional<Map<Integer, String>>`	una mappa facoltativa del pid alla riga di comando; vuota se pgrep non ha restituito EXIT_SUCCESS

Lanci
`DeviceNotAvailableException`

waitPidExited

public static void waitPidExited (ITestDevice device, 
                int pid)

Attendi l'uscita da un processo. Non si tratta di aspettare che cambi, ma semplicemente di non essere presente. È possibile, ma improbabile, che un pid venga riutilizzato tra un sondaggio e l'altro

Parametri
`device`	`ITestDevice`: il dispositivo da utilizzare
`pid`	`int`: l'ID del processo in attesa dell'uscita

Lanci
`TimeoutException`
`DeviceNotAvailableException`
`ProcessUtil.KillException`

waitPidExited

public static void waitPidExited (ITestDevice device, 
                int pid, 
                long timeoutMs)

Attendi l'uscita da un processo. Non si tratta di aspettare che cambi, ma semplicemente di non essere presente. È possibile, ma improbabile, che un pid venga riutilizzato tra un sondaggio e l'altro

Parametri
`device`	`ITestDevice`: il dispositivo da utilizzare
`pid`	`int`: l'ID del processo in attesa dell'uscita
`timeoutMs`	`long`: il tempo di attesa prima di lanciare un'eccezione TimeoutException

Lanci
`TimeoutException`
`DeviceNotAvailableException`
`ProcessUtil.KillException`

waitProcessRunning

public static Map<Integer, String> waitProcessRunning (ITestDevice device, 
                String pgrepRegex, 
                long timeoutMs)

Attendi fino a quando non viene trovato un processo in esecuzione per una determinata regex.

Parametri
`device`	`ITestDevice`: il dispositivo da utilizzare
`pgrepRegex`	`String`: una stringa che rappresenta l'espressione regolare per pgrep
`timeoutMs`	`long`: il tempo di attesa prima di lanciare un'eccezione TimeoutException

Ritorni
`Map<Integer, String>`	la mappa del pid al comando da pidsOf(...)

Lanci
`TimeoutException`
`DeviceNotAvailableException`

waitProcessRunning

public static Map<Integer, String> waitProcessRunning (ITestDevice device, 
                String pgrepRegex)

Attendi fino a quando non viene trovato un processo in esecuzione per una determinata regex.

Parametri
`device`	`ITestDevice`: il dispositivo da utilizzare
`pgrepRegex`	`String`: una stringa che rappresenta l'espressione regolare per pgrep

Ritorni
`Map<Integer, String>`	la mappa del pid al comando da pidsOf(...)

Lanci
`TimeoutException`
`DeviceNotAvailableException`

withProcessKill

public static AutoCloseable withProcessKill (ITestDevice device, 
                String pgrepRegex, 
                Runnable beforeCloseKill, 
                long timeoutMs)

Uccidere un processo all'inizio e alla fine di un test.

Parametri
`device`	`ITestDevice`: il dispositivo da utilizzare
`pgrepRegex`	`String`: il pattern del nome del processo da uccidere da passare a pgrep
`beforeCloseKill`	`Runnable`: un file eseguibile per tutte le azioni che devono essere eseguite prima di interrompere il processo in un ambiente normale al termine del test. Può essere null.
`timeoutMs`	`long`: il tempo in millisecondi da attendere per l'interruzione del processo

Ritorni
`AutoCloseable`	Un oggetto che ucciderà di nuovo il processo quando viene chiuso

Lanci
`DeviceNotAvailableException`
`TimeoutException`
`ProcessUtil.KillException`

withProcessKill

public static AutoCloseable withProcessKill (ITestDevice device, 
                String pgrepRegex, 
                Runnable beforeCloseKill)

Uccidere un processo all'inizio e alla fine di un test.

Parametri
`device`	`ITestDevice`: il dispositivo da utilizzare
`pgrepRegex`	`String`: il pattern del nome del processo da uccidere da passare a pgrep
`beforeCloseKill`	`Runnable`: un file eseguibile per tutte le azioni che devono essere eseguite prima di interrompere il processo in un ambiente normale al termine del test. Può essere null.

Ritorni
`AutoCloseable`	Un oggetto che ucciderà di nuovo il processo quando viene chiuso

Lanci
`DeviceNotAvailableException`
`TimeoutException`
`ProcessUtil.KillException`

ProcessUtil

Riepilogo

Classi nidificate

Costanti

Metodi pubblici

Costanti

PROCESS_POLL_PERIOD_MS

PROCESS_WAIT_TIMEOUT_MS

Metodi pubblici

findFileLoadedByProcess

findFilesLoadedByProcess

getProcessName

killAll

killAll

killPid

killPid

listOpenFiles

pidOf

pidsOf

waitPidExited

waitPidExited

waitProcessRunning

waitProcessRunning

withProcessKill

withProcessKill