تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

RunUtil

public class RunUtil
extends Object implements IRunUtil

java.lang.Object
↳	com.android.tradefed.util.RunUtil

مجموعة من الطرق المساعدة لتنفيذ العمليات.

ملخص

مجالات
`public static final String`	`INHERITIO_PREFIX`
`public static final String`	`RUNNABLE_NOTIFIER_NAME`

المنشأت العامة
`RunUtil ()` قم بإنشاء كائن `RunUtil` جديد لاستخدامه.

الأساليب العامة
`void`	`allowInterrupt (boolean allow)` يسمح / لا يسمح بتشغيل المقاطعات على مؤشر الترابط الحالي.
`static IRunUtil`	`getDefault ()` احصل على مرجع لكائن `RunUtil` الافتراضي.
`void`	`interrupt (Thread thread, String message, ErrorIdentifier errorId)` يقطع عمليات التشغيل الجارية / القادمة على مؤشر الترابط المحدد.
`void`	`interrupt (Thread thread, String message)` يقطع عمليات التشغيل الجارية / القادمة على مؤشر الترابط المحدد.
`boolean`	`isInterruptAllowed ()` امنح حالة المقاطعة لـ RunUtil.
`Process`	`runCmdInBackground (Redirect redirect, command)` `runCmdInBackground (Redirect redirect, command)` أسلوب `runCmdInBackground(String)` بديل يقبل وسيطات الأمر في نموذج `ERROR(/List)` .
`Process`	`runCmdInBackground ( command)` `runCmdInBackground ( command)` أسلوب `runCmdInBackground(String)` بديل يقبل وسيطات الأمر في نموذج `ERROR(/List)` .
`Process`	`runCmdInBackground ( command, OutputStream output)` `runCmdInBackground ( command, OutputStream output)` الأمر الذي يتم تشغيله باستخدام `ERROR(/OutputStream)` يقوم بتسجيل إخراج الأمر.
`Process`	`runCmdInBackground (String... command)` طريقة المساعد لتنفيذ أمر النظام بشكل غير متزامن.
`Process`	`runCmdInBackground (Redirect redirect, String... command)` طريقة المساعد لتنفيذ أمر النظام بشكل غير متزامن.
`boolean`	`runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)` منع العملية وتنفيذها عدة مرات حتى تنجح.
`boolean`	`runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)` منع العملية وتنفيذها عدة مرات حتى تنجح.
`CommandStatus`	`runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)` حظر وتنفيذ عملية ، والإيقاف إذا استغرقت وقتًا أطول من الوقت المحدد.
`CommandResult`	`runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)` طريقة المساعدة لتنفيذ أمر النظام ، والإيقاف إذا استغرق وقتًا أطول من الوقت المحدد ، وإعادة توجيه الإخراج إلى الملفات إذا تم تحديده.
`CommandResult`	`runTimedCmd (long timeout, String... command)` طريقة المساعد لتنفيذ أمر النظام ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد.
`CommandResult`	`runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)` طريقة المساعد لتنفيذ أمر النظام ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد.
`CommandResult`	`runTimedCmdSilently (long timeout, String... command)` طريقة المساعد لتنفيذ أمر النظام ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد.
`CommandResult`	`runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command)` طريقة المساعد لتنفيذ أمر النظام ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد.
`CommandResult`	`runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)` طريقة المساعدة لتنفيذ أمر النظام ، والإيقاف إذا استغرق وقتًا أطول من الوقت المحدد ، وإعادة توجيه الإخراج إلى الملفات إذا تم تحديده.
`CommandResult`	`runTimedCmdWithInput (long timeout, String input, String... command)` طريقة Helper لتنفيذ أمر نظام يتطلب إدخال stdin ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد.
`CommandResult`	`runTimedCmdWithInput (long timeout, String input, command)` `runTimedCmdWithInput (long timeout, String input, command)` طريقة Helper لتنفيذ أمر نظام يتطلب إدخال stdin ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد.
`CommandResult`	`runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)` طريقة Helper لتنفيذ أمر نظام يتطلب إعادة توجيه Stdin من ملف ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد.
`boolean`	`runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)` منع العملية وتنفيذها عدة مرات حتى تنجح.
`void`	`setEnvVariable (String name, String value)` يضبط متغير بيئة لاستخدامه عند تشغيل أوامر النظام.
`void`	`setEnvVariablePriority ( IRunUtil.EnvPriority priority)` قرر ما إذا كان عدم ضبط متغير البيئة يمثل أولوية أعلى من تعيينها عند إنشاء عملية أم لا.
`void`	`setInterruptibleInFuture (Thread thread, long timeMs)` تعيين كمقاطعة بعد بعض وقت الانتظار.
`void`	`setLinuxInterruptProcess (boolean interrupt)` اسمح باستخدام مقاطعة linux 'kill' في العملية التي تعمل من خلال أساليب #runTimed عندما تصل إلى المهلة المحددة.
`void`	`setRedirectStderrToStdout (boolean redirect)` اضبط تدفق الخطأ القياسي لإعادة التوجيه إلى تدفق الإخراج القياسي عند تشغيل أوامر النظام.
`void`	`setWorkingDir (File dir)` يضبط دليل العمل لأوامر النظام.
`void`	`sleep (long time)` طريقة مساعدة للنوم لوقت معين ، مع تجاهل أي استثناءات.
`void`	`unsetEnvVariable (String key)` إلغاء تعيين متغير بيئة ، لذلك تعمل أوامر النظام بدون متغير البيئة هذا. قد ترث متغيرات البيئة من العملية الأصلية ، لذلك نحتاج إلى حذف متغير البيئة من `ProcessBuilder.environment()`

مجالات

INHERITIO_PREFIX

public static final String INHERITIO_PREFIX

RUNNABLE_NOTIFIER_NAME

public static final String RUNNABLE_NOTIFIER_NAME

المنشأت العامة

RunUtil

public RunUtil ()

قم بإنشاء كائن RunUtil جديد لاستخدامه.

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

السماح المقاطعة

public void allowInterrupt (boolean allow)

يسمح / لا يسمح بتشغيل المقاطعات على مؤشر الترابط الحالي. إذا كان مسموحًا بذلك ، يمكن مقاطعة عمليات تشغيل الخيط الحالي من مؤشرات الترابط الأخرى عبر طريقة interrupt(Thread, String) .

حدود
`allow`	`boolean` : ما إذا كان سيتم السماح بمقاطعات التشغيل على مؤشر الترابط الحالي.

getDefault

public static IRunUtil getDefault ()

احصل على مرجع لكائن RunUtil الافتراضي.

هذا مفيد للمتصلين الذين يريدون استخدام IRunUtil بدون تخصيص. من المستحسن أن يقوم المتصلون الذين يحتاجون إلى مثيل IRunUtil مخصص (أي يحتاجون إلى استدعاء إما setEnvVariable(String, String) أو setWorkingDir(File) لإنشاء نسختهم الخاصة.

عائدات
`IRunUtil`

يقطع

public void interrupt (Thread thread, 
                String message, 
                ErrorIdentifier errorId)

يقطع عمليات التشغيل الجارية / القادمة على مؤشر الترابط المحدد. ستؤدي عمليات التشغيل على مؤشر الترابط المحدد إلى طرح RunInterruptedException .

حدود
`message`	`String` : الرسالة الخاصة بـ `RunInterruptedException` .
`errorId`	`ErrorIdentifier` : يمثل سبب الانقطاع عند معرفته.

يقطع

public void interrupt (Thread thread, 
                String message)

حدود
`message`	`String` : الرسالة الخاصة بـ `RunInterruptedException` .

هو InterruptAllowed

public boolean isInterruptAllowed ()

امنح حالة المقاطعة لـ RunUtil.

عائدات
`boolean`	صحيح إذا كان من الممكن مقاطعة التشغيل ، أو خطأ إذا كان الأمر كذلك.

runCmdInBackground

public Process runCmdInBackground (Redirect redirect, 
                 command)

أسلوب runCmdInBackground(String) بديل يقبل وسيطات الأمر في نموذج ERROR(/List) .

حدود
`redirect`	`Redirect` : `ERROR(/Redirect)` المطلوب تطبيقه على `ProcessBuilder` .
`command`	: `ERROR(/List)` الذي يحتوي على أمر نظام محدد ووسيطات اختياريًا لتنفيذها

عائدات
`Process`	`Process` تنفيذ الأمر

runCmdInBackground

public Process runCmdInBackground ( command)

أسلوب runCmdInBackground(String) بديل يقبل وسيطات الأمر في نموذج ERROR(/List) .

حدود
`command`	: `ERROR(/List)` الذي يحتوي على أمر نظام محدد ووسيطات اختياريًا لتنفيذها

عائدات
`Process`	`Process` تنفيذ الأمر

runCmdInBackground

public Process runCmdInBackground ( command, 
                OutputStream output)

الأمر الذي يتم تشغيله باستخدام ERROR(/OutputStream) يقوم بتسجيل إخراج الأمر. يتم دمج Stdout و stderr معًا.

حدود
`command`	: الأمر للتشغيل
`output`	`OutputStream` : تيار OutputStream لحفظ الإخراج

عائدات
`Process`	`Process` تشغيل الأمر

runCmdInBackground

public Process runCmdInBackground (String... command)

طريقة المساعد لتنفيذ أمر النظام بشكل غير متزامن.

سيعود مباشرة بعد إطلاق الأمر.

حدود
`command`	`String` : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا

عائدات
`Process`	`Process` تنفيذ الأمر

runCmdInBackground

public Process runCmdInBackground (Redirect redirect, 
                String... command)

طريقة المساعد لتنفيذ أمر النظام بشكل غير متزامن.

سيعود مباشرة بعد إطلاق الأمر.

حدود
`redirect`	`Redirect` : `ERROR(/Redirect)` المطلوب تطبيقه على `ProcessBuilder` .
`command`	`String` : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا

عائدات
`Process`	`Process` تنفيذ الأمر

runEscalatingTimedRetry

public boolean runEscalatingTimedRetry (long opTimeout, 
                long initialPollInterval, 
                long maxPollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

منع العملية وتنفيذها عدة مرات حتى تنجح.

زيادة وقت الانتظار بين محاولات التشغيل بشكل كبير. هذا مخصص للاستخدام عند إجراء عملية مثل استقصاء الخادم ، لمنحه وقتًا للتعافي في حالة تعطله مؤقتًا.

حدود
`opTimeout`	`long` : أقصى وقت للانتظار بالمللي ثانية لمحاولة عملية واحدة
`initialPollInterval`	`long` : الوقت الأولي للانتظار بين محاولات العملية
`maxPollInterval`	`long` : أقصى وقت للانتظار بين محاولات العملية
`maxTime`	`long` : إجمالي الوقت التقريبي الأقصى لمواصلة تجربة العملية
`runnable`	`IRunUtil.IRunnableResult` : `IRunUtil.IRunnableResult` للتنفيذ

عائدات
`boolean`	`true` إذا اكتملت العملية بنجاح قبل انتهاء صلاحية maxTime

runFixedTimedRetry

public boolean runFixedTimedRetry (long opTimeout, 
                long pollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

منع العملية وتنفيذها عدة مرات حتى تنجح.

حدود
`opTimeout`	`long` : أقصى وقت للانتظار بالمللي ثانية لمحاولة عملية واحدة
`pollInterval`	`long` : الوقت الأولي للانتظار بين محاولات العملية
`maxTime`	`long` : إجمالي الوقت التقريبي الأقصى لمواصلة تجربة العملية
`runnable`	`IRunUtil.IRunnableResult` : `IRunUtil.IRunnableResult` للتنفيذ

عائدات
`boolean`	`true` إذا اكتملت العملية بنجاح قبل انتهاء صلاحية maxTime

runTimed

public CommandStatus runTimed (long timeout, 
                IRunUtil.IRunnableResult runnable, 
                boolean logErrors)

حظر وتنفيذ عملية ، والإيقاف إذا استغرقت وقتًا أطول من الوقت المحدد.

حدود
`timeout`	`long` : أقصى وقت للانتظار بالمللي ثانية
`runnable`	`IRunUtil.IRunnableResult` : `IRunUtil.IRunnableResult` للتنفيذ
`logErrors`	`boolean` : سجل أخطاء استثناء أم لا.

عائدات
`CommandStatus`	`CommandStatus` نتيجة العملية.

runTimedCmd

public CommandResult runTimedCmd (long timeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                String... command)

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

حدود
`timeout`	`long` : المهلة القصوى للانتظار بالمللي ثانية. 0 يعني عدم وجود مهلة.
`stdout`	`OutputStream` : `ERROR(/OutputStream)` حيث سيتم إعادة توجيه إخراج std. يمكن أن تكون خالية.
`stderr`	`OutputStream` : `ERROR(/OutputStream)` حيث سيتم إعادة توجيه ناتج الخطأ. يمكن أن تكون خالية.
`command`	`String` : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا

عائدات
`CommandResult`	يحتوي `CommandResult` على نتيجة من تشغيل الأمر

runTimedCmd

public CommandResult runTimedCmd (long timeout, 
                String... command)

طريقة المساعد لتنفيذ أمر النظام ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد.

حدود
`timeout`	`long` : أقصى وقت للانتظار بالمللي ثانية. 0 يعني عدم وجود مهلة.
`command`	`String` : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا

عائدات
`CommandResult`	يحتوي `CommandResult` على نتيجة من تشغيل الأمر

runTimedCmdRetry

public CommandResult runTimedCmdRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

طريقة المساعد لتنفيذ أمر النظام ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد.

حدود
`timeout`	`long` : أقصى وقت للانتظار بالمللي ثانية لكل محاولة
`retryInterval`	`long` : وقت الانتظار بين محاولات إعادة الأمر
`attempts`	`int` : أقصى عدد من محاولات المحاولة
`command`	`String` : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا

عائدات
`CommandResult`	يحتوي `CommandResult` على نتيجة من تشغيل الأمر

runTimedCmd بصمت

public CommandResult runTimedCmdSilently (long timeout, 
                String... command)

طريقة المساعد لتنفيذ أمر النظام ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد. مشابه لـ runTimedCmd(long, String) ، لكنه لا يسجل أي أخطاء عند الاستثناء.

حدود
`timeout`	`long` : أقصى وقت للانتظار بالمللي ثانية
`command`	`String` : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا

عائدات
`CommandResult`	يحتوي `CommandResult` على نتيجة من تشغيل الأمر

runTimedCmd بصمت إعادة المحاولة

public CommandResult runTimedCmdSilentlyRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

طريقة المساعد لتنفيذ أمر النظام ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد. مشابه لـ runTimedCmdRetry(long, long, int, String[]) ، لكنه لا يسجل أي أخطاء في الاستثناء.

حدود
`timeout`	`long` : أقصى وقت للانتظار بالمللي ثانية
`retryInterval`	`long` : وقت الانتظار بين محاولات إعادة الأمر
`attempts`	`int` : أقصى عدد من محاولات المحاولة
`command`	`String` : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا

عائدات
`CommandResult`	يحتوي `CommandResult` على نتيجة من تشغيل الأمر

runTimedCmdWithInput

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                File stdoutFile, 
                File stderrFile, 
                String... command)

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

حدود
`timeout`	`long` : المهلة القصوى للانتظار بالمللي ثانية. 0 يعني عدم وجود مهلة.
`input`	`String` : إدخال stdin لتمريرها إلى العملية
`stdoutFile`	`File` : `ERROR(/File)` حيث سيتم إعادة توجيه إخراج std. يمكن أن تكون خالية.
`stderrFile`	`File` : `ERROR(/File)` حيث سيتم إعادة توجيه ناتج الخطأ. يمكن أن تكون خالية.
`command`	`String` : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا

عائدات
`CommandResult`	يحتوي `CommandResult` على نتيجة من تشغيل الأمر

runTimedCmdWithInput

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                String... command)

طريقة Helper لتنفيذ أمر نظام يتطلب إدخال stdin ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد.

حدود
`timeout`	`long` : أقصى وقت للانتظار بالمللي ثانية
`input`	`String` : إدخال stdin لتمريرها إلى العملية
`command`	`String` : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا

عائدات
`CommandResult`	يحتوي `CommandResult` على نتيجة من تشغيل الأمر

runTimedCmdWithInput

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                 command)

طريقة Helper لتنفيذ أمر نظام يتطلب إدخال stdin ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد.

حدود
`timeout`	`long` : أقصى وقت للانتظار بالمللي ثانية
`input`	`String` : إدخال stdin لتمريرها إلى العملية
`command`	: `ERROR(/List)` يحتوي على أمر النظام والوسيطات الاختيارية للتنفيذ

عائدات
`CommandResult`	يحتوي `CommandResult` على نتيجة من تشغيل الأمر

runTimedCmdWithInputRedirect

public CommandResult runTimedCmdWithInputRedirect (long timeout, 
                File inputRedirect, 
                String... command)

طريقة Helper لتنفيذ أمر نظام يتطلب إعادة توجيه Stdin من ملف ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد.

حدود
`timeout`	`long` : أقصى وقت للانتظار بالمللي ثانية
`inputRedirect`	`File` : `ERROR(/File)` لإعادة التوجيه كمدخل قياسي باستخدام `ProcessBuilder.redirectInput()` . إذا كانت القيمة فارغة ، فلن يتم إعادة توجيه stdin.
`command`	`String` : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا

عائدات
`CommandResult`	يحتوي `CommandResult` على نتيجة من تشغيل الأمر

runTimedRetry

public boolean runTimedRetry (long opTimeout, 
                long pollInterval, 
                int attempts, 
                IRunUtil.IRunnableResult runnable)

منع العملية وتنفيذها عدة مرات حتى تنجح.

حدود
`opTimeout`	`long` : أقصى وقت للانتظار بالمللي ثانية لمحاولة عملية واحدة
`pollInterval`	`long` : وقت الانتظار بين محاولات إعادة الأمر
`attempts`	`int` : أقصى عدد من محاولات المحاولة
`runnable`	`IRunUtil.IRunnableResult` : `IRunUtil.IRunnableResult` للتنفيذ

عائدات
`boolean`	`true` إذا اكتملت العملية بنجاح قبل الوصول إلى المحاولات.

setEnvVariable

public void setEnvVariable (String name, 
                String value)

يضبط متغير بيئة لاستخدامه عند تشغيل أوامر النظام.

حدود
`name`	`String` : اسم المتغير
`value`	`String` : القيمة المتغيرة

setEnvVariable الأولوية

public void setEnvVariablePriority (IRunUtil.EnvPriority priority)

قرر ما إذا كان عدم ضبط متغير البيئة يمثل أولوية أعلى من تعيينها عند إنشاء عملية أم لا. بشكل افتراضي ، يكون إلغاء الضبط أولوية أعلى: بمعنى أنه إذا تم إجراء محاولة لتعيين متغير بنفس الاسم ، فلن يحدث ذلك لأن المتغير لن يتم تعيينه. لا يمكن استخدامها على المثيل الافتراضي IRunUtil .

حدود
`priority`	`IRunUtil.EnvPriority`

setInterruptibleInFuture

public void setInterruptibleInFuture (Thread thread, 
                long timeMs)

تعيين كمقاطعة بعد بعض وقت الانتظار. ERROR(/CommandScheduler#shutdownHard()) لفرض إنهاء العمل في النهاية.

حدود
`thread`	`Thread` : الخيط الذي سيصبح قابلاً للمقاطعة.
`timeMs`	`long` : حان وقت الانتظار قبل ضبط المقاطعة.

setLinuxInterruptProcess

public void setLinuxInterruptProcess (boolean interrupt)

اسمح باستخدام مقاطعة linux 'kill' في العملية التي تعمل من خلال أساليب #runTimed عندما تصل إلى المهلة المحددة. لا يمكن استخدامها على المثيل الافتراضي IRunUtil .

حدود
`interrupt`	`boolean`

setRedirectStderrToStdout

public void setRedirectStderrToStdout (boolean redirect)

اضبط تدفق الخطأ القياسي لإعادة التوجيه إلى تدفق الإخراج القياسي عند تشغيل أوامر النظام. القيمة الأولية خاطئة.

حدود
`redirect`	`boolean` : قيمة جديدة لإعادة التوجيه من عدمه

setWorkingDir

public void setWorkingDir (File dir)

يضبط دليل العمل لأوامر النظام.

حدود
`dir`	`File` : دليل العمل

ينام

public void sleep (long time)

طريقة مساعدة للنوم لوقت معين ، مع تجاهل أي استثناءات.

حدود
`time`	`long` : مللي للنوم. سيتم تجاهل القيم التي تقل عن 0 أو تساويها

unsetEnvvariable

public void unsetEnvVariable (String key)

إلغاء تعيين متغير بيئة ، لذلك تعمل أوامر النظام بدون متغير البيئة هذا. قد ترث متغيرات البيئة من العملية الأصلية ، لذلك نحتاج إلى حذف متغير البيئة من ProcessBuilder.environment()

حدود
`key`	`String` : اسم المتغير

أنظر أيضا:

ProcessBuilder.environment()