טקסט קלט של Android

הקלדת טקסט ברכיב בממשק המשתמש שתואם לסלקטור.

שימוש

android input text [-h] [--match=PARAM] [--submit] [--wait=PARAM] <string> <selector>

אפשרויות

  • ‫-h,--help – הצגת הודעת העזרה של הפקודה שצוינה.
  • --match=PARAM – ההתנהגות כשיש כמה רכיבים תואמים: "יחיד" (שגיאה כשיש כמה התאמות) או "ראשון".
  • --submit – אחרי שמזינים טקסט, לוחצים על מקש Enter או על מקש האישור.
  • --wait=PARAM – משך הזמן המקסימלי להמתנה עד שרכיב היעד יופיע בפריסה (באלפיות השנייה).

אפשרויות של input:

  • ‫--device=PARAM – המספר הסידורי של המכשיר או מזהה האמולטור (כפי שדווח על ידי "adb devices").

אפשרויות של android:

  • ‫--sdk=PARAM – הנתיב ל-Android SDK.
  • ‫-v,--verbose – הפעלת פלט מפורט לפתרון בעיות.
  • ‫-V,--version – הדפסת פרטי הגרסה ויציאה.

ארגומנטים תלויי מיקום

  • ‫<string> – מחרוזת טקסט שצריך להקליד ברכיב היעד (מחליפה את הטקסט הקיים).
  • ‫<selector> – בורר רכיבי קלט של יעדים, שמופרדים בפסיקים ומוגדרים כצמדים של מפתח=ערך

מטרגטים רכיבים בממשק המשתמש באמצעות סלקטורים שמורכבים מצמדי מפתח=ערך מופרדים בפסיקים, שתואמים למאפייני צומת הנגישות. אפשר גם לכתוב key:value. לדוגמה, text=search,clz=EditText,clickable=true מטרגט רכיבי EditText שניתן ללחוץ עליהם ומכילים את הטקסט "search"

שדות מחרוזת נתמכים: - text (או txt) לטקסט גלוי - id (או res) למזהה משאב של תצוגה - class (או clazz, ‏ cls, ‏ clz) לשם מחלקה של רכיב - desc (או content) לתיאור תוכן של נגישות

שדות בוליאניים נתמכים (true או false): - clickable (או click) - scrollable (או scroll) - checkable - focusable - longclickable (או longclick) - checked - focused - selected

חשוב לזכור שכברירת מחדל, בוררי מחרוזות תואמים למחרוזות משנה ללא תלות באותיות רישיות. הבורר txt=var יתאים ל-"var", ל-"Variable" ול-"There was significant variance". הסלקטור txt=* ‎ תואם לכל ערך שאינו ריק. המערכת מתעלמת מרווחים מסביב לערך, אלא אם הם נמצאים בתוך ביטוי רגולרי. כדי להשתמש בביטוי רגולרי, צריך להקיף את הערך בלוכסנים. ביטויים רגולריים הם תלויי אותיות רישיות ויכולים להתאים לכל חלק של הערך. לדוגמה, הביטוי txt=/^Var$/ תואם רק ל-"Var". מוסיפים את הדגל i להתאמה לא תלוית-רישיות, לדוגמה txt=/^var$/i. כדי להוסיף תו בריחה ללוכסן (/) בביטוי רגולרי, צריך להשתמש בלוכסן הפוך (\/), לדוגמה id=/:id\/submit$/. פסיקים ורווחים בתוך ביטוי רגולרי הם חלק ממנו, לדוגמה txt=/^Item [0-9]{1,2}$/. ערך שמתחיל ב-"/" הוא תמיד ביטוי רגולרי, לכן צריך להשתמש ב-txt=/^\/help/ כדי להתאים טקסט שמתחיל ב-"/help"