ProcessUtil

public final class ProcessUtil
extends Object

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

Verschiedene Helfer zum Suchen, Warten und Beenden von Prozessen auf dem Gerät

Zusammenfassung

Verschachtelte Klassen

class ProcessUtil.KillException

Konstanten

long PROCESS_POLL_PERIOD_MS

long PROCESS_WAIT_TIMEOUT_MS

Öffentliche Methoden

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

Gibt den Dateieintrag der ersten Datei zurück, die vom angegebenen Prozess mit dem angegebenen Namen geladen wurde

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

Gibt Dateinamen der angegebenen Datei zurück, die vom angegebenen Prozess geladen wurden.

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

Holen Sie sich den Inhalt von /proc/pid/cmdline.

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

Senden Sie SIGKILL an alle Prozesse, die einem Muster entsprechen.

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

Senden Sie SIGKILL an alle Prozesse, die einem Muster entsprechen.

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

Senden Sie SIGKILL an einen Prozess und warten Sie, bis er beendet wird.

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

Senden Sie ein Signal an einen Prozess und warten Sie, bis er beendet wird.

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

Gibt die aktuell geöffneten Dateinamen des angegebenen Prozesses zurück.

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

Holen Sie sich eine einzelne PID, die mit einem Muster übereinstimmt, das an "pgrep" übergeben wird.

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

Holen Sie sich die Pids, die mit einem Muster übereinstimmen, das an "pgrep" übergeben wird.

static void waitPidExited (ITestDevice device, int pid)

Warten Sie, bis ein Prozess beendet wird.

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

Warten Sie, bis ein Prozess beendet wird.

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

Warten Sie, bis ein laufender Prozess für eine bestimmte Regex gefunden wird.

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

Warten Sie, bis ein laufender Prozess für eine bestimmte Regex gefunden wird.

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

Beenden Sie einen Prozess zu Beginn und am Ende eines Tests.

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

Beenden Sie einen Prozess zu Beginn und am Ende eines Tests.

Konstanten

PROCESS_POLL_PERIOD_MS

public static final long PROCESS_POLL_PERIOD_MS

Konstanter Wert: 250 (0x00000000000000fa)

PROCESS_WAIT_TIMEOUT_MS

public static final long PROCESS_WAIT_TIMEOUT_MS

Konstanter Wert: 10000 (0x0000000000002710)

Öffentliche Methoden

findFileLoadedByProcess

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

Gibt den Dateieintrag der ersten Datei zurück, die vom angegebenen Prozess mit dem angegebenen Namen geladen wurde

Parameter
device ITestDevice : Gerät, auf dem ausgeführt werden soll

process String : pgrep-Muster des Prozesses, nach dem gesucht werden soll

filenameSubstr String : Teil des Dateinamens/Pfads, der vom Prozess geladen wird

Kehrt zurück
Optional<IFileEntry> ein optionaler IFileEntry des Pfads der Datei auf dem Gerät, falls vorhanden.

Wirft
DeviceNotAvailableException

findFilesLoadedByProcess

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

Gibt Dateinamen der angegebenen Datei zurück, die vom angegebenen Prozess geladen wurden.

Parameter
device ITestDevice : Gerät, auf dem ausgeführt werden soll

pid int : Die ID des zu durchsuchenden Prozesses

filePattern Pattern : ein Muster der zurückzugebenden Dateinamen

Kehrt zurück
Optional<List<String>> ein Optional der gefilterten Dateien; leer, wenn der Prozess nicht gefunden wurde oder die geöffneten Dateien nicht gelesen werden konnten.

Wirft
DeviceNotAvailableException

getProcessName

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

Holen Sie sich den Inhalt von /proc/pid/cmdline.

Parameter
device ITestDevice : das zu verwendende Gerät

pid int : Die ID des Prozesses, für den der Name abgerufen werden soll

Kehrt zurück
Optional<String> eine optionale Zeichenfolge des Inhalts von /proc/pid/cmdline; leer, wenn die PID nicht gefunden werden konnte

Wirft
DeviceNotAvailableException

töte alle

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

Senden Sie SIGKILL an alle Prozesse, die einem Muster entsprechen.

Parameter
device ITestDevice : das zu verwendende Gerät

pgrepRegex String : ein String, der die Regex für pgrep darstellt

timeoutMs long : wie lange gewartet werden soll, bevor eine TimeoutException ausgelöst wird

expectExist boolean : ob eine Ausnahme ausgelöst werden soll, wenn keine Prozesse beendet wurden

Kehrt zurück
boolean ob irgendwelche Prozesse getötet wurden

Wirft
DeviceNotAvailableException
TimeoutException
ProcessUtil.KillException

töte alle

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

Senden Sie SIGKILL an alle Prozesse, die einem Muster entsprechen.

Parameter
device ITestDevice : das zu verwendende Gerät

pgrepRegex String : ein String, der die Regex für pgrep darstellt

timeoutMs long : wie lange gewartet werden soll, bevor eine TimeoutException ausgelöst wird

Kehrt zurück
boolean ob irgendwelche Prozesse getötet wurden

Wirft
DeviceNotAvailableException
TimeoutException
ProcessUtil.KillException

killPid

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

Senden Sie SIGKILL an einen Prozess und warten Sie, bis er beendet wird.

Parameter
device ITestDevice : das zu verwendende Gerät

pid int : Die ID des Prozesses, der bis zum Beenden warten soll

timeoutMs long : wie lange gewartet werden soll, bevor eine TimeoutException ausgelöst wird

Wirft
DeviceNotAvailableException
TimeoutException
ProcessUtil.KillException

killPid

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

Senden Sie ein Signal an einen Prozess und warten Sie, bis er beendet wird.

Parameter
device ITestDevice : das zu verwendende Gerät

pid int : Die ID des Prozesses, der bis zum Beenden warten soll

signal int : das an den Prozess zu sendende Signal

timeoutMs long : wie lange gewartet werden soll, bevor eine TimeoutException ausgelöst wird

Wirft
DeviceNotAvailableException
TimeoutException
ProcessUtil.KillException

listOpenFiles

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

Gibt die aktuell geöffneten Dateinamen des angegebenen Prozesses zurück.

Parameter
device ITestDevice : Gerät, auf dem ausgeführt werden soll

pid int : Die ID des zu durchsuchenden Prozesses

Kehrt zurück
Optional<List<String>> ein Optional der geöffneten Dateien; leer, wenn der Prozess nicht gefunden wurde oder die geöffneten Dateien nicht gelesen werden konnten.

Wirft
DeviceNotAvailableException

pidOf

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

Holen Sie sich eine einzelne PID, die mit einem Muster übereinstimmt, das an "pgrep" übergeben wird. Löst eine IllegalArgumentException wenn mehr als eine PID mit dem Muster übereinstimmt.

Parameter
device ITestDevice : das zu verwendende Gerät

pgrepRegex String : ein String, der die Regex für pgrep darstellt

Kehrt zurück
Optional<Integer> eine optionale Ganzzahl der PID; leer, wenn pgrep EXIT_SUCCESS nicht zurückgegeben hat

Wirft
DeviceNotAvailableException
IllegalArgumentException

pidsOf

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

Holen Sie sich die Pids, die mit einem Muster übereinstimmen, das an "pgrep" übergeben wird. Da /proc/pid/comm abgeschnitten wird, wird `pgrep` mit `-f` übergeben, um die vollständige Befehlszeile zu prüfen.

Parameter
device ITestDevice : das zu verwendende Gerät

pgrepRegex String : ein String, der die Regex für pgrep darstellt

Kehrt zurück
Optional<Map<Integer, String>> eine optionale Zuordnung von PID zur Befehlszeile; leer, wenn pgrep EXIT_SUCCESS nicht zurückgegeben hat

Wirft
DeviceNotAvailableException

waitPidExited

public static void waitPidExited (ITestDevice device, 
                int pid)

Warten Sie, bis ein Prozess beendet wird. Dies wartet nicht darauf, dass es sich ändert, sondern ist einfach nicht existent. Es ist möglich, aber unwahrscheinlich, dass eine PID zwischen Abfragen wiederverwendet wird

Parameter
device ITestDevice : das zu verwendende Gerät

pid int : Die ID des Prozesses, der bis zum Beenden warten soll

Wirft
TimeoutException
DeviceNotAvailableException
ProcessUtil.KillException

waitPidExited

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

Warten Sie, bis ein Prozess beendet wird. Dies wartet nicht darauf, dass es sich ändert, sondern ist einfach nicht existent. Es ist möglich, aber unwahrscheinlich, dass eine PID zwischen Abfragen wiederverwendet wird

Parameter
device ITestDevice : das zu verwendende Gerät

pid int : Die ID des Prozesses, der bis zum Beenden warten soll

timeoutMs long : wie lange gewartet werden soll, bevor eine TimeoutException ausgelöst wird

Wirft
TimeoutException
DeviceNotAvailableException
ProcessUtil.KillException

WaitProcessRunning

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

Warten Sie, bis ein laufender Prozess für eine bestimmte Regex gefunden wird.

Parameter
device ITestDevice : das zu verwendende Gerät

pgrepRegex String : ein String, der die Regex für pgrep darstellt

timeoutMs long : wie lange gewartet werden soll, bevor eine TimeoutException ausgelöst wird

Kehrt zurück
Map<Integer, String> die pid to command map von pidsOf(...)

Wirft
TimeoutException
DeviceNotAvailableException

WaitProcessRunning

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

Warten Sie, bis ein laufender Prozess für eine bestimmte Regex gefunden wird.

Parameter
device ITestDevice : das zu verwendende Gerät

pgrepRegex String : ein String, der die Regex für pgrep darstellt

Kehrt zurück
Map<Integer, String> die pid to command map von pidsOf(...)

Wirft
TimeoutException
DeviceNotAvailableException

mit ProcessKill

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

Beenden Sie einen Prozess zu Beginn und am Ende eines Tests.

Parameter
device ITestDevice : das zu verwendende Gerät

pgrepRegex String : das Namensmuster des Prozesses, der beendet werden soll, um es an pgrep zu übergeben

beforeCloseKill Runnable : ein Runnable für alle Aktionen, die bereinigt werden müssen, bevor der Prozess in einer normalen Umgebung am Ende des Tests beendet wird. Kann null sein.

timeoutMs long : wie lange in Millisekunden auf das Beenden des Prozesses gewartet werden soll

Kehrt zurück
AutoCloseable Ein Objekt, das den Prozess erneut beendet, wenn es geschlossen wird

Wirft
DeviceNotAvailableException
TimeoutException
ProcessUtil.KillException

mit ProcessKill

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

Beenden Sie einen Prozess zu Beginn und am Ende eines Tests.

Parameter
device ITestDevice : das zu verwendende Gerät

pgrepRegex String : das Namensmuster des Prozesses, der beendet werden soll, um es an pgrep zu übergeben

beforeCloseKill Runnable : ein Runnable für alle Aktionen, die bereinigt werden müssen, bevor der Prozess in einer normalen Umgebung am Ende des Tests beendet wird. Kann null sein.

Kehrt zurück
AutoCloseable Ein Objekt, das den Prozess erneut beendet, wenn es geschlossen wird

Wirft
DeviceNotAvailableException
TimeoutException
ProcessUtil.KillException