Esta página se ha traducido con Cloud Translation API.

Util de proceso

public final class ProcessUtil
extends Object

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

Varios ayudantes para buscar, esperar y eliminar procesos en el dispositivo

Resumen

clases anidadas
`class`	`ProcessUtil.KillException`

Constantes
`long`	`PROCESS_POLL_PERIOD_MS`
`long`	`PROCESS_WAIT_TIMEOUT_MS`

Métodos públicos
`static Optional<IFileEntry>`	`findFileLoadedByProcess (ITestDevice device, String process, String filenameSubstr)` Devuelve la entrada del primer archivo cargado por el proceso especificado con el nombre especificado
`static Optional<List<String>>`	`findFilesLoadedByProcess (ITestDevice device, int pid, Pattern filePattern)` Devuelve los nombres de archivo del archivo especificado, cargado por el proceso especificado.
`static Optional<String>`	`getProcessName (ITestDevice device, int pid)` Obtenga el contenido de /proc/pid/cmdline.
`static boolean`	`killAll (ITestDevice device, String pgrepRegex, long timeoutMs, boolean expectExist)` Envíe SIGKILL a todos los procesos que coincidan con un patrón.
`static boolean`	`killAll (ITestDevice device, String pgrepRegex, long timeoutMs)` Envíe SIGKILL a todos los procesos que coincidan con un patrón.
`static void`	`killPid (ITestDevice device, int pid, long timeoutMs)` Envíe SIGKILL a un proceso y espere a que salga.
`static void`	`killPid (ITestDevice device, int pid, int signal, long timeoutMs)` Envía una señal a un proceso y espera a que salga.
`static Optional<List<String>>`	`listOpenFiles (ITestDevice device, int pid)` Devuelve los nombres de archivos actualmente abiertos del proceso especificado.
`static Optional<Integer>`	`pidOf (ITestDevice device, String pgrepRegex)` Obtenga un único pid que coincida con un patrón pasado a `pgrep`.
`static Optional<Map<Integer, String>>`	`pidsOf (ITestDevice device, String pgrepRegex)` Obtenga los pids que coincidan con un patrón pasado a `pgrep`.
`static void`	`waitPidExited (ITestDevice device, int pid)` Espere a que se cierre un proceso.
`static void`	`waitPidExited (ITestDevice device, int pid, long timeoutMs)` Espere a que se cierre un proceso.
`static Map<Integer, String>`	`waitProcessRunning (ITestDevice device, String pgrepRegex, long timeoutMs)` Espere hasta que se encuentre un proceso en ejecución para una expresión regular determinada.
`static Map<Integer, String>`	`waitProcessRunning (ITestDevice device, String pgrepRegex)` Espere hasta que se encuentre un proceso en ejecución para una expresión regular determinada.
`static AutoCloseable`	`withProcessKill (ITestDevice device, String pgrepRegex, Runnable beforeCloseKill, long timeoutMs)` Mata un proceso al principio y al final de una prueba.
`static AutoCloseable`	`withProcessKill (ITestDevice device, String pgrepRegex, Runnable beforeCloseKill)` Mata un proceso al principio y al final de una prueba.

Constantes

PROCESS_POLL_PERIOD_MS

public static final long PROCESS_POLL_PERIOD_MS

Valor constante: 250 (0x00000000000000fa)

PROCESS_WAIT_TIMEOUT_MS

public static final long PROCESS_WAIT_TIMEOUT_MS

Valor constante: 10000 (0x0000000000002710)

Métodos públicos

encontrar archivo cargado por proceso

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

Devuelve la entrada del primer archivo cargado por el proceso especificado con el nombre especificado

Parámetros
`device`	`ITestDevice` : dispositivo en el que se ejecutará
`process`	`String` : patrón pgrep del proceso a buscar
`filenameSubstr`	`String` : parte del nombre del archivo/ruta cargada por el proceso

Devoluciones
`Optional<IFileEntry>`	Opcional de IFileEntry de la ruta del archivo en el dispositivo, si existe.

Lanza
`DeviceNotAvailableException`

encontrar archivos cargados por proceso

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

Devuelve los nombres de archivo del archivo especificado, cargado por el proceso especificado.

Parámetros
`device`	`ITestDevice` : dispositivo en el que se ejecutará
`pid`	`int` : la identificación del proceso a buscar
`filePattern`	`Pattern` : un patrón de los nombres de archivos a devolver

Devoluciones
`Optional<List<String>>`	un Opcional de los archivos filtrados; vacío si no se encontró el proceso o no se pudieron leer los archivos abiertos.

Lanza
`DeviceNotAvailableException`

obtener nombre del proceso

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

Obtenga el contenido de /proc/pid/cmdline.

Parámetros
`device`	`ITestDevice` : el dispositivo a utilizar
`pid`	`int` : la identificación del proceso para obtener el nombre

Devoluciones
`Optional<String>`	una cadena opcional del contenido de /proc/pid/cmdline; vacío si no se pudo encontrar el pid

Lanza
`DeviceNotAvailableException`

Mátalos a todos

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

Envíe SIGKILL a todos los procesos que coincidan con un patrón.

Parámetros
`device`	`ITestDevice` : el dispositivo a utilizar
`pgrepRegex`	`String` : una cadena que representa la expresión regular de pgrep
`timeoutMs`	`long` : cuánto tiempo esperar antes de lanzar una TimeoutException
`expectExist`	`boolean` : si se debe lanzar una excepción cuando no se canceló ningún proceso

Devoluciones
`boolean`	si algún proceso fue eliminado

Lanza
`DeviceNotAvailableException`
`TimeoutException`
`ProcessUtil.KillException`

Mátalos a todos

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

Envíe SIGKILL a todos los procesos que coincidan con un patrón.

Parámetros
`device`	`ITestDevice` : el dispositivo a utilizar
`pgrepRegex`	`String` : una cadena que representa la expresión regular de pgrep
`timeoutMs`	`long` : cuánto tiempo esperar antes de lanzar una TimeoutException

Devoluciones
`boolean`	si algún proceso fue eliminado

Lanza
`DeviceNotAvailableException`
`TimeoutException`
`ProcessUtil.KillException`

matarPid

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

Envíe SIGKILL a un proceso y espere a que salga.

Parámetros
`device`	`ITestDevice` : el dispositivo a utilizar
`pid`	`int` : la identificación del proceso a esperar hasta que salga
`timeoutMs`	`long` : cuánto tiempo esperar antes de lanzar una TimeoutException

Lanza
`DeviceNotAvailableException`
`TimeoutException`
`ProcessUtil.KillException`

matarPid

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

Envía una señal a un proceso y espera a que salga.

Parámetros
`device`	`ITestDevice` : el dispositivo a utilizar
`pid`	`int` : la identificación del proceso a esperar hasta que salga
`signal`	`int` : la señal a enviar al proceso
`timeoutMs`	`long` : cuánto tiempo esperar antes de lanzar una TimeoutException

Lanza
`DeviceNotAvailableException`
`TimeoutException`
`ProcessUtil.KillException`

lista de archivos abiertos

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

Devuelve los nombres de archivos actualmente abiertos del proceso especificado.

Parámetros
`device`	`ITestDevice` : dispositivo en el que se ejecutará
`pid`	`int` : la identificación del proceso a buscar

Devoluciones
`Optional<List<String>>`	un Opcional de los archivos abiertos; vacío si no se encontró el proceso o no se pudieron leer los archivos abiertos.

Lanza
`DeviceNotAvailableException`

pidDe

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

Obtenga un único pid que coincida con un patrón pasado a `pgrep`. Lanza una IllegalArgumentException cuando hay más de un PID que coincide con el patrón.

Parámetros
`device`	`ITestDevice` : el dispositivo a utilizar
`pgrepRegex`	`String` : una cadena que representa la expresión regular de pgrep

Devoluciones
`Optional<Integer>`	un entero opcional del pid; vacío si pgrep no devolvió EXIT_SUCCESS

Lanza
`DeviceNotAvailableException`
`IllegalArgumentException`

pidsDe

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

Obtenga los pids que coincidan con un patrón pasado a `pgrep`. Debido a que /proc/pid/comm está truncado, `pgrep` se pasa con `-f` para verificar la línea de comando completa.

Parámetros
`device`	`ITestDevice` : el dispositivo a utilizar
`pgrepRegex`	`String` : una cadena que representa la expresión regular de pgrep

Devoluciones
`Optional<Map<Integer, String>>`	un mapa opcional de pid a la línea de comando; vacío si pgrep no devolvió EXIT_SUCCESS

Lanza
`DeviceNotAvailableException`

esperarPidSalido

public static void waitPidExited (ITestDevice device, 
                int pid)

Espere a que se cierre un proceso. Esto no es esperar a que cambie, sino simplemente ser inexistente. Es posible, pero poco probable, que un pid se reutilice entre encuestas.

Parámetros
`device`	`ITestDevice` : el dispositivo a utilizar
`pid`	`int` : la identificación del proceso a esperar hasta que salga

Lanza
`TimeoutException`
`DeviceNotAvailableException`
`ProcessUtil.KillException`

esperarPidSalido

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

Espere a que se cierre un proceso. Esto no es esperar a que cambie, sino simplemente ser inexistente. Es posible, pero poco probable, que un pid se reutilice entre encuestas.

Parámetros
`device`	`ITestDevice` : el dispositivo a utilizar
`pid`	`int` : la identificación del proceso a esperar hasta que salga
`timeoutMs`	`long` : cuánto tiempo esperar antes de lanzar una TimeoutException

Lanza
`TimeoutException`
`DeviceNotAvailableException`
`ProcessUtil.KillException`

esperarProcesoEjecutando

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

Espere hasta que se encuentre un proceso en ejecución para una expresión regular determinada.

Parámetros
`device`	`ITestDevice` : el dispositivo a utilizar
`pgrepRegex`	`String` : una cadena que representa la expresión regular de pgrep
`timeoutMs`	`long` : cuánto tiempo esperar antes de lanzar una TimeoutException

Devoluciones
`Map<Integer, String>`	el pid al mapa de comandos desde pidsOf(...)

Lanza
`TimeoutException`
`DeviceNotAvailableException`

esperarProcesoEjecutando

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

Espere hasta que se encuentre un proceso en ejecución para una expresión regular determinada.

Parámetros
`device`	`ITestDevice` : el dispositivo a utilizar
`pgrepRegex`	`String` : una cadena que representa la expresión regular de pgrep

Devoluciones
`Map<Integer, String>`	el pid al mapa de comandos desde pidsOf(...)

Lanza
`TimeoutException`
`DeviceNotAvailableException`

conProcessKill

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

Mata un proceso al principio y al final de una prueba.

Parámetros
`device`	`ITestDevice` : el dispositivo a utilizar
`pgrepRegex`	`String` : el patrón de nombre del proceso a matar para dárselo a pgrep
`beforeCloseKill`	`Runnable` : un ejecutable para cualquier acción que necesite limpieza antes de finalizar el proceso en un entorno normal al final de la prueba. Puede ser nulo.
`timeoutMs`	`long` : cuánto tiempo en milisegundos se debe esperar hasta que finalice el proceso

Devoluciones
`AutoCloseable`	Un objeto que matará el proceso nuevamente cuando se cierre.

Lanza
`DeviceNotAvailableException`
`TimeoutException`
`ProcessUtil.KillException`

conProcessKill

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

Mata un proceso al principio y al final de una prueba.

Parámetros
`device`	`ITestDevice` : el dispositivo a utilizar
`pgrepRegex`	`String` : el patrón de nombre del proceso a matar para dárselo a pgrep
`beforeCloseKill`	`Runnable` : un ejecutable para cualquier acción que necesite limpieza antes de finalizar el proceso en un entorno normal al final de la prueba. Puede ser nulo.

Devoluciones
`AutoCloseable`	Un objeto que matará el proceso nuevamente cuando se cierre.

Lanza
`DeviceNotAvailableException`
`TimeoutException`
`ProcessUtil.KillException`

Util de proceso

Resumen

clases anidadas

Constantes

Métodos públicos

Constantes

PROCESS_POLL_PERIOD_MS

PROCESS_WAIT_TIMEOUT_MS

Métodos públicos

encontrar archivo cargado por proceso

encontrar archivos cargados por proceso

obtener nombre del proceso

Mátalos a todos

Mátalos a todos

matarPid

matarPid

lista de archivos abiertos

pidDe

pidsDe

esperarPidSalido

esperarPidSalido

esperarProcesoEjecutando

esperarProcesoEjecutando

conProcessKill

conProcessKill