בדיקת קוד של פלטפורמה באמצעות atest
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
Android Studio for Platform (ASfP) משולב עם כלי שורת הפקודה atest, ומאפשר להריץ בדיקות במכשיר המחובר או באמולטור ישירות מתוך סביבת הפיתוח המשולבת (IDE).
דרישות מוקדמות
- פותחים פרויקט ASfP עם קוד המקור של AOSP.
- בונים את הקוד ומעבירים אותו למכשיר או לאמולטור.
- מאתחלים את סביבת הבנייה באמצעות
source build/envsetup.sh ו-lunch.
הרצת בדיקות
יש כמה דרכים להריץ בדיקות באמצעות atest ב-ASfP:
סמלי הפעלה בשוליים: לוחצים על סמל ההפעלה play_circle
לצד מחלקה או שיטה לבדיקה בעורך כדי להריץ את הבדיקה הספציפית הזו.
תפריט לחיצה ימנית: לוחצים לחיצה ימנית על קובץ בדיקה, מחלקה או שיטה בחלון Project או בעורך ובוחרים באפשרות Run 'atest' (הפעלת בדיקה).
באמצעות הטרמינל: פותחים את הטרמינל המשולב ב-ASfP (View > Tool
Windows > Terminal) ומריצים פקודות atest ישירות. לדוגמה: bash
atest MyTestModule
atest MyTestClass#myTestMethod
צפייה בתוצאות הבדיקה
תוצאות הבדיקה מוצגות בחלון כלי הפעלה ב-ASfP. בחלון הזה מוצגות התקדמות הבדיקה, סטטוס ההצלחה או הכישלון, ויומנים ופלט לכל בדיקה.
הגדרות הבדיקה
כשמריצים בדיקה מהשוליים או מתפריט הלחיצה הימנית, ASfP יוצר באופן אוטומטי הגדרת הרצה או ניפוי באגים זמנית. אפשר לשנות ולשמור את ההגדרות האלה כדי להריץ מחדש במהירות בדיקות עם אפשרויות או דגלים ספציפיים:
- עוברים אל הפעלה > עריכת הגדרות.
- מחפשים את ההגדרה
atest שרוצים לשנות או יוצרים הגדרה חדשה על ידי לחיצה על הלחצן + ובחירה באפשרות הכי עדכני.
- מציינים את מודול הבדיקה, המחלקה והשיטה, ומוסיפים את האפשרויות הנדרשות של
atestשורת הפקודה.
טיפים לבדיקה
- בדיקות ממוקדות: כדי לחסוך זמן, מריצים רק את הבדיקות הספציפיות שצריך. משתמשים בפורמט
Module:Class#Method או במסננים אחרים של atest.
- שימוש בתמונות מצב של אמולטור: כדי להריץ בדיקות מהר יותר באמולטורים, כדאי להשתמש בתמונות מצב כדי לחזור במהירות למצב תקין מוכר.
- בדיקת היומנים: משתמשים ביומנים בחלון הכלים Run כדי לאבחן כשלים בבדיקה.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-09-05 (שעון 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-09-05 (שעון UTC)."],[],[],null,["Android Studio for Platform (ASfP) integrates with the `atest` command-line\ntool, letting you run tests on your connected device or emulator directly from\nthe IDE.\n\nPrerequisites\n\n- Open an ASfP project with your AOSP source code.\n- Successfully build and flash your code to a device or emulator.\n- Initialize your build environment using `source build/envsetup.sh` and `lunch`.\n\nRun tests\n\nYou can run tests using `atest` in ASfP in several ways:\n\n- **Gutter run icons:** Click the **Run** icon play_circle\n\n next to a test class or method in the editor to run that specific test.\n- **Right-click menu:** Right-click on a test file, class, or method in the\n Project window or editor and select **Run 'atest'**.\n\n- **Using the terminal:** Open the integrated terminal in ASfP (**View \\\u003e Tool\n Windows \\\u003e Terminal** ) and run `atest` commands directly. For example: `bash\n atest MyTestModule\n atest MyTestClass#myTestMethod`\n\nView test results\n\nTest results are displayed in the **Run** tool window within ASfP. This window\nshows the test progress, pass or fail status, and provides logs and output for\neach test.\n\nTest configurations\n\nWhen you run a test from the gutter or right-click menu, ASfP automatically\ncreates a temporary run or debug configuration. You can modify and save these\nconfigurations to quickly re-run tests with specific options or flags:\n\n1. Go to **Run \\\u003e Edit Configurations**.\n2. Find the `atest` configuration you want to modify or create a new one by clicking the **+** button and selecting **atest**.\n3. Specify the test module, class, method, and add any necessary `atest` command-line options.\n\nTips for testing\n\n- **Targeted testing:** Run only the specific tests you need to save time. Use the format `Module:Class#Method` or other `atest` filters.\n- **Use emulator snapshots:** For faster test runs on emulators, consider using snapshots to quickly revert to a known good state.\n- **Check logs:** Use the logs in the **Run** tool window to diagnose any test failures."]]
