מתזמן המשימות

public interface ICommandScheduler

com.android.tradefed.command.ICommandScheduler

מתזמן להרצת פקודות TradeFederation.

סיכום

מחלקות מקוננות

interface ICommandScheduler.IScheduledInvocationListener

האזנה לאירועי הפעלה בסיום ההפעלה. 

שיטות ציבוריות

abstract boolean addCommand(String[] args)

הוספת פקודה לתזמון.

abstract void addCommandFile(String cmdFile, extraArgs)

הוספה של כל הפקודות מקובץ נתון למתזמן

abstract void await()

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

abstract void completeHandover()

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

abstract void displayCommandQueue(PrintWriter printWriter)

פלט מידע מפורט על ניפוי באגים לגבי מצב תור ביצוע הפקודות.

abstract void displayCommandsInfo(PrintWriter printWriter, String regex)

יוצרים פלט של רשימה של הפקודות הנוכחיות.

abstract void displayInvocationsInfo(PrintWriter printWriter)

הצגת רשימה של ההפעלות הנוכחיות.

abstract void dumpCommandsXml(PrintWriter printWriter, String regex)

מציגים את קובץ ה-XML המורחב של הפקודה עם כל הפרטים צוינו ערכים של Option לכל הפקודות הנוכחיות.

abstract void execCommand(IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args)

הקצאת מכשיר ישירות והרצת פקודה בלי להוסיף אותו לתור הפקודות באמצעות IInvocationContext קיים.

abstract void execCommand(ICommandScheduler.IScheduledInvocationListener listener, String[] args)

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

abstract void execCommand(ICommandScheduler.IScheduledInvocationListener listener, ITestDevice device, String[] args)

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

abstract CommandFileWatcher getCommandFileWatcher()

קבלת אסימוני CommandFileWatcher המתאימים לתזמון הזה

abstract int getExecutingCommandCount()

הפונקציה מחזירה את מספר הפקודות במצב ביצוע.

abstract String getInvocationInfo(int invocationId)

להחזיר את המידע על ממשק ההפעלה שמצוין בו מזהה ההפעלה.

abstract CommandRunner.ExitCode getLastInvocationExitCode()

מחזירה את קוד השגיאה של ההפעלה האחרונה שרצה.

abstract Throwable getLastInvocationThrowable()

מחזירה את הערך Throwable מההפעלה האחרונה שרצה.

abstract int getReadyCommandCount()

הפונקציה מחזירה את מספר הפקודות במצב Ready בתור.

abstract void handoverInitiationComplete()

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

abstract boolean handoverShutdown(int handoverPort)

הפעלת shutdown() והעברה לתהליך אחר שבוצע עבורו סחר משותף באותו המארח הזה.

abstract void join()

בהמתנה להשלמת המתזמן.

abstract void join(long millis)

בהמתנה להשלמת המתזמן או לסיום הזמן הקצוב לתפוגה אחרי משך הזמן שצוין באלפיות השנייה.

abstract void removeAllCommands()

הסרת כל הפקודות מהמתזמן

abstract void setClearcutClient(ClearcutClient client)

הגדרת הלקוח לדיווח על נתוני רתמות

abstract boolean shouldShutdownOnCmdfileError()

פונקציה זו מחזירה את הערך true אם יש צורך לכבות את המתזמן במקרה של שגיאות פקודה

abstract void shutdown()

כדאי לנסות לכבות באלגנטיות את מתזמן הפקודות.

abstract void shutdownHard(boolean killAdb)

ניסיון לכבות בכוח את מתזמן הפקודות.

abstract void shutdownHard()

ניסיון לכבות בכוח את מתזמן הפקודות.

abstract void shutdownOnEmpty()

דומה ל-shutdown(), אבל ימתין עד שכל הפקודות יבוצעו לפני היציאה.

abstract void start()

מפעילים את ICommandScheduler.

abstract boolean stopInvocation(int invocationId, String cause)

כדי להפסיק הפעלה רצה, מציינים את המזהה.

default boolean stopInvocation(int invocationId)

כדי להפסיק הפעלה רצה, מציינים את המזהה.

abstract boolean stopInvocation(ITestInvocation invocation)

הפסקת ההפעלה הרצה.

שיטות ציבוריות

addCommand

public abstract boolean addCommand (String[] args)

הוספת פקודה לתזמון.

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

אם "--help" מצוין ארגומנט, טקסט העזרה עבור הפלט של ההגדרה יישלח אל stdout. אחרת, ההגדרה תתווסף לרשימת 'הבאים בתור' אל לרוץ.

פרמטרים
args String: הארגומנטים מסוג config.
החזרות
boolean true אם הפקודה נוספה בהצלחה
קליעות
ConfigurationException אם לא ניתן לנתח את הפקודה

addCommandFile

public abstract void addCommandFile (String cmdFile, 
                 extraArgs)

הוספה של כל הפקודות מקובץ נתון למתזמן

פרמטרים
cmdFile String: נתיב מערכת הקבצים של קובץ comand
extraArgs : ERROR(/List) מתוך String ארגומנטים לצירוף לכל פקודה שנותחה מקובץ. השדה יכול להיות ריק אבל לא יכול להיות null.
קליעות
ConfigurationException אם אי אפשר לנתח את קובץ הפקודה

למידע נוסף:

לחכות

public abstract void await ()

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

להשלים את ה-Handover

public abstract void completeHandover ()

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

displayCommandQueue

public abstract void displayCommandQueue (PrintWriter printWriter)

פלט מידע מפורט על ניפוי באגים לגבי מצב תור ביצוע הפקודות.

displayCommandsInfo

public abstract void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

יוצרים פלט של רשימה של הפקודות הנוכחיות.

פרמטרים
printWriter PrintWriter: ה-ERROR(/PrintWriter) שאליו יש לשלוח את הפלט.
regex String: הביטוי הרגולרי שאליו צריך להתאים פקודות כדי מודפס. אם הערך הוא null, כל הפקודות יודפסו.

displayInvocationsInfo

public abstract void displayInvocationsInfo (PrintWriter printWriter)

הצגת רשימה של ההפעלות הנוכחיות.

פרמטרים
printWriter PrintWriter: ה-ERROR(/PrintWriter) שאליו יש לשלוח את הפלט.

dumpCommandsXml

public abstract void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

מציגים את קובץ ה-XML המורחב של הפקודה עם כל הפרטים צוינו ערכים של Option לכל הפקודות הנוכחיות.

פרמטרים
printWriter PrintWriter: ה-ERROR(/PrintWriter) שאליו צריך לשלוח את הסטטוס.
regex String: הביטוי הרגולרי שאליו צריך להתאים פקודות לפי הסדר xml. אם הערך הוא null, כל הפקודות יושלכו.

פקודה

public abstract void execCommand (IInvocationContext context, 
                ICommandScheduler.IScheduledInvocationListener listener, 
                String[] args)

הקצאת מכשיר ישירות והרצת פקודה בלי להוסיף אותו לתור הפקודות באמצעות IInvocationContext קיים.

פרמטרים
context IInvocationContext: IInvocationContext קיים.
listener ICommandScheduler.IScheduledInvocationListener: הICommandScheduler.IScheduledInvocationListener שצריך לעדכן
args String: הארגומנטים של הפקודה
קליעות
ConfigurationException אם הפקודה לא הייתה חוקית
NoDeviceException אם אין מכשיר להשתמש בו

פקודה

public abstract void execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                String[] args)

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

פרמטרים
listener ICommandScheduler.IScheduledInvocationListener: הICommandScheduler.IScheduledInvocationListener שצריך לעדכן
args String: הארגומנטים של הפקודה
קליעות
ConfigurationException אם הפקודה לא הייתה חוקית
NoDeviceException אם אין מכשיר להשתמש בו

פקודה

public abstract void execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                ITestDevice device, 
                String[] args)

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

פרמטרים
listener ICommandScheduler.IScheduledInvocationListener: הICommandScheduler.IScheduledInvocationListener שצריך לעדכן
device ITestDevice: ITestDevice לשימוש
args String: הארגומנטים של הפקודה
קליעות
ConfigurationException אם הפקודה לא הייתה חוקית

getCommandFileWatcher

public abstract CommandFileWatcher getCommandFileWatcher ()

קבלת אסימוני CommandFileWatcher המתאימים לתזמון הזה

החזרות
CommandFileWatcher

getExecutingCommandCount

public abstract int getExecutingCommandCount ()

הפונקציה מחזירה את מספר הפקודות במצב ביצוע.

החזרות
int

getInvocationInfo

public abstract String getInvocationInfo (int invocationId)

להחזיר את המידע על ממשק ההפעלה שמצוין בו מזהה ההפעלה.

פרמטרים
invocationId int: המזהה לצורכי מעקב של ההפעלה.
החזרות
String String שמכיל מידע על ההפעלה.

getLastInvocationיציאהCode

public abstract CommandRunner.ExitCode getLastInvocationExitCode ()

מחזירה את קוד השגיאה של ההפעלה האחרונה שרצה. פונקציה זו מחזירה 0 (אין שגיאה), אם עדיין לא פעלה הפעלה.

החזרות
CommandRunner.ExitCode

getLastInvocationThrowable

public abstract Throwable getLastInvocationThrowable ()

מחזירה את הערך Throwable מההפעלה האחרונה שרצה. החזרת null, אם לא ניתן להשליך.

החזרות
Throwable

getReadyCommandCount

public abstract int getReadyCommandCount ()

הפונקציה מחזירה את מספר הפקודות במצב Ready בתור.

החזרות
int

השלמת ההעברה

public abstract void handoverInitiationComplete ()

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

כיבוי מסירה

public abstract boolean handoverShutdown (int handoverPort)

הפעלת shutdown() והעברה לתהליך אחר שבוצע עבורו סחר משותף באותו המארח הזה.

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

פרמטרים
handoverPort int

החזרות
boolean true אם התחלת ההעברה בוצעה בהצלחה, false אחרת

הצטרף

public abstract void join ()

בהמתנה להשלמת המתזמן.

למידע נוסף:

הצטרף

public abstract void join (long millis)

בהמתנה להשלמת המתזמן או לסיום הזמן הקצוב לתפוגה אחרי משך הזמן שצוין באלפיות השנייה.

פרמטרים
millis long

למידע נוסף:

removeAllCommands

public abstract void removeAllCommands ()

הסרת כל הפקודות מהמתזמן

setClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

הגדרת הלקוח לדיווח על נתוני רתמות

פרמטרים
client ClearcutClient

צריךכיבוי

public abstract boolean shouldShutdownOnCmdfileError ()

פונקציה זו מחזירה את הערך true אם יש צורך לכבות את המתזמן במקרה של שגיאות פקודה

החזרות
boolean

כיבוי

public abstract void shutdown ()

כדאי לנסות לכבות באלגנטיות את מתזמן הפקודות.

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

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

כיבוי קשיח

public abstract void shutdownHard (boolean killAdb)

ניסיון לכבות בכוח את מתזמן הפקודות.

דומה ל-shutdown(), אבל באופן אופציונלי גם יחדל את חיבור ה-adb, לנסות 'לעורר השראה' מתבצעות הפעלות כדי להשלים אותן מהר יותר.

פרמטרים
killAdb boolean

כיבוי קשיח

public abstract void shutdownHard ()

ניסיון לכבות בכוח את מתזמן הפקודות. זהה ל- offHard(true).

כיבוי ריק

public abstract void shutdownOnEmpty ()

דומה ל-shutdown(), אבל ימתין עד שכל הפקודות יבוצעו לפני היציאה.

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

התחל

public abstract void start ()

מפעילים את ICommandScheduler.

חובה לקרוא לפונקציה לפני קריאה לשיטות אחרות.

יפעל עד קריאה אל shutdown(). פרטים נוספים זמינים בThread.start().

הפסקת ההפעלה

public abstract boolean stopInvocation (int invocationId, 
                String cause)

כדי להפסיק הפעלה רצה, מציינים את המזהה.

פרמטרים
invocationId int: המזהה לצורכי מעקב של ההפעלה.
cause String: הסיבה להפסקת ההפעלה.
החזרות
boolean true אם ההפעלה הופסקה, אחרת false
קליעות
UnsupportedOperationException אם ההטמעה לא תומכת

הפסקת ההפעלה

public boolean stopInvocation (int invocationId)

כדי להפסיק הפעלה רצה, מציינים את המזהה.

פרמטרים
invocationId int

החזרות
boolean true אם ההפעלה הופסקה, אחרת false
קליעות
UnsupportedOperationException אם ההטמעה לא תומכת

הפסקת ההפעלה

public abstract boolean stopInvocation (ITestInvocation invocation)

הפסקת ההפעלה הרצה.

פרמטרים
invocation ITestInvocation

החזרות
boolean true אם ההפעלה הופסקה, אחרת false
קליעות
UnsupportedOperationException אם ההטמעה לא תומכת