החל משנת 2026, כדי להתאים למודל הפיתוח היציב שלנו ולשמור על יציבות הפלטפורמה בסביבה העסקית, נפרסם קוד מקור ב-AOSP ברבעון השני וברבעון הרביעי. כדי ליצור ולתרום ל-AOSP, צריך להשתמש ב-android-latest-release. הענף android-latest-release manifest תמיד יפנה לגרסה האחרונה שנדחפה ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

RunUtil

public class RunUtil
extends Object implements IRunUtil

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

אוסף של שיטות עזר להפעלת פעולות.

סיכום

ערכים קבועים
`String`	`INHERITIO_PREFIX`
`String`	`RUNNABLE_NOTIFIER_NAME`

‫constructors ציבוריים
`RunUtil()` יוצרים אובייקט `RunUtil` חדש לשימוש.
`RunUtil(boolean inheritEnvVars)`

‫methods ציבוריים
`void`	`allowInterrupt(boolean allow)` מאפשרת או אוסרת על הפרעות בהרצת השרשור הנוכחי.
`ProcessBuilder`	`createProcessBuilder(ProcessBuilder.Redirect redirect, List<String> commandList, boolean enableCache)`
`static IRunUtil`	`getDefault()` מקבלים הפניה לאובייקט `RunUtil` שמוגדר כברירת מחדל.
`void`	`interrupt(Thread thread, String message, ErrorIdentifier errorId)` מפסיקה את פעולות ההרצה המתמשכות או הקרובות בשרשור הנתון.
`void`	`interrupt(Thread thread, String message)` מפסיקה את פעולות ההרצה המתמשכות או הקרובות בשרשור הנתון.
`boolean`	`isInterruptAllowed()` החזרת סטטוס ההפרעה של RunUtil.
`Process`	`runCmdInBackground(ProcessBuilder.Redirect redirect, List<String> command)` שיטה חלופית `runCmdInBackground(String...)` שמקבלת את ארגומנטי הפקודה בפורמט `List`.
`Process`	`runCmdInBackground(ProcessBuilder.Redirect redirect, String... command)` שיטת עזר להרצת פקודת מערכת באופן אסינכרוני.
`Process`	`runCmdInBackground(List<String> command)` שיטה חלופית `runCmdInBackground(String...)` שמקבלת את ארגומנטי הפקודה בפורמט `List`.
`Process`	`runCmdInBackground(String... command)` שיטת עזר להרצת פקודת מערכת באופן אסינכרוני.
`Process`	`runCmdInBackground(List<String> command, OutputStream output)` הפעלת הפקודה עם `OutputStream` תרשום את הפלט של הפקודה.
`boolean`	`runEscalatingTimedRetry(long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)` חסימה וביצוע של פעולה כמה פעמים עד שהיא מצליחה.
`boolean`	`runFixedTimedRetry(long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)` חסימה וביצוע של פעולה כמה פעמים עד שהיא מצליחה.
`boolean`	`runFixedTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)` חסימה וביצוע של פעולה כמה פעמים עד שהיא מצליחה.
`CommandStatus`	`runTimed(long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)` חסימה וביצוע של פעולה, ביטול אם הפעולה נמשכת יותר מזמן מוגדר.
`CommandResult`	`runTimedCmd(long timeout, String... command)` שיטת עזר להרצת פקודה במערכת, וביטול אם הפקודה נמשכת יותר מזמן מוגדר.
`CommandResult`	`runTimedCmd(long timeout, OutputStream stdout, OutputStream stderr, String... command)` שיטת עזר להפעלת פקודה במערכת, ביטול אם הפעולה נמשכת יותר מהזמן שצוין והפניית הפלט לקבצים אם צוין.
`CommandResult`	`runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)` שיטת עזר להרצת פקודה במערכת, וביטול אם הפקודה נמשכת יותר מזמן מוגדר.
`CommandResult`	`runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, 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, String... command)` שיטת עזר להפעלת פקודה במערכת שנדרש לה קלט stdin, וביטול הפעולה אם היא נמשכת יותר מזמן מוגדר.
`CommandResult`	`runTimedCmdWithInput(long timeout, String input, List<String> command)` שיטת עזר להפעלת פקודה במערכת שנדרש לה קלט stdin, וביטול הפעולה אם היא נמשכת יותר מזמן מוגדר.
`CommandResult`	`runTimedCmdWithInput(long timeout, String input, File stdoutFile, File stderrFile, String... command)` שיטת עזר להפעלת פקודה במערכת, ביטול אם הפעולה נמשכת יותר מהזמן שצוין והפניית הפלט לקבצים אם צוין.
`CommandResult`	`runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)` שיטת עזר להפעלת פקודה במערכת שדורשת הפניה של Stdin מקובץ, וביטול אם הפעולה נמשכת יותר מהזמן שצוין.
`CommandResult`	`runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)` שיטת עזר להרצת פקודה במערכת, וביטול אם הפקודה נמשכת יותר מזמן מוגדר.
`CommandResult`	`runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)` שיטת עזר להפעלת פקודה במערכת, ביטול אם הפעולה נמשכת יותר מהזמן שצוין והפניית הפלט לקבצים אם צוין.
`boolean`	`runTimedRetry(long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)` חסימה וביצוע של פעולה כמה פעמים עד שהיא מצליחה.
`boolean`	`runTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)` חסימה וביצוע של פעולה כמה פעמים עד שהיא מצליחה.
`CommandStatus`	`runTimedWithOutputMonitor(long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)` חסימה וביצוע של פעולה, ביטול אם הפעולה נמשכת יותר מזמן מוגדר.
`void`	`setEnvVariable(String name, String value)` מגדיר משתנה סביבה לשימוש בהרצת פקודות מערכת.
`void`	`setEnvVariablePriority(IRunUtil.EnvPriority priority)` מחליטים אם כשיוצרים תהליך, ביטול ההגדרה של משתנה סביבה הוא בעדיפות גבוהה יותר מהגדרת משתנה סביבה.
`void`	`setInterruptibleInFuture(Thread thread, long timeMs)` הגדרה כהודעה שניתן להפסיק אחרי פרק זמן מסוים.
`void`	`setLinuxInterruptProcess(boolean interrupt)` הגדרה שמאפשרת להשתמש בהפרעה 'kill' של Linux בתהליך שמופעל באמצעות שיטות ‎ #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

ערך קבוע: "inheritio-"

RUNNABLE_NOTIFIER_NAME

public static final String RUNNABLE_NOTIFIER_NAME

ערך קבוע: "RunnableNotifier"

‫constructors ציבוריים

RunUtil

public RunUtil ()

יוצרים אובייקט RunUtil חדש לשימוש.

RunUtil

public RunUtil (boolean inheritEnvVars)

פרמטרים
`inheritEnvVars`	`boolean`

‫methods ציבוריים

allowInterrupt

public void allowInterrupt (boolean allow)

מאפשרת או אוסרת על הפרעות בהרצת השרשור הנוכחי. אם הפעולה מותרת, אפשר להפריע לפעולות של השרשור הנוכחי משרשורים אחרים באמצעות השיטה interrupt(Thread, String).

פרמטרים
`allow`	‫`boolean`: האם לאפשר הפרעות בהרצה בשרשור הנוכחי.

createProcessBuilder

public ProcessBuilder createProcessBuilder (ProcessBuilder.Redirect redirect, 
                List<String> commandList, 
                boolean enableCache)

פרמטרים
`redirect`	`ProcessBuilder.Redirect`
`commandList`	`List`
`enableCache`	`boolean`

החזרות
`ProcessBuilder`

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`.

isInterruptAllowed

public boolean isInterruptAllowed ()

החזרת סטטוס ההפרעה של RunUtil.

החזרות
`boolean`	הערך true אם אפשר להפריע להרצה, אחרת הערך false.

runCmdInBackground

public Process runCmdInBackground (ProcessBuilder.Redirect redirect, 
                List<String> command)

שיטה חלופית runCmdInBackground(String...) שמקבלת את ארגומנטי הפקודה בפורמט List.

פרמטרים
`redirect`	`ProcessBuilder.Redirect`: ה-`Redirect` שיחול על `ProcessBuilder`.
`command`	‫`List`: `List` שמכיל את פקודת המערכת שצוינה, ואופציונלית ארגומנטים להרצה

החזרות
`Process`	הפקודה `Process` שהופעלה

הקפצת הודעות שגיאה (throw)
`IOException`

runCmdInBackground

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

שיטת עזר להרצת פקודת מערכת באופן אסינכרוני.

הפקודה תחזיר ערך מיד אחרי ההפעלה.

פרמטרים
`redirect`	`ProcessBuilder.Redirect`: ה-`Redirect` שיחול על `ProcessBuilder`.
`command`	‫`String`: פקודת המערכת שצוינה, וארגומנטים אופציונליים להרצה

החזרות
`Process`	הפקודה `Process` שהופעלה

הקפצת הודעות שגיאה (throw)
`IOException`

runCmdInBackground

public Process runCmdInBackground (List<String> command)

שיטה חלופית runCmdInBackground(String...) שמקבלת את ארגומנטי הפקודה בפורמט List.

פרמטרים
`command`	‫`List`: `List` שמכיל את פקודת המערכת שצוינה, ואופציונלית ארגומנטים להרצה

החזרות
`Process`	הפקודה `Process` שהופעלה

הקפצת הודעות שגיאה (throw)
`IOException`

runCmdInBackground

public Process runCmdInBackground (String... command)

שיטת עזר להרצת פקודת מערכת באופן אסינכרוני.

הפקודה תחזיר ערך מיד אחרי ההפעלה.

פרמטרים
`command`	‫`String`: פקודת המערכת שצוינה, וארגומנטים אופציונליים להרצה

החזרות
`Process`	הפקודה `Process` שהופעלה

הקפצת הודעות שגיאה (throw)
`IOException`

runCmdInBackground

public Process runCmdInBackground (List<String> command, 
                OutputStream output)

הפעלת הפקודה עם OutputStream תרשום את הפלט של הפקודה. הפלט הרגיל והפלט של שגיאות מוזגו יחד.

פרמטרים
`command`	‫`List`: הפקודה להרצה
`output`	‫`OutputStream`: ה-OutputStream שבו שומרים את הפלט

החזרות
`Process`	המשתמש `Process` שמריץ את הפקודה

הקפצת הודעות שגיאה (throw)
`IOException`

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` אם הפעולה הושלמה בהצלחה לפני שחלף הזמן המקסימלי

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` אם הפעולה הושלמה בהצלחה לפני שחלף הזמן המקסימלי

runFixedTimedRetryWithOutputMonitor

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

חסימה וביצוע של פעולה כמה פעמים עד שהיא מצליחה. הוא גם עוקב אחרי זרמי הפלט כדי לזהות פעילות, ומבטל את הפעולה אם לא מזוהה פעילות בזרם במשך פרק זמן מוגדר. אם הערך של idleOutputTimeout מוגדר לאפס, לא יתבצע ניטור של הזרם.

פרמטרים
`opTimeout`	‫`long`: הזמן המקסימלי להמתנה באלפיות השנייה לניסיון בודד של פעולה
`idleOutputTimeout`	‫`long`: משך הזמן המקסימלי להמתנה באלפיות השנייה לפלט בזרמי הפלט
`pollInterval`	‫`long`: משך הזמן הראשוני להמתנה בין ניסיונות הפעולה
`maxTime`	‫`long`: משך הזמן הכולל המקסימלי המשוער לניסיון חוזר של הפעולה
`runnable`	`IRunUtil.IRunnableResult`: `IRunUtil.IRunnableResult` להפעלה

החזרות
`boolean`	‫`true` אם הפעולה הושלמה בהצלחה לפני שחלף הזמן המקסימלי

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, 
                String... command)

שיטת עזר להרצת פקודה במערכת, וביטול אם הפקודה נמשכת יותר מזמן מוגדר.

פרמטרים
`timeout`	‫`long`: הזמן המקסימלי להמתנה באלפיות השנייה. 0 מציין שאין זמן קצוב לתפוגה.
`command`	‫`String`: פקודת המערכת שצוינה, וארגומנטים אופציונליים להרצה

החזרות
`CommandResult`	‫`CommandResult` שמכיל את התוצאה מהרצת הפקודה

runTimedCmd

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

שיטת עזר להפעלת פקודה במערכת, ביטול אם הפעולה נמשכת יותר מהזמן שצוין והפניית הפלט לקבצים אם צוין. כשמספקים את OutputStream בדרך הזו, הם נשארים פתוחים בסוף הפונקציה.

פרמטרים
`timeout`	‫`long`: זמן קצוב לתפוגה, הזמן המקסימלי להמתנה באלפיות השנייה. 0 מציין שאין זמן קצוב לתפוגה.
`stdout`	‫`OutputStream`: `OutputStream` לאן הפלט הרגיל יופנה. יכול להיות null.
`stderr`	‫`OutputStream`: `OutputStream` לאן יופנה פלט השגיאה. יכול להיות null.
`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` שמכיל את התוצאה מהרצת הפקודה

runTimedCmdRetryWithOutputMonitor

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

שיטת עזר להרצת פקודה במערכת, וביטול אם הפקודה נמשכת יותר מזמן מוגדר. הוא גם עוקב אחרי זרמי הפלט כדי לזהות פעילות, ומבטל את הפעולה אם לא מזוהה פעילות בזרם במשך פרק זמן מסוים. אם הערך של idleOutputTimeout הוא אפס, לא יתבצע ניטור של הזרם.

פרמטרים
`timeout`	‫`long`: משך ההמתנה המקסימלי באלפיות השנייה לכל ניסיון
`idleOutputTimeout`	‫`long`: משך הזמן המקסימלי להמתנה באלפיות השנייה לפלט בזרמי הפלט
`retryInterval`	‫`long`: משך הזמן להמתנה בין ניסיונות חוזרים של פקודה
`attempts`	‫`int`: המספר המקסימלי של ניסיונות
`command`	‫`String`: פקודת המערכת שצוינה, וארגומנטים אופציונליים להרצה

החזרות
`CommandResult`	‫`CommandResult` שמכיל את התוצאה מהרצת הפקודה

runTimedCmdSilently

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

שיטת עזר להרצת פקודה במערכת, וביטול אם הפקודה נמשכת יותר מזמן מוגדר. דומה ל-runTimedCmd(long,String...), אבל לא מתעד שגיאות בחריג.

פרמטרים
`timeout`	‫`long`: זמן ההמתנה המקסימלי במילישניות
`command`	‫`String`: פקודת המערכת שצוינה, וארגומנטים אופציונליים להרצה

החזרות
`CommandResult`	‫`CommandResult` שמכיל את התוצאה מהרצת הפקודה

runTimedCmdSilentlyRetry

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, 
                String... command)

שיטת עזר להפעלת פקודה במערכת שנדרש לה קלט stdin, וביטול הפעולה אם היא נמשכת יותר מזמן מוגדר.

פרמטרים
`timeout`	‫`long`: זמן ההמתנה המקסימלי במילישניות
`input`	‫`String`: קלט stdin להעברה לתהליך
`command`	‫`String`: פקודת המערכת שצוינה, וארגומנטים אופציונליים להרצה

החזרות
`CommandResult`	‫`CommandResult` שמכיל את התוצאה מהרצת הפקודה

runTimedCmdWithInput

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                List<String> command)

שיטת עזר להפעלת פקודה במערכת שנדרש לה קלט stdin, וביטול הפעולה אם היא נמשכת יותר מזמן מוגדר.

פרמטרים
`timeout`	‫`long`: זמן ההמתנה המקסימלי במילישניות
`input`	‫`String`: קלט stdin להעברה לתהליך
`command`	‫`List`: `List` שמכיל את פקודת המערכת ואופציונלית את הארגומנטים להרצה

החזרות
`CommandResult`	‫`CommandResult` שמכיל את התוצאה מהרצת הפקודה

runTimedCmdWithInput

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

שיטת עזר להפעלת פקודה במערכת, ביטול אם הפעולה נמשכת יותר מהזמן שצוין והפניית הפלט לקבצים אם צוין.

פרמטרים
`timeout`	‫`long`: זמן קצוב לתפוגה, הזמן המקסימלי להמתנה באלפיות השנייה. 0 מציין שאין זמן קצוב לתפוגה.
`input`	‫`String`: קלט stdin להעברה לתהליך
`stdoutFile`	‫`File`: `File` לאן הפלט הרגיל יופנה. יכול להיות null.
`stderrFile`	‫`File`: `File` לאן יופנה פלט השגיאה. יכול להיות null.
`command`	‫`String`: פקודת המערכת שצוינה, וארגומנטים אופציונליים להרצה

החזרות
`CommandResult`	‫`CommandResult` שמכיל את התוצאה מהרצת הפקודה

runTimedCmdWithInputRedirect

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

שיטת עזר להפעלת פקודה במערכת שדורשת הפניה של Stdin מקובץ, וביטול אם הפעולה נמשכת יותר מהזמן שצוין.

פרמטרים
`timeout`	‫`long`: זמן ההמתנה המקסימלי במילישניות
`inputRedirect`	‫`File`: `File` להפניה אוטומטית כקלט רגיל באמצעות `ProcessBuilder.redirectInput()`. אם הערך הוא null, לא תתבצע הפניה אוטומטית של stdin.
`command`	‫`String`: פקודת המערכת שצוינה, וארגומנטים אופציונליים להרצה

החזרות
`CommandResult`	‫`CommandResult` שמכיל את התוצאה מהרצת הפקודה

runTimedCmdWithOutputMonitor

public CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                String... command)

פרמטרים
`timeout`	‫`long`: הזמן המקסימלי להמתנה באלפיות השנייה. 0 מציין שאין זמן קצוב לתפוגה.
`idleOutputTimeout`	‫`long`: משך הזמן המקסימלי להמתנה באלפיות השנייה לפלט בזרמי הפלט
`command`	‫`String`: פקודת המערכת שצוינה, וארגומנטים אופציונליים להרצה

החזרות
`CommandResult`	‫`CommandResult` שמכיל את התוצאה מהרצת הפקודה

runTimedCmdWithOutputMonitor

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

פרמטרים
`timeout`	‫`long`: זמן קצוב לתפוגה, הזמן המקסימלי להמתנה באלפיות השנייה. 0 מציין שאין זמן קצוב לתפוגה.
`idleOutputTimeout`	‫`long`: משך הזמן המקסימלי להמתנה באלפיות השנייה לפלט בזרמי הפלט
`stdout`	‫`OutputStream`: `OutputStream` לאן הפלט הרגיל יופנה. יכול להיות null.
`stderr`	‫`OutputStream`: `OutputStream` לאן יופנה פלט השגיאה. יכול להיות null.
`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` אם הפעולה הושלמה בהצלחה לפני שהניסיונות הגיעו.

runTimedRetryWithOutputMonitor

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

פרמטרים
`opTimeout`	‫`long`: הזמן המקסימלי להמתנה באלפיות השנייה לניסיון אחד של פעולה
`idleOutputTimeout`	‫`long`: משך הזמן המקסימלי להמתנה באלפיות השנייה לפלט בזרמי הפלט
`pollInterval`	‫`long`: משך הזמן להמתנה בין ניסיונות חוזרים של פקודה
`attempts`	‫`int`: המספר המקסימלי של ניסיונות
`runnable`	`IRunUtil.IRunnableResult`: `IRunUtil.IRunnableResult` להפעלה

החזרות
`boolean`	‫`true` אם הפעולה הושלמה בהצלחה לפני שהניסיונות הגיעו.

runTimedWithOutputMonitor

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

חסימה וביצוע של פעולה, ביטול אם הפעולה נמשכת יותר מזמן מוגדר. בנוסף, הוא עוקב אחרי זרמי הפלט כדי לזהות פעילות, ומבטל את הפעולה אם לא מזוהה פעילות בזרם במשך זמן מסוים. אם הערך של idleOutputTimeout מוגדר לאפס, לא יתבצע ניטור של הזרם.

פרמטרים
`timeout`	‫`long`: זמן ההמתנה המקסימלי במילישניות
`idleOutputTimeout`	‫`long`: משך הזמן המקסימלי להמתנה באלפיות השנייה לפלט בזרמי הפלט
`runnable`	`IRunUtil.IRunnableResult`: `IRunUtil.IRunnableResult` להפעלה
`logErrors`	‫`boolean`: רישום שגיאות ביומן במקרה של חריגה או לא.

החזרות
`CommandStatus`	התוצאה של הפעולה `CommandStatus`.

setEnvVariable

public void setEnvVariable (String name, 
                String value)

מגדיר משתנה סביבה לשימוש בהרצת פקודות מערכת.

פרמטרים
`name`	‫`String`: שם המשתנה
`value`	‫`String`: ערך המשתנה

setEnvVariablePriority

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)

הגדרה שמאפשרת להשתמש בהפרעה 'kill' של Linux בתהליך שמופעל באמצעות שיטות ‎ #runTimed כשהוא מגיע לזמן קצוב לתפוגה. אי אפשר להשתמש בהן במופע ברירת המחדל של IRunUtil.

פרמטרים
`interrupt`	`boolean`

setRedirectStderrToStdout

public void setRedirectStderrToStdout (boolean redirect)

מגדירים את זרם השגיאות הרגיל להפניה לזרם הפלט הרגיל כשמריצים פקודות מערכת. הערך ההתחלתי הוא False.

פרמטרים
`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()