‫Journeys for Android Studio

הכלי "תהליכים" ב-Android Studio מאפשר לכם לתאר מסלולי משתמשים מקצה לקצה בשפה טבעית, ולהריץ אותם ישירות באמצעות סוכן ה-AI במכשיר מחובר או באמולטור. קבוצת ההוראות, שנקראת "מסלול", מומרת לפעולות שהסוכן מבצע באפליקציה. בנוסף, אתם יכולים לכתוב ולתאר טענות נכונות (assertions) מורכבות יותר, שהסוכן מעריך על סמך מה שהוא רואה במכשיר.

תהליך שהושלם ב-Android Studio, כשהתהליך פתוח בכלי העריכה, האפליקציה באמולטור ותוצאות הסוכן בחלון הסוכן.
Journeys ל-Android Studio.

הסוכן מסיק אילו פעולות צריך לבצע כדי להשיג את היעדים, ולכן התהליכים עמידים יותר לשינויים קלים בפריסה או בהתנהגות של האפליקציה. כתוצאה מכך, יש פחות בדיקות לא יציבות (flaky tests) כשמריצים את הבדיקות בגרסאות שונות של האפליקציה ובתצורות שונות של המכשיר.

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

כתיבת מסלול

התהליכים נכתבים באמצעות XML כדי לארגן את התיאור והשלבים של התהליך. קובצי המסלול משתמשים בסיומת .journey.xml ומאוחסנים בספרייה src/journeysTest/ של מודול האפליקציה. ב-Android Studio יש כלי עריכה חזותי שמאפשר ליצור ולערוך תהליכים בקלות. אתם לא צריכים לשנות את קובצי ה-build כדי להשתמש בתהליכים.

כדי ליצור מסלול, מבצעים אחת מהפעולות הבאות:

  • בחלונית Project ב-Android Studio, לוחצים לחיצה ימנית על מודול האפליקציה שרוצים לכתוב לו תהליך ובוחרים באפשרות New > Journey File. אפשר גם לבחור באפשרות File > New > Journey File בתפריט הראשי.
  • בחלון Agent, מבקשים מהסוכן ליצור מסלול משתמש באפליקציה. לדוגמה, "צור מסלול שבו המשתמש מחפש מוצר, מוסיף אותו לעגלת הקניות ומוודא שבעגלת הקניות מופיע פריט אחד".

כדי לערוך מסלול, פותחים את קובץ המסלול. אתם יכולים להשתמש בתצוגת Code כדי לערוך את ה-XML ישירות, בתצוגת Design כדי לערוך בצורה פשוטה יותר, או בתצוגת Split כדי לראות את שתי התצוגות. אתם יכולים גם לבקש מהסוכן לעדכן קובץ קיים של מסלול.

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

עורך התהליכים ב-Android Studio, שבו מוצגים השם, התיאור והשלבים של התהליך.
עורך התהליכים ב-Android Studio.

טיפים לכתיבת תהליכים

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

  • הניחו שהאפליקציה כבר פועלת בחזית: הפעלת תהליך מפעילה את האפליקציה באופן אוטומטי. השלבים של התהליך צריכים להתחיל אחרי שהאפליקציה הופעלה באופן מלא. כלומר, לא צריך לכלול את השלב "הפעלת האפליקציה".
  • השתמשו בשפה חד-משמעית: ניסוח מדויק מצמצם את הסיכוי לפרשנות שגויה ומשפר את המהימנות.
במקום מה צריך לעשות
"Select the dismiss button" "Tap 'Dismiss'" או רק "Dismiss"
"הקלד 'סלרי'" "מקלידים "סלרי" בשורת החיפוש שבחלק העליון של מסך הבית"
"החלקה לסגירה" "מחליקים שמאלה כדי לסגור את הכרטיס, ואז הוא לא אמור להופיע יותר"
  • לכלול את הקריטריונים להצלחה כחלק מהשלב: זה עוזר לנציג להבין טוב יותר את הכוונה שלכם, ומבהיר מתי הפעולה הושלמה ואפשר להתחיל את הפעולה הבאה.
במקום מה צריך לעשות
"לוחצים על כפתור השליחה" "שולחים את האימייל בלחיצה על כפתור השליחה. הפעולה הזו אמורה לסגור את האימייל ולהחזיר אתכם לתיבת הדואר הנכנס".
‫"Go to the shopping cart" (מעבר אל עגלת הקניות) "לוחצים על סמל עגלת הקניות כדי לעבור לדף עגלת הקניות. מוודאים שהוא לא מכיל פריטים"
"לוחצים על הסרטון הראשון" "לוחצים על הסרטון הראשון ומחכים שהוא ייטען במלואו"
  • שיפור התהליך: אם התהליך לא פועל כמו שצריך, בודקים את התוצאות כדי להבין למה יכול להיות שהנציג לא ביצע את השלבים כמו שציפיתם. השתמשו במידע הזה כדי להבהיר את ההוראות שלכם.
  • לפרק את התהליך לשלבים ספציפיים יותר: למרות שהסוכן יכול לפרש שלבים עם כמה פעולות, לפעמים שלבים נפרדים ומפורטים יותר יכולים לשפר את הדיוק ואת יכולת השחזור של התהליך.

יכולות נתמכות ומגבלות

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

הפעולות הבאות נתמכות בתהליכים:

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

בשלב הזה אין תמיכה ביכולות הבאות:

  • תנועות עם כמה אצבעות (לדוגמה, תנועת צביטה לשינוי מרחק התצוגה) – אינטראקציות שדורשות שתי נקודות מגע או יותר במסך בו-זמנית, כמו תנועת צביטה לשינוי מרחק התצוגה או החלקה בשתי אצבעות.

היכולות הבאות עלולות לפעול באופן לא עקבי:

  • ספירה – מעקב מדויק אחרי כמויות, תדירויות או התקדמות.

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

הפעלת התהליך

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

מסלול פתוח בכלי העריכה בזמן שהסוכן מריץ אותו בחלון Agent, כשהאפליקציה פועלת באמולטור.
תהליך שפועל בחלון Agent.

כדי להפעיל תהליך, מבצעים אחת מהפעולות הבאות:

  • פותחים את קובץ התהליך ולוחצים על Run (הפעלה) בסרגל הכלים של הכלי לעריכת קוד.
  • בתצוגה Code (קוד) או Split (פיצול), לוחצים על Run (הפעלה) בשוליים לצד התג <journey>.
  • בחלונית Project, לוחצים לחיצה ימנית על קובץ תהליך ובוחרים באפשרות Run Journey with Agent. כדי להריץ כמה מסלולים, בוחרים יותר מקובץ מסלול אחד, או תיקייה שמכילה קובצי מסלולים, ובוחרים באפשרות Run Journeys with Agent.
  • בחלון סוכן, מבקשים מהסוכן להפעיל תהליך.

‫Android Studio מתחיל שיחה חדשה בחלון Agent באמצעות הנציג האחרון שבחרתם, כולל נציגים אחרים שחיברתם ב-Settings > Tools > AI > Agents.

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

הרצת מסלול משורת הפקודה

כדי להריץ את Journeys משורת הפקודה עם כל סוכן, משתמשים ב-Android CLI.

הצגת התוצאות

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

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

הרצת תהליכים כחבילות מקרים לבדיקה של AGP

בגרסה Android Studio Rabbit 2 ובגרסאות קודמות, התכונה "מסלולים" זמינה כחלק מ-Studio Labs, ומריצה מסלולים כחבילות מקרים לבדיקה של הפלאגין של Android Gradle‏ (AGP). כדי להשתמש בו:

  1. עוברים אל Studio Labs בתפריט ההגדרות ומפעילים את Journeys.
  2. מוודאים שבפרויקט מותקן AGP בגרסה 9.0.0 ואילך.
  3. בחלונית Project, לוחצים לחיצה ימנית על מודול האפליקציה ובוחרים באפשרות New > Journey Test. אם זו הפעם הראשונה שאתם מוסיפים תהליכים לפרויקט, Android Studio מוסיף לפרויקט גם תמיכה בחבילת המקרים לבדיקה של AGP.
  4. פותחים את קובץ התהליך, ובתצוגת עיצוב לוחצים על הפעלת התהליך. ‫Android Studio יוצר הגדרת הרצה של Journeys Test, מריץ אותה במכשיר שנבחר ומציג את התוצאות בחלונית תוצאות הבדיקה.

חבילת המקרים לבדיקה פועלת על וריאנט ה-build שהיה פעיל כשיצרתם את התהליך. אם אתם עוברים לווריאנט build אחר, הוסיפו אותו למאפיין targetVariants בבלוק testSuites של הקובץ build.gradle.kts ברמת המודול.