العملية

public final class ProcessUtil
extends Object

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

---

العديد من المساعدين للعثور على العمليات والانتظار وقتلها على الجهاز

ملخص

فئات متداخلة
class	ProcessUtil.KillException

الثوابت
long	PROCESS_POLL_PERIOD_MS
long	PROCESS_WAIT_TIMEOUT_MS

الأساليب العامة
static Optional<IFileEntry>	findFileLoadedByProcess (ITestDevice device, String process, String filenameSubstr) إرجاع إدخال الملف للملف الأول الذي تم تحميله بواسطة العملية المحددة بالاسم المحدد
static Optional<List<String>>	findFilesLoadedByProcess (ITestDevice device, int pid, Pattern filePattern) يُرجع أسماء الملفات الخاصة بالملف المحدد ، الذي تم تحميله بواسطة العملية المحددة.
static Optional<String>	getProcessName (ITestDevice device, int pid) احصل على المحتويات من / proc / pid / cmdline.
static boolean	killAll (ITestDevice device, String pgrepRegex, long timeoutMs, boolean expectExist) أرسل SIGKILL إلى جميع العمليات المطابقة للنمط.
static boolean	killAll (ITestDevice device, String pgrepRegex, long timeoutMs) أرسل SIGKILL إلى جميع العمليات المطابقة للنمط.
static void	killPid (ITestDevice device, int pid, long timeoutMs) أرسل SIGKILL إلى عملية وانتظر حتى يتم الخروج منها.
static void	killPid (ITestDevice device, int pid, int signal, long timeoutMs) أرسل إشارة إلى عملية وانتظر حتى يتم الخروج منها.
static Optional<List<String>>	listOpenFiles (ITestDevice device, int pid) إرجاع أسماء الملفات المفتوحة حالياً للعملية المحددة.
static Optional<Integer>	pidOf (ITestDevice device, String pgrepRegex) احصل على معرف معالجة واحد يطابق نمطًا تم تمريره إلى `pgrep`.
static Optional<Map<Integer, String>>	pidsOf (ITestDevice device, String pgrepRegex) احصل على pids المطابقة للنمط الذي تم تمريره إلى `pgrep`.
static void	waitPidExited (ITestDevice device, int pid) انتظر حتى يتم الخروج من العملية.
static void	waitPidExited (ITestDevice device, int pid, long timeoutMs) انتظر حتى يتم الخروج من العملية.
static Map<Integer, String>	waitProcessRunning (ITestDevice device, String pgrepRegex, long timeoutMs) انتظر حتى يتم العثور على عملية جارية لتعبير معين.
static Map<Integer, String>	waitProcessRunning (ITestDevice device, String pgrepRegex) انتظر حتى يتم العثور على عملية جارية لتعبير معين.
static AutoCloseable	withProcessKill (ITestDevice device, String pgrepRegex, Runnable beforeCloseKill, long timeoutMs) اقتل عملية في بداية الاختبار ونهايته.
static AutoCloseable	withProcessKill (ITestDevice device, String pgrepRegex, Runnable beforeCloseKill) اقتل عملية في بداية الاختبار ونهايته.

الثوابت

PROCESS_POLL_PERIOD_MS

public static final long PROCESS_POLL_PERIOD_MS

قيمة ثابتة: 250 (0x00000000000000fa)

PROCESS_WAIT_TIMEOUT_MS

public static final long PROCESS_WAIT_TIMEOUT_MS

قيمة ثابتة: 10000 (0x0000000000002710)

الأساليب العامة

findFileLoadedByProcess

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

إرجاع إدخال الملف للملف الأول الذي تم تحميله بواسطة العملية المحددة بالاسم المحدد

المعلمات
device	ITestDevice : الجهاز المراد التشغيل عليه
process	String : نمط pgrep للعملية المطلوب البحث عنه
filenameSubstr	String : جزء من اسم الملف / المسار الذي تم تحميله بواسطة العملية

عائدات
Optional<IFileEntry>	a Opotional of IFileEntry of the file of the device on the device إن وجد.

رميات
DeviceNotAvailableException

findFilesLoadedByProcess

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

يُرجع أسماء الملفات الخاصة بالملف المحدد ، الذي تم تحميله بواسطة العملية المحددة.

المعلمات
device	ITestDevice : الجهاز المراد التشغيل عليه
pid	int : معرف عملية البحث
filePattern	Pattern : نمط من أسماء الملفات للعودة

عائدات
Optional<List<String>>	اختياري من الملفات المصفاة ؛ فارغًا إذا لم يتم العثور على العملية أو تعذر قراءة الملفات المفتوحة.

رميات
DeviceNotAvailableException

getProcessName

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

احصل على المحتويات من / proc / pid / cmdline.

المعلمات
device	ITestDevice : الجهاز المطلوب استخدامه
pid	int : معرف العملية للحصول على اسم

عائدات
Optional<String>	سلسلة اختيارية لمحتويات / proc / pid / cmdline ؛ فارغة إذا تعذر العثور على معرف المنتج

رميات
DeviceNotAvailableException

اقتل الكل

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

أرسل SIGKILL إلى جميع العمليات المطابقة للنمط.

المعلمات
device	ITestDevice : الجهاز المطلوب استخدامه
pgrepRegex	String : سلسلة تمثل regex لـ pgrep
timeoutMs	long : كم من الوقت يجب الانتظار قبل طرح TimeoutException
expectExist	قيمة boolean : ما إذا كان يجب طرح استثناء عند عدم قتل أي عمليات

عائدات
boolean	ما إذا كان قد تم قتل أي عمليات

رميات
DeviceNotAvailableException
TimeoutException
ProcessUtil.KillException

اقتل الكل

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

أرسل SIGKILL إلى جميع العمليات المطابقة للنمط.

المعلمات
device	ITestDevice : الجهاز المطلوب استخدامه
pgrepRegex	String : سلسلة تمثل regex لـ pgrep
timeoutMs	long : كم من الوقت يجب الانتظار قبل طرح TimeoutException

عائدات
boolean	ما إذا كان قد تم قتل أي عمليات

رميات
DeviceNotAvailableException
TimeoutException
ProcessUtil.KillException

killPid

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

أرسل SIGKILL إلى عملية وانتظر حتى يتم الخروج منها.

المعلمات
device	ITestDevice : الجهاز المطلوب استخدامه
pid	int : معرّف عملية الانتظار حتى يتم الخروج منها
timeoutMs	long : كم من الوقت يجب الانتظار قبل طرح TimeoutException

رميات
DeviceNotAvailableException
TimeoutException
ProcessUtil.KillException

killPid

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

أرسل إشارة إلى عملية وانتظر حتى يتم الخروج منها.

المعلمات
device	ITestDevice : الجهاز المطلوب استخدامه
pid	int : معرّف عملية الانتظار حتى يتم الخروج منها
signal	int : الإشارة المراد إرسالها إلى العملية
timeoutMs	long : كم من الوقت يجب الانتظار قبل طرح TimeoutException

رميات
DeviceNotAvailableException
TimeoutException
ProcessUtil.KillException

listOpenFiles

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

إرجاع أسماء الملفات المفتوحة حالياً للعملية المحددة.

المعلمات
device	ITestDevice : الجهاز المراد التشغيل عليه
pid	int : معرف عملية البحث

عائدات
Optional<List<String>>	اختياري من الملفات المفتوحة ؛ فارغًا إذا لم يتم العثور على العملية أو تعذر قراءة الملفات المفتوحة.

رميات
DeviceNotAvailableException

بيدوف

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

احصل على معرف معالجة واحد يطابق نمطًا تم تمريره إلى `pgrep`. IllegalArgumentException عندما يكون هناك أكثر من PID مطابق للنمط.

المعلمات
device	ITestDevice : الجهاز المطلوب استخدامه
pgrepRegex	String : سلسلة تمثل regex لـ pgrep

عائدات
Optional<Integer>	عدد صحيح اختياري من pid ؛ فارغًا إذا لم يُرجع pgrep EXIT_SUCCESS

رميات
DeviceNotAvailableException
IllegalArgumentException

pidsOf

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

احصل على pids المطابقة للنمط الذي تم تمريره إلى `pgrep`. نظرًا لاقتطاع / proc / pid / comm ، يتم تمرير "pgrep" مع "-f" للتحقق من سطر الأوامر بالكامل.

المعلمات
device	ITestDevice : الجهاز المطلوب استخدامه
pgrepRegex	String : سلسلة تمثل regex لـ pgrep

عائدات
Optional<Map<Integer, String>>	خريطة اختيارية من pid إلى سطر الأوامر ؛ فارغًا إذا لم يُرجع pgrep EXIT_SUCCESS

رميات
DeviceNotAvailableException

waitPidExited

public static void waitPidExited (ITestDevice device, 
                int pid)

انتظر حتى يتم الخروج من العملية. هذا لا ينتظر أن يتغير ، لكن ببساطة يكون غير موجود. من الممكن ، ولكن من غير المحتمل ، إعادة استخدام ملف تعريف الارتباط بين استطلاعات الرأي

المعلمات
device	ITestDevice : الجهاز المطلوب استخدامه
pid	int : معرّف عملية الانتظار حتى يتم الخروج منها

رميات
TimeoutException
DeviceNotAvailableException
ProcessUtil.KillException

waitPidExited

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

انتظر حتى يتم الخروج من العملية. هذا لا ينتظر أن يتغير ، لكن ببساطة يكون غير موجود. من الممكن ، ولكن من غير المحتمل ، إعادة استخدام ملف تعريف الارتباط بين استطلاعات الرأي

المعلمات
device	ITestDevice : الجهاز المطلوب استخدامه
pid	int : معرّف عملية الانتظار حتى يتم الخروج منها
timeoutMs	long : كم من الوقت يجب الانتظار قبل طرح TimeoutException

رميات
TimeoutException
DeviceNotAvailableException
ProcessUtil.KillException

انتظر العملية قيد التشغيل

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

انتظر حتى يتم العثور على عملية جارية لتعبير معين.

المعلمات
device	ITestDevice : الجهاز المطلوب استخدامه
pgrepRegex	String : سلسلة تمثل regex لـ pgrep
timeoutMs	long : كم من الوقت يجب الانتظار قبل طرح TimeoutException

عائدات
Map<Integer, String>	pid إلى مخطط الأمر من pidsOf (...)

رميات
TimeoutException
DeviceNotAvailableException

انتظر العملية قيد التشغيل

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

انتظر حتى يتم العثور على عملية جارية لتعبير معين.

المعلمات
device	ITestDevice : الجهاز المطلوب استخدامه
pgrepRegex	String : سلسلة تمثل regex لـ pgrep

عائدات
Map<Integer, String>	pid إلى مخطط الأمر من pidsOf (...)

رميات
TimeoutException
DeviceNotAvailableException

withProcess اقتل

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

اقتل عملية في بداية الاختبار ونهايته.

المعلمات
device	ITestDevice : الجهاز المطلوب استخدامه
pgrepRegex	String : نمط اسم عملية القتل لإعطاء pgrep
beforeCloseKill	Runnable : قابل للتشغيل لأي إجراءات تحتاج إلى التنظيف قبل قتل العملية في بيئة عادية في نهاية الاختبار. يمكن أن تكون خالية.
timeoutMs	long : كم من الوقت بالمللي ثانية لانتظار العملية حتى تقتل

عائدات
AutoCloseable	كائن سيقتل العملية مرة أخرى عند إغلاقه

رميات
DeviceNotAvailableException
TimeoutException
ProcessUtil.KillException

withProcess اقتل

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

اقتل عملية في بداية الاختبار ونهايته.

المعلمات
device	ITestDevice : الجهاز المطلوب استخدامه
pgrepRegex	String : نمط اسم عملية القتل لإعطاء pgrep
beforeCloseKill	Runnable : قابل للتشغيل لأي إجراءات تحتاج إلى التنظيف قبل قتل العملية في بيئة عادية في نهاية الاختبار. يمكن أن تكون خالية.

عائدات
AutoCloseable	كائن سيقتل العملية مرة أخرى عند إغلاقه

رميات
DeviceNotAvailableException
TimeoutException
ProcessUtil.KillException