דף זה תורגם על ידי Cloud Translation API.

סוכן של App Testing (ל-Android)

הסוכן App Testing הוא סוכן ליצירה, לניהול ולביצוע של תרחישי בדיקה שמבוסס על Gemini ב-Firebase. אתם מגדירים מטרות בדיקה בשפה טבעית, והסוכן משתמש ב-AI כדי להבין את האפליקציה ולנווט בה, לדמות אינטראקציות של משתמשים ולספק תוצאות בדיקה מפורטות.

איך סוכן בדיקת האפליקציות משתמש בנתונים שלכם

סוכן בדיקת האפליקציות מסופק על ידי Gemini ב-Firebase והוא כפוף לאותם תנאים. במאמר איך Gemini ב-Firebase משתמש בנתונים שלכם מוסבר איך Gemini ב-Firebase משתמש בנתונים שלכם.

לפני שמתחילים

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

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

כשמוכנים להפיץ גרסה טרום-השקה של האפליקציה לבודקים, צריך ליצור את ה-APK או ה-AAB בתהליך הרגיל ולהעלות אותו ל-App Distribution במסוף Firebase. חובה לחתום על ה-APK באמצעות מפתח ניפוי הבאגים או מפתח חתימת האפליקציה.

יצירת תרחיש בדיקה

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

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

כדי ליצור תרחיש בדיקה, פותחים את הדף App Distribution של Firebase המסוף ומבצעים את השלבים הבאים:

בכרטיסייה תרחישי בדיקה, לוחצים על תרחיש בדיקה חדש. אם אתם לא רוצים ליצור תרחיש בדיקה משלכם, אתם יכולים לשנות את תרחיש הבדיקה לדוגמה שסיפקנו או להשתמש בו.
בתיבת הדו-שיח Add test case (הוספת תרחיש בדיקה), נותנים שם לתרחיש הבדיקה. הפרמטר הזה משמש לזיהוי הבדיקה, אבל הסוכן מתעלם ממנו.
כדאי לחלק את הבדיקה לכמה שלבים. לשם כך, לוחצים על הלחצן הוספת שלב נוסף.
נותנים לכל שלב מטרה שמתארת מה סוכן בדיקת האפליקציות צריך לעשות במהלך השלב הזה.
(אופציונלי) מוסיפים רמז כדי לספק מידע נוסף שיעזור לסוכן לבדיקת האפליקציה להבין את האפליקציה ולנווט בה במהלך השלב הזה.
(אופציונלי) מוסיפים קריטריונים להצלחה כדי לעזור לסוכן לבדיקת האפליקציות לקבוע מתי השלב הושלם בהצלחה.
כשמסיימים להתאים אישית את הבדיקה, לוחצים על שמירה.

מקרה בדיקה לדוגמה

הדוגמה הבאה מראה איך ליצור תרחיש בדיקה באמצעות סוכן App Testing:

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

הרצת בדיקה

הסוכן App Testing מאפשר להריץ בדיקות מבוססות-AI במסוף. כדי לעשות זאת, לוחצים על הלחצן הפעלת בדיקות בדף 'גרסאות' או בדף 'תרחישי בדיקה'. ייפתח מסך ההתאמה האישית של סוכן בדיקת האפליקציות, שבו תוכלו לבחור תרחיש בדיקה אחד או יותר מתוך תרחישי הבדיקה הקיימים שלכם שהסוכן יבצע. אפשר גם לבחור את המכשירים שרוצים לבדוק ביחס אליהם, ואם לספק פרטי כניסה.

אפשר גם לשנות את סוג הבדיקה כדי להריץ בדיקת סריקה אקראית. בדיקות סריקה אקראיות מתבצעות באמצעות התכונה Automated Tester.

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

בדיקה אוטומטית של גרסאות ה-build

כדי להריץ באופן אוטומטי בדיקות של סוכן App Testing בגרסאות build חדשות, למשל מצינורות עיבוד נתונים של CI/CD, אפשר להפיץ את הגרסאות לסוכן באמצעות התוספים של Gradle או fastlane של App Distribution, או באמצעות Firebase CLI.

בדיקה אוטומטית של גרסאות build באמצעות Firebase CLI

כדי להשתמש בתכונה App Testing agent, צריך לציין לפחות מכשיר בדיקה אחד ומזהה של תרחיש בדיקה אחד. אפשר למצוא ולהוריד את מזהי תרחישי הבדיקה בדף Test Cases (תרחישי בדיקה) בFirebaseמסוף. מידע נוסף על תחילת העבודה עם Firebase CLI ועל דרכים שונות להגדרת ההפצה זמין במאמר הפצת אפליקציות ל-Android לבודקים באמצעות Firebase CLI.

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

appdistribution:distribute options
`--test-devices` או `--test-devices-file`	מכשירי הבדיקה שרוצים להפיץ אליהם את ה-builds של התכונה App Testing agent. אפשר לציין את המכשירים לבדיקה כרשימה של מכשירים לבדיקה שמופרדים באמצעות נקודה-ופסיק: `--test-devices: "model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"` לחלופין, אפשר לציין את הנתיב לקובץ טקסט פשוט שמכיל רשימה של מכשירי בדיקה שמופרדים באמצעות נקודה-פסיק: `--test-devices-file: "/path/to/test-devices.txt"`
`--test-username`	שם המשתמש לכניסה אוטומטית שייעשה בו שימוש במהלך הבדיקות.
`--test-password` או `--test-password-file`	הסיסמה לכניסה אוטומטית שבה יש להשתמש במהלך הבדיקות. אפשר גם לציין את הנתיב לקובץ טקסט פשוט שמכיל סיסמה: `--test-password-file: "/path/to/test-password.txt"`
`--test-non-blocking`	הרצת בדיקות באופן אסינכרוני. תוצאות הבדיקה האוטומטית זמינות במסוף Firebase.
`--test-case-ids` או `--test-case-ids-file`	רשימה מופרדת בפסיקים של מזהי תרחישי בדיקה להרצת בדיקות אוטומטיות מבוססות-AI: `--test-case-ids: "load-app,play-the-first-level"` אפשר גם לציין את הנתיב לקובץ טקסט פשוט שמכיל רשימה של מזהי תרחישי בדיקה שמופרדים בפסיקים או במעברי שורה: `--test-case-ids-file: "/path/to/test-case-ids.txt"`

בדיקה אוטומטית של גרסאות build באמצעות Gradle

כדי להשתמש בתכונה App Testing agent, צריך לציין לפחות מכשיר בדיקה אחד ומזהה של תרחיש בדיקה אחד. אפשר למצוא ולהוריד את מזהי תרחישי הבדיקה בדף Test Cases (תרחישי בדיקה) בFirebaseמסוף. מידע נוסף על תחילת העבודה עם Gradle ועל דרכים שונות להגדרת ההפצה זמין במאמר הפצת אפליקציות ל-Android לבודקים באמצעות Gradle.

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

App Distribution פרמטרים של Build
`testDevices` או `testDevicesFile`	מכשירי הבדיקה שרוצים להפיץ אליהם את ה-builds של התכונה App Testing agent. אפשר לציין את מכשירי הבדיקה כרשימה של מפרטי מכשירים שמופרדים באמצעות נקודה-ופסיק. `testDevices="model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"` אפשר גם לציין את הנתיב לקובץ שמכיל רשימה של מפרטי מכשירים שמופרדים בנקודה-ופסיק: `testDevicesFile="/path/to/testDevices.txt"`
`testUsername`	שם המשתמש לכניסה אוטומטית שייעשה בו שימוש במהלך הבדיקות.
`testPassword` או `testPasswordFile`	הסיסמה לכניסה אוטומטית שבה יש להשתמש במהלך הבדיקות. אפשר גם לציין את הנתיב לקובץ טקסט פשוט שמכיל סיסמה: testPasswordFile="/path/to/testPassword.txt"
`testNonBlocking`	הרצת בדיקות באופן אסינכרוני. תוצאות הבדיקה האוטומטית זמינות במסוף Firebase.
`testCases`או `testCasesFile`	רשימה מופרדת בפסיקים של מזהי תרחישי בדיקה להרצת בדיקות אוטומטיות מבוססות-AI: `testCases: "load-app,play-the-first-level"` אפשר גם לציין את הנתיב לקובץ טקסט פשוט שמכיל רשימה של מזהי תרחישי בדיקה שמופרדים בפסיקים או במעברי שורה: `testCasesFile: "/path/to/test-case-ids.txt"`

בדיקה אוטומטית של גרסאות build באמצעות fastlane

כדי להשתמש בתכונה App Testing agent, צריך לציין לפחות מכשיר בדיקה אחד ומזהה של תרחיש בדיקה אחד. אפשר למצוא ולהוריד את מזהי תרחישי הבדיקה בדף Test Cases (תרחישי בדיקה) בFirebaseמסוף. מידע נוסף על תחילת העבודה עם fastlane ועל דרכים שונות להגדרת ההפצה זמין במאמר הפצת אפליקציות ל-Android לבודקים באמצעות fastlane.

ב./fastlane/Fastfile נתיב, מוסיפים בלוק firebase_app_distribution. כדי להגדיר את ההפצה לתכונה של סוכן בדיקת האפליקציות, משתמשים בפרמטרים הבאים:

פרמטרים של הפצת אפליקציות ב-Firebase
`test_devices` או `test_devices_file`	מכשירי הבדיקה שרוצים להפיץ אליהם את ה-builds של התכונה App Testing agent. אפשר לציין את המכשירים לבדיקה כרשימה של מכשירים לבדיקה שמופרדים באמצעות נקודה-ופסיק: `test_devices: "model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"` לחלופין, אפשר לציין את הנתיב לקובץ טקסט פשוט שמכיל רשימה של מכשירי בדיקה שמופרדים באמצעות נקודה-פסיק: `test_devices_file: "/path/to/test-devices.txt"`
`test_username`	שם המשתמש לכניסה אוטומטית שייעשה בו שימוש במהלך הבדיקות.
`test_password` או `test_password_file`	הסיסמה לכניסה אוטומטית שבה יש להשתמש במהלך הבדיקות. אפשר גם לציין את הנתיב לקובץ טקסט פשוט שמכיל סיסמה: `test_password_file: "/path/to/test-password.txt"`
`test_non_blocking`	הרצת בדיקות באופן אסינכרוני. תוצאות הבדיקה האוטומטית זמינות במסוף Firebase.
`--test_case_ids` או `--test_case_ids_file`	רשימה מופרדת בפסיקים של מזהי תרחישי בדיקה להרצת בדיקות אוטומטיות מבוססות-AI: `--test_case_ids: "load-app,play-the-first-level"` אפשר גם לציין את הנתיב לקובץ טקסט פשוט שמכיל רשימה של מזהי תרחישי בדיקה שמופרדים בפסיקים או במעברי שורה: `--test_case_ids_file: "/path/to/test-case-ids.txt"`

ניפוי באגים בתוצאות הבדיקה

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

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

בעיות ידועות ומגבלות

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

הסוכן של בדיקת האפליקציות משתמש ב-AI גנרטיבי כדי לבדוק את האפליקציה, ולכן לפעמים הוא יבצע פעולות שונות למרות שהוא פועל לפי אותן הוראות.
הסוכן של App Testing תומך רק בפעולות הבאות: הקשה, הזנת טקסט, החלקה למעלה/למטה/ימינה/שמאלה והמתנה.
לסוכן של בדיקת האפליקציה יש בעיה בהרצת בדיקות שמכילות רק שלב אחד שנדרשות בו הרבה פעולות כדי להשלים אותו. הוא פועל טוב יותר כשמשימות מורכבות מחולקות לכמה שלבים קצרים יותר.
לפעמים, סוכן בדיקת האפליקציות לא יגלול כדי לחשוף רכיבים אחרים שלא מוצגים במסך. זה קורה לעיתים קרובות יותר כשאין אינדיקציה ויזואלית לכך שאפשר לגלול. כפתרון עקיף, אפשר להשתמש בשדה hints (רמזים) כדי להציע גלילה.
לפעמים לסוכן App Testing יש בעיות בספירה, למשל בביצוע פעולה מספר מסוים של פעמים.
הסוכן של בדיקת האפליקציה לא יכול לנווט באפליקציה אם האפשרות FLAG_SECURE מופעלת. במקום צילומי מסך של האפליקציה, הוא יראה רק מסך ריק.

בדיקת מכסות

במהלך התצוגה המקדימה, הבדיקות המבוססות על AI יוצעו ללא עלות במסגרת מכסת שימוש. מגבלת ברירת המחדל של המכסה היא 200 בדיקות בחודש לכל פרויקט ב-Firebase.

שימו לב: אם תבחרו להריץ כמה תרחישי בדיקה או להריץ את אותו תרחיש בדיקה בכמה מכשירים, זה ייחשב לכמה בדיקות. לדוגמה, אם מריצים 2 תרחישי בדיקה ב-2 מכשירים, זה נחשב כ-4 בדיקות בסך הכול.

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