A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.

Esta página foi traduzida pela API Cloud Translation.

ProcessUtil

public final class ProcessUtil
extends Object

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

Vários ajudantes para encontrar, esperar e encerrar processos no dispositivo

Resumo

Classes aninhadas
`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)` Retorna a entrada do primeiro arquivo carregado pelo processo especificado com o nome especificado
`static Optional<List<String>>`	`findFilesLoadedByProcess (ITestDevice device, int pid, Pattern filePattern)` Retorna os nomes dos arquivos do arquivo especificado, carregados pelo processo especificado.
`static Optional<String>`	`getProcessName (ITestDevice device, int pid)` Obtenha o conteúdo de /proc/pid/cmdline.
`static boolean`	`killAll (ITestDevice device, String pgrepRegex, long timeoutMs, boolean expectExist)` Envie SIGKILL para todos os processos que correspondam a um padrão.
`static boolean`	`killAll (ITestDevice device, String pgrepRegex, long timeoutMs)` Envie SIGKILL para todos os processos que correspondam a um padrão.
`static void`	`killPid (ITestDevice device, int pid, long timeoutMs)` Envie SIGKILL para um processo e espere que ele seja encerrado.
`static void`	`killPid (ITestDevice device, int pid, int signal, long timeoutMs)` Envie um sinal para um processo e espere que ele seja encerrado.
`static Optional<List<String>>`	`listOpenFiles (ITestDevice device, int pid)` Retorna os nomes dos arquivos atualmente abertos do processo especificado.
`static Optional<Integer>`	`pidOf (ITestDevice device, String pgrepRegex)` Obtenha um único pid que corresponda a um padrão passado para `pgrep`.
`static Optional<Map<Integer, String>>`	`pidsOf (ITestDevice device, String pgrepRegex)` Obtenha os pids que correspondem a um padrão passado para `pgrep`.
`static void`	`waitPidExited (ITestDevice device, int pid)` Aguarde a saída de um processo.
`static void`	`waitPidExited (ITestDevice device, int pid, long timeoutMs)` Aguarde a saída de um processo.
`static Map<Integer, String>`	`waitProcessRunning (ITestDevice device, String pgrepRegex, long timeoutMs)` Aguarde até que um processo em execução seja encontrado para um determinado regex.
`static Map<Integer, String>`	`waitProcessRunning (ITestDevice device, String pgrepRegex)` Aguarde até que um processo em execução seja encontrado para um determinado regex.
`static AutoCloseable`	`withProcessKill (ITestDevice device, String pgrepRegex, Runnable beforeCloseKill, long timeoutMs)` Elimine um processo no início e no final de um teste.
`static AutoCloseable`	`withProcessKill (ITestDevice device, String pgrepRegex, Runnable beforeCloseKill)` Elimine um processo no início e no final de um teste.

Constantes

PROCESS_POLL_PERIOD_MS

public static final long PROCESS_POLL_PERIOD_MS

Valor constante: 250 (0x0000000000000fa)

PROCESS_WAIT_TIMEOUT_MS

public static final long PROCESS_WAIT_TIMEOUT_MS

Valor Constante: 10000 (0x000000000002710)

Métodos públicos

findFileLoadedByProcess

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

Retorna a entrada do primeiro arquivo carregado pelo processo especificado com o nome especificado

Parâmetros
`device`	`ITestDevice` : dispositivo a ser executado
`process`	`String` : padrão pgrep do processo a ser procurado
`filenameSubstr`	`String` : parte do nome/caminho do arquivo carregado pelo processo

Devoluções
`Optional<IFileEntry>`	uma opção de IFileEntry do caminho do arquivo no dispositivo, se existir.

Lança
`DeviceNotAvailableException`

findFilesLoadedByProcess

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

Retorna os nomes dos arquivos do arquivo especificado, carregados pelo processo especificado.

Parâmetros
`device`	`ITestDevice` : dispositivo a ser executado
`pid`	`int` : o id do processo a ser pesquisado
`filePattern`	`Pattern` : um padrão dos nomes dos arquivos a serem retornados

Devoluções
`Optional<List<String>>`	um Opcional dos arquivos filtrados; vazio se o processo não foi encontrado ou os arquivos abertos não puderam ser lidos.

Lança
`DeviceNotAvailableException`

getProcessName

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

Obtenha o conteúdo de /proc/pid/cmdline.

Parâmetros
`device`	`ITestDevice` : o dispositivo a ser usado
`pid`	`int` : o id do processo para obter o nome

Devoluções
`Optional<String>`	uma string opcional do conteúdo de /proc/pid/cmdline; vazio se o pid não puder ser encontrado

Lança
`DeviceNotAvailableException`

Mate todos

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

Envie SIGKILL para todos os processos que correspondam a um padrão.

Parâmetros
`device`	`ITestDevice` : o dispositivo a ser usado
`pgrepRegex`	`String` : uma String representando o regex para pgrep
`timeoutMs`	`long` : quanto tempo esperar antes de lançar uma TimeoutException
`expectExist`	`boolean` : se uma exceção deve ser lançada quando nenhum processo foi eliminado

Devoluções
`boolean`	se algum processo foi eliminado

Lança
`DeviceNotAvailableException`
`TimeoutException`
`ProcessUtil.KillException`

Mate todos

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

Envie SIGKILL para todos os processos que correspondam a um padrão.

Parâmetros
`device`	`ITestDevice` : o dispositivo a ser usado
`pgrepRegex`	`String` : uma String representando o regex para pgrep
`timeoutMs`	`long` : quanto tempo esperar antes de lançar uma TimeoutException

Devoluções
`boolean`	se algum processo foi eliminado

Lança
`DeviceNotAvailableException`
`TimeoutException`
`ProcessUtil.KillException`

matarPid

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

Envie SIGKILL para um processo e espere que ele seja encerrado.

Parâmetros
`device`	`ITestDevice` : o dispositivo a ser usado
`pid`	`int` : o id do processo para esperar até sair
`timeoutMs`	`long` : quanto tempo esperar antes de lançar uma TimeoutException

Lança
`DeviceNotAvailableException`
`TimeoutException`
`ProcessUtil.KillException`

matarPid

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

Envie um sinal para um processo e espere que ele seja encerrado.

Parâmetros
`device`	`ITestDevice` : o dispositivo a ser usado
`pid`	`int` : o id do processo para esperar até sair
`signal`	`int` : o sinal a ser enviado ao processo
`timeoutMs`	`long` : quanto tempo esperar antes de lançar uma TimeoutException

Lança
`DeviceNotAvailableException`
`TimeoutException`
`ProcessUtil.KillException`

listaOpenFiles

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

Retorna os nomes dos arquivos atualmente abertos do processo especificado.

Parâmetros
`device`	`ITestDevice` : dispositivo a ser executado
`pid`	`int` : o id do processo a ser pesquisado

Devoluções
`Optional<List<String>>`	um Opcional dos arquivos abertos; vazio se o processo não foi encontrado ou os arquivos abertos não puderam ser lidos.

Lança
`DeviceNotAvailableException`

pidOf

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

Obtenha um único pid que corresponda a um padrão passado para `pgrep`. Lançar uma IllegalArgumentException quando houver mais de um PID correspondente ao padrão.

Parâmetros
`device`	`ITestDevice` : o dispositivo a ser usado
`pgrepRegex`	`String` : uma String representando o regex para pgrep

Devoluções
`Optional<Integer>`	um número inteiro opcional do pid; vazio se o pgrep não retornou EXIT_SUCCESS

Lança
`DeviceNotAvailableException`
`IllegalArgumentException`

pidsOf

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

Obtenha os pids que correspondem a um padrão passado para `pgrep`. Como /proc/pid/comm está truncado, `pgrep` é passado com `-f` para verificar a linha de comando completa.

Parâmetros
`device`	`ITestDevice` : o dispositivo a ser usado
`pgrepRegex`	`String` : uma String representando o regex para pgrep

Devoluções
`Optional<Map<Integer, String>>`	um mapa opcional de pid para linha de comando; vazio se o pgrep não retornou EXIT_SUCCESS

Lança
`DeviceNotAvailableException`

esperePidExited

public static void waitPidExited (ITestDevice device, 
                int pid)

Aguarde a saída de um processo. Isto não é esperar que mude, mas simplesmente ser inexistente. É possível, mas improvável, que um pid seja reutilizado entre as pesquisas

Parâmetros
`device`	`ITestDevice` : o dispositivo a ser usado
`pid`	`int` : o id do processo para esperar até sair

Lança
`TimeoutException`
`DeviceNotAvailableException`
`ProcessUtil.KillException`

esperePidExited

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

Aguarde a saída de um processo. Isto não é esperar que mude, mas simplesmente ser inexistente. É possível, mas improvável, que um pid seja reutilizado entre as pesquisas

Parâmetros
`device`	`ITestDevice` : o dispositivo a ser usado
`pid`	`int` : o id do processo para esperar até sair
`timeoutMs`	`long` : quanto tempo esperar antes de lançar uma TimeoutException

Lança
`TimeoutException`
`DeviceNotAvailableException`
`ProcessUtil.KillException`

waitProcessRunning

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

Aguarde até que um processo em execução seja encontrado para um determinado regex.

Parâmetros
`device`	`ITestDevice` : o dispositivo a ser usado
`pgrepRegex`	`String` : uma String representando o regex para pgrep
`timeoutMs`	`long` : quanto tempo esperar antes de lançar uma TimeoutException

Devoluções
`Map<Integer, String>`	o pid para comandar o mapa de pidsOf(...)

Lança
`TimeoutException`
`DeviceNotAvailableException`

waitProcessRunning

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

Aguarde até que um processo em execução seja encontrado para um determinado regex.

Parâmetros
`device`	`ITestDevice` : o dispositivo a ser usado
`pgrepRegex`	`String` : uma String representando o regex para pgrep

Devoluções
`Map<Integer, String>`	o pid para comandar o mapa de pidsOf(...)

Lança
`TimeoutException`
`DeviceNotAvailableException`

comProcessKill

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

Elimine um processo no início e no final de um teste.

Parâmetros
`device`	`ITestDevice` : o dispositivo a ser usado
`pgrepRegex`	`String` : o padrão de nome do processo a ser eliminado para fornecer ao pgrep
`beforeCloseKill`	`Runnable` : um executável para qualquer ação que precise ser limpa antes de encerrar o processo em um ambiente normal no final do teste. Pode ser nulo.
`timeoutMs`	`long` : quanto tempo em milissegundos esperar até que o processo seja encerrado

Devoluções
`AutoCloseable`	Um objeto que encerrará o processo novamente quando ele for fechado

Lança
`DeviceNotAvailableException`
`TimeoutException`
`ProcessUtil.KillException`

comProcessKill

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

Elimine um processo no início e no final de um teste.

Parâmetros
`device`	`ITestDevice` : o dispositivo a ser usado
`pgrepRegex`	`String` : o padrão de nome do processo a ser eliminado para fornecer ao pgrep
`beforeCloseKill`	`Runnable` : um executável para qualquer ação que precise ser limpa antes de encerrar o processo em um ambiente normal no final do teste. Pode ser nulo.

Devoluções
`AutoCloseable`	Um objeto que encerrará o processo novamente quando ele for fechado

Lança
`DeviceNotAvailableException`
`TimeoutException`
`ProcessUtil.KillException`

ProcessUtil

Resumo

Classes aninhadas

Constantes

Métodos públicos

Constantes

PROCESS_POLL_PERIOD_MS

PROCESS_WAIT_TIMEOUT_MS

Métodos públicos

findFileLoadedByProcess

findFilesLoadedByProcess

getProcessName

Mate todos

Mate todos

matarPid

matarPid

listaOpenFiles

pidOf

pidsOf

esperePidExited

esperePidExited

waitProcessRunning

waitProcessRunning

comProcessKill

comProcessKill