MonkeyRunner

מחלקת monkeyrunner שמכילה שיטות סטטיות של כלי עזר.

סיכום

שיטות
void alert (string message, string title, string okTitle)
הפונקציה מציגה תיבת דו-שיח של התראה לתהליך שמריץ את התוכנית הנוכחית.
integer choice (string message, iterable choices, string title)
מוצגת תיבת דו-שיח עם רשימת אפשרויות לתהליך שבו פועלת התוכנית הנוכחית.
void help (פורמט מחרוזת)
הפלט יציג את הפניה ל-monkeyrunner API בסגנון דומה לזה של הכלי pydoc של Python, בפורמט שצוין.
string input (string message, string initialValue, string title, string okTitle, string cancelTitle)
הצגת תיבת דו-שיח לקבלת קלט.
void sleep (float seconds)
משהה את התוכנית הנוכחית למספר השניות שצוין.
MonkeyDevice waitForConnection (float timeout, string deviceId)
מנסה ליצור חיבור בין הקצה העורפי monkeyrunner לבין המכשיר או האמולטור שצוינו.

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

string alert ( string message, string title, string okTitle)

הפונקציה מציגה תיבת דו-שיח של התראה לתהליך שבו פועלת התוכנית הנוכחית. תיבת הדו-שיח היא מודלית, ולכן התוכנית מושהית עד שהמשתמש לוחץ על הלחצן בתיבת הדו-שיח.

ארגומנטים
הודעה ההודעה שתוצג בתיבת הדו-שיח.
title הכותרת של תיבת הדו-שיח. ערך ברירת המחדל הוא Alert.
okTitle הטקסט שמוצג בלחצן של תיבת הדו-שיח. ערך ברירת המחדל הוא OK.

integer choice (string message, iterable choices, string title)

מוצגת תיבת דו-שיח עם רשימת אפשרויות לתהליך שבו פועלת התוכנית הנוכחית. תיבת הדו-שיח היא מודלית, ולכן התוכנית מושהית עד שהמשתמש לוחץ על אחד מהלחצנים בתיבת הדו-שיח.

ארגומנטים
הודעה ההודעה שמוצגת בתיבת הדו-שיח.
אפשרויות אובייקט ניתן לחזרה (iterable) ב-Python שמכיל אובייקט אחד או יותר שמוצגים כמחרוזות. הפורמט המומלץ הוא מערך של מחרוזות.
title הכותרת של תיבת הדו-שיח. ברירת המחדל היא 'קלט'.
החזרות
  • אם המשתמש בוחר אפשרות ולוחץ על הלחצן 'אישור', הפונקציה מחזירה את האינדקס מבוסס-האפס של הבחירה בתוך האובייקט שניתן לאיטרציה. אם המשתמש לוחץ על הלחצן 'ביטול', השיטה מחזירה את הערך ‎-1.

void help (string format)

הפלט מציג את הפניה ל-monkeyrunner API בסגנון דומה לזה של הכלי pydoc של Python, בפורמט שצוין.

ארגומנטים
פורמט פורמט התיוג שבו רוצים להשתמש בפלט. הערכים האפשריים הם 'text' לטקסט רגיל או 'html' ל-HTML.

string input (string message string initialValue, string title, string okTitle, string cancelTitle)

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

תיבת הדו-שיח מכילה שני לחצנים, שאחד מהם מציג את הערך okTitle והשני את הערך cancelTitle. אם המשתמש לוחץ על הלחצן okTitle, הערך הנוכחי של תיבת הקלט מוחזר. אם המשתמש לוחץ על הלחצן cancelTitle, מוחזרת מחרוזת ריקה.

ארגומנטים
הודעה ההודעה שמוצגת בתיבת הדו-שיח.
initialValue הערך הראשוני שיוצג בתיבת הדו-שיח. ברירת המחדל היא מחרוזת ריקה.
title הכותרת של תיבת הדו-שיח. ברירת המחדל היא 'קלט'.
okTitle הטקסט שמוצג בכפתור okTitle. ברירת המחדל היא "OK".
cancelTitle הטקסט שמוצג בלחצן cancelTitle. ברירת המחדל היא 'ביטול'.
החזרות
  • אם המשתמש לוחץ על הלחצן okTitle, השיטה מחזירה את הערך הנוכחי של תיבת הקלט של תיבת הדו-שיח. אם המשתמש לוחץ על הלחצן cancelTitle, השיטה מחזירה מחרוזת ריקה.

void sleep ( float seconds )

משהה את התוכנית הנוכחית למספר השניות שצוין.

ארגומנטים
שניות מספר השניות להשהיה.

MonkeyDevice waitForConnection (float timeout, string deviceId)

מנסה ליצור חיבור בין הקצה העורפי monkeyrunner לבין המכשיר או האמולטור שצוינו.

ארגומנטים
פסק זמן מספר השניות להמתנה לחיבור. ברירת המחדל היא להמתין ללא הגבלת זמן.
deviceId ביטוי רגולרי שמציין את המספר הסידורי של המכשיר או האמולטור. בנושא Android Debug Bridge מוסבר על המספרים הסידוריים של המכשירים והאמולטורים.
החזרות
  • מופע אחד (MonkeyDevice) של המכשיר או האמולטור. אפשר להשתמש באובייקט הזה כדי לשלוט במכשיר או באמולטור ולתקשר איתם.