קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
יצירת מסלולים ב-Android Studio עוזרת לכתוב ולתחזק בקלות בדיקות מקצה לקצה. אפשר להשתמש בשפה טבעית כדי לתאר את השלבים והטענות לכל בדיקה – שנקראת מסלול. השלבים שכתובים בשפה טבעית מומרים לפעולות ש-Gemini מבצע באפליקציה, באמצעות יכולות הראייה וההסקה של Gemini. כך קל לכתוב את התהליכים ולהבין אותם. בנוסף, אתם יכולים לכתוב ולתאר טענות מורכבות יותר, ש-Gemini מעריך על סמך מה שהוא רואה במכשיר כדי לקבוע אם מסלולי ההמרות עברו או נכשלו.
בנוסף, Gemini מנתח אילו פעולות צריך לבצע כדי להשיג את היעדים, ולכן התהליכים עמידים יותר לשינויים קלים בפריסה או בהתנהגות של האפליקציה. כתוצאה מכך, יש פחות בדיקות לא יציבות כשמריצים אותן מול גרסאות שונות של האפליקציה והגדרות שונות של המכשיר.
לכתוב ולהריץ מסלולי המרה ישירות מ-Android Studio בכל מכשיר Android מקומי או מרוחק. סביבת הפיתוח המשולבת מספקת חוויית עריכה חדשה ליצירת מסלולי המרה, וגם תוצאות עשירות שעוזרות לכם להבין טוב יותר את ההיגיון של Gemini ואת הביצוע של מסלול ההמרה.
כתיבת מסלול
Android Studio מספק תבנית קובץ וחוויית עריכה חדשה שמקלים על יצירה ועריכה של מסלולי המרה. התהליכים נכתבים באמצעות תחביר XML כדי לארגן את תיאור התהליך והשלבים שלו.
כדי ליצור מסלול המרה ולהתחיל לערוך אותו:
בחלונית Project ב-Android Studio, לוחצים לחיצה ימנית על מודול האפליקציה שרוצים לכתוב לו מסלול.
בוחרים באפשרות New > Test > Journey File (חדש > בדיקה > קובץ נתוני מסלול).
בתיבת הדו-שיח שמופיעה, מזינים את השם והתיאור של מסלול ההמרה.
לוחצים על אישור. Android Studio יוצר קובץ XML לתוכנית הלימודים עם השם שבחרתם. אתם יכולים להשתמש בתצוגת קוד כדי לערוך את ה-XML ישירות, או בתצוגת עיצוב כדי לשפר את חוויית העריכה.
כשצופים במסלול הלקוח בתצוגה עיצוב, משתמשים בשדה הטקסט כדי לתאר כל שלב במסלול הלקוח. כל שלב יכול לכלול פעולות תיאוריות שרוצים ש-Gemini יבצע או טענות שרוצים ש-Gemini יעריך.
מקישים על Enter במקלדת כדי להתחיל הנחיה חדשה באותו תהליך. אפשר לחזור על הפעולה הזו לפי הצורך לכל שלב במסלול שרוצים להגדיר.
טיפים לכתיבת מסלולי המרה
אם תכתבו את המסלולים בצורה מפורטת ומאורגנת, סביר יותר ש-Gemini יבצע את המסלולים שרציתם בצורה מדויקת יותר וצפויה יותר. ריכזנו כאן כמה טיפים שיעזרו לכם לכתוב מסלולי המרה יעילים יותר:
הפרדה בין טענות לפעולות: Gemini בודק כל הזמן את מצב האפליקציה כדי לקבוע אם היא במצב 'נכון' להמשך התהליך.
עם זאת, יכול להיות שתצטרכו להגדיר טענות מורכבות יותר כשלב נפרד.
בנוסף, כדי ש-Gemini ידע שהשלב הזה נועד להיות טענה, כדאי להתחיל כל הנחיה באמצעות ביטויי מפתח כמו 'ודא ש', 'אני רוצה שתאשר ש' או 'בדוק ש'.
הנחיית Gemini באמצעות החלקה: בנוסף לאינטראקציות בסיסיות, כמו הקשה או הזנת נתונים באמצעות המקלדת, Gemini תומך בפעולות שדורשות החלקה במסך בכיוונים מסוימים. לדוגמה, כדי לגלול בתוכן או לסגור רכיב בממשק המשתמש, פשוט מתארים את הכיוון ואת הכוונה של פעולת ההחלקה. כברירת מחדל, Gemini מחליק ממרכז המסך, אבל אתם יכולים להנחות אותו להחליק בחלק אחר של מסך המכשיר.
הימנעות מאינטראקציות מורכבות ומשינויים בהגדרות: נכון לעכשיו, Gemini לא תומך בכל האינטראקציות והשינויים בהגדרות, כמו מחוות עם כמה אצבעות, סיבוב המסך או פעולות קיפול. הצוות פועל לשיפור היכולות של Gemini.
הפעלת המסע
אפשר להריץ את המסלול בכל מכשיר מקומי או מרוחק שזמין, בדומה לכל בדיקה אחרת עם מכשור, ו-Android Studio יוצר תוצאות חיפוש מתקדמות שעוזרות להבין את הביצוע של המסלול.
כדי לבדוק מסלול המרה:
בוחרים מכשיר יעד מסרגל הכלים הראשי, כמו כשמריצים בדיקה עם מכשור.
עוברים לקובץ ה-XML של מסלול ההמרה שרוצים לבדוק ופותחים אותו בכלי העריכה.
בעורך, מבצעים אחת מהפעולות הבאות:
אם אתם בתצוגה עיצוב, לוחצים על ואז על הפעלת מסלול.
אם אתם בתצוגת Code (קוד), לוחצים על Run (הפעלה) במרווח לצד המקום שבו מוגדר שם המסלול ב-XML.
Android Studio יוצר בשבילכם הגדרה של Journeys Test ומריץ אותה במכשיר היעד. במהלך ההרצה, Android Studio יוצר את האפליקציה ופורס אותה, ומתחבר ל-Gemini כדי לקבוע אילו פעולות לבצע בכל שלב בתהליך.
במהלך הפעלת תהליך, מוצגות גם תוצאות מוגבלות בעורך, כמו צילומי המסך, הפעולה שבוצעה וההסבר במהלך הביצוע של כל שלב בתהליך. פשוט מעבירים את העכבר מעל התמונה הממוזערת בכלי העריכה כדי לראות מידע נוסף. האפשרות הזו יכולה להיות שימושית כשמבצעים איטרציות על ההנחיות בתהליך.
הצגת התוצאות
כש-Android Studio מסיים לבדוק את המסלול, חלונית תוצאות הבדיקה מופיעה אוטומטית כדי להציג את התוצאות.
בהשוואה לבדיקות אחרות עם מכשור שאולי תריצו ב-Android Studio, יש כמה הבדלים באופן שבו מוצגות התוצאות של מסלולי המשתמשים.
בחלונית בדיקות מפורטים השלבים הנפרדים בתהליך. אפשר ללחוץ על כל שלב כדי לקבל מידע נוסף על האופן שבו Gemini ביצע אותו.
בחלונית תוצאות מוצג מידע מפורט שיעזור לכם להבין איך Gemini הבין את התהליך שלכם, איך הוא נימק אותו ואיך הוא ביצע אותו.
צילומי המסך שנשלחו ל-Gemini מוצגים כעזר ויזואלי בכל פעולה בשלב.
לצד כל צילום מסך מופיע תיאור של הפעולה שבוצעה וההסבר של Gemini למה הפעולה הזו בוצעה.
כל פעולה בשלב ממוספרת.
בעיות מוכרות
כשבודקים מסלול המרה, כל ההרשאות לאפליקציה ניתנות כברירת מחדל.
כשבודקים מסלול המרה במכשיר עם Android 15 (רמת API 35), יכול להיות שתופיע במכשיר אזהרה עם הכיתוב 'האפליקציה לא בטוחה ונחסמה' לגבי 'AndroidX
Crawler'. כדי לעקוף את הבדיקה הזו, אפשר ללחוץ על התקנה בכל זאת.
לחלופין, אפשר להגדיר אפשרויות למפתחים במכשיר ולהשבית את האפשרות אימות אפליקציות שהותקנו מ-USB.
בשלב הזה, קבצים של מסלולים לא מופיעים בתצוגת Android בחלונית פרויקטים. כדי לראות את קובצי הנסיעות בפרויקט, משתמשים בתצוגה Project.
אם כמה פעולות במסלול משתמש חולקות את אותה הנחיה בדיוק, יכול להיות שתוצאות הבדיקה שמוצגות בכלי לעריכת מסלולי משתמש יהיו שגויות. כלומר, כל הפעולות עם ההנחיה המשוכפלת יציגו את תוצאות הבדיקה שמשויכות למופע המעודכן ביותר של ההנחיה הזו. כדי לעקוף את הבעיה, צריך לוודא שלכל פעולה יש הנחיה ייחודית – למשל, על ידי הוספה של תחילית או סיומת ייחודיות.
בפעם השנייה שהמקלדת נטענת באמולטור חדש, מופיע חלון קופץ של עט סטיילוס. בדרך כלל החלון הקופץ הזה גורם לכשל בבדיקות שכוללות אינטראקציה עם שדות טקסט. במקרה כזה, צריך לסגור את החלון הקופץ ולהפעיל מחדש את מסלול ההמרה.
מדי פעם, יכול להיות שיופיעו ארטיפקטים של סורק האפליקציות בהסבר של הסוכן.
לפעמים יש שגיאה בהפעלת תהליך עם קוד השגיאה IllegalStateException. במקרה כזה, אפשר ללחוץ על תוצאות הבדיקה כדי לראות את השגיאה המלאה.
אם Android Gradle Plugin (com.android.application) לא מוגדר בקובץ com.android.application ברמה העליונה, יכול להיות שתופיע השגיאה הבאה כשמריצים מסלול המרה:build.gradle
Failed to apply plugin class 'com.android.tools.journeys.JourneysGradlePlugin'
כדי לפתור את הבעיה, צריך לוודא שהתוסף מוגדר בקובץ build.gradle ברמה העליונה. מידע נוסף זמין במאמר בנושא הגדרת מערכת ה-build של Android.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-09 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-08-09 (שעון UTC)."],[],[],null,["# Journeys for Android Studio\n\n| **Preview:** Journeys for Android Studio are available starting from Android Studio Narwhal Feature Drop \\| 2025.1.3.\n\nCreating journeys for Android Studio helps make end-to-end tests easy to write\nand maintain by letting you use natural language to describe the steps and\nassertions for each test---called a journey. By leveraging Gemini's vision and\nreasoning capabilities, steps written in natural language are converted into\nactions that Gemini performs on your app, making it both easy to write and\nunderstand your journeys. Additionally, you can write and describe more complex\nassertions, which Gemini evaluates based on what it sees on the device in order\nto determine whether your journeys pass or fail. \n\nAnd because Gemini reasons about which actions to perform to satisfy the goals,\njourneys are more resilient to subtle changes to your app's layout or behavior,\nresulting in fewer flaky tests when running against different versions of your\napp and different device configurations.\n\nWrite and run journeys right from Android Studio against any local or remote\nAndroid device. The IDE provides a new editor experience for crafting journeys\nas well as rich results that help you better follow Gemini's reasoning and\nexecution of your journey.\n| **Note:** Before you get started, download the latest [Canary version of Android\n| Studio](/studio/preview). You'll also need to make sure that you're signed into your developer account and have enabled Gemini in Android Studio.\n\nWrite a journey\n---------------\n\nAndroid Studio provides a file template and new editor experience that makes\ncreating and editing journeys easy. Journeys are written using the XML syntax to\norganize your journey description and steps.\n\nTo create and start editing a journey, do the following:\n\n1. From the **Project** panel in Android Studio, right-click on the app module for which you want to write a journey.\n2. Select **New \\\u003e Test \\\u003e Journey File**.\n3. In the dialog that appears, provide the name and description of your journey.\n4. Click **OK** . Android Studio creates an XML file for your journey with the name you chose. You can use either the **Code** view to edit the XML directly, or the **Design** view for an improved editing experience.\n5. When viewing your journey in the **Design** view, use the text field to describe each step of your journey. Each step can include descriptive actions you want Gemini to perform or assertions that you want Gemini to evaluate.\n6. Press \u003ckbd\u003eEnter\u003c/kbd\u003e on your keyboard to start a new prompt in the same journey. You can repeat this as needed for each step of the journey you want to define.\n\n### Tips for writing journeys\n\nWriting your journeys in a detailed and organized way can increase the\nlikelihood of Gemini accurately running your intended journeys in a more\ndeterministic way. Here are some tips to help you write your journeys more\neffectively:\n\n- **Separate assertions from actions:** Gemini constantly evaluates the state of your app to determine if it's in a \"correct\" state to continue the journey. However, you might need to define more complex assertions as a separate step. Additionally, start each prompt using key phrases such as \"Verify that,\" \"Assert that,\" or \"Check that\" to let Gemini know that this step is meant to be an assertion.\n- **Direct Gemini with swipes:** In addition to basic interactions, such as tapping or keyboard inputs, Gemini supports actions that require it to swipe the screen in certain directions. For example, to scroll through content or dismiss some UI simply describe the direction and intent of your swipe action. By default, Gemini swipes from the center of the screen, but you can guide it to swipe on a different part of the device screen.\n- **Avoid complex interactions and configuration changes:** Gemini currently does not support all interactions and configuration changes, such as multi-finger gestures, screen rotations, or folding actions. The team is working to improve Gemini capabilities.\n\nRun your journey\n----------------\n\nYou can run your journey on any available local or remote device, similar to any\nother instrumented test, and Android Studio generates rich results that help you\nunderstand the execution of your journey.\n\nTo test a journey, do the following:\n\n1. Select a target device from the main toolbar, like you would when running an instrumented test.\n2. Navigate to the journey XML file that you would like to test and open it in the editor.\n3. In the editor, do one of the following:\n 1. If you're in the **Design** view, click **Run Journey**.\n 2. If you're in the **Code** view, click **Run** in the gutter next to where the name of the journey is defined in the XML.\n\nAndroid Studio creates a **Journeys Test** configuration for you and runs it on\nthe target device. During execution, Android Studio builds and deploys your app,\nand connects to Gemini to determine which actions to take for each step of your\njourney.\n\nLimited results are also shown in the editor while running a journey, such as\nthe screenshots, action taken, and reasoning during the execution of each step\nin your journey. Simply hover over the thumbnail in the editor to see more\ninformation. This can be helpful when iterating on the prompts in your journey.\n\nView results\n------------\n\nWhen Android Studio completes testing your journey, the test results panel\nappears automatically to show you the results.\n\nCompared to other instrumented tests you might run in Android Studio, there are\nsome differences in how results for journeys are displayed.\n\n- The **Tests** panel breaks down the journey into the discrete steps. You can click on each step to find out more information about how Gemini executed it.\n- The **Results** panel shows rich information to help you understand how Gemini understood and reasoned about your journey, and how it was executed.\n- The screenshots that were sent to Gemini are shown for visual aid at each action in the step.\n- Each action taken and Gemini's reasoning for why it took that action is described next to each screenshot.\n- Each action in the step is numbered.\n\nKnown issues\n------------\n\n- When testing a journey, all permissions for your app are granted by default.\n- When testing a journey on a device running Android 15 (API level 35), you might see a warning on the device that says \"Unsafe App Blocked\" for \"AndroidX Crawler\". You can click **Install anyway** to bypass this check. Alternatively, you can [Configure on-device developer options](/studio/debug/dev-options) and disable the option to **Verify apps over USB**.\n- Journey files do not currently appear in the **Android** view in the **Projects** panel. To see journey files in your project, use the **Project** view.\n- If multiple actions within a journey share the exact same prompt, the test results displayed in the journey editor may be incorrect. Specifically, all actions with the duplicate prompt will show the test results associated with the most recently updated instance of that prompt. To work around this, ensure each action has a unique prompt---for example, by adding a distinct prefix or suffix.\n- A stylus popup appears the second time the keyboard is loaded on a fresh emulator. This popup usually causes tests that interact with text fields to fail. When this occurs, dismiss the popup and rerun the journey.\n- App crawler artifacts might occasionally appear in agent rationale.\n- Journey execution occasionally fails with an `IllegalStateException`. When this happens, you can click on **Test Results** to see the full error.\n- If the Android Gradle Plugin (`com.android.application`) isn't defined in the\n top-level `build.gradle` file, you may see the following error when running a\n journey:\n\n Failed to apply plugin class 'com.android.tools.journeys.JourneysGradlePlugin'\n\n To resolve this, ensure that the plugin is defined in the top-level\n `build.gradle` file. See [Configure the Android build system](/build#top-level)\n for more information."]]
ואז על הפעלת מסלול.
Run 