איך להריץ דו״ח Allure בפרויקט Appium (JUnit5 + Maven)
Allure הוא כלי דוחות שמציג בצורה יפה את תוצאות הטסטים: סטטוסים, צעדים, צילומי מסך/קבצים מצורפים, תיאורים, וחומרה (Severity).
בפרויקט JUnit5 אפשר לחבר את Allure באמצעות Extension ואז להפיק דו״ח מקובץ התוצאות שב-allure-results.
1) חיבור Allure לטסטים (JUnit5)
בדוגמה שלנו אנחנו מחברים את Allure דרך ההרחבה AllureJunit5 ומוסיפים אנוטציות לדוח:
@ExtendWith(AllureJunit5.class)
@TestInstance(TestInstance.Lifecycle.PER_CLASS)
@Epic("Android Framework")
@Feature("Basic Framework Functionality")
@Story("Initial Example Usage")
public class WulfQA {
// tests...
}
בנוסף, בכל טסט ניתן להוסיף:
@DisplayName, @Severity, @Description
כדי שהדו״ח יהיה ברור וקריא.
2) להריץ טסט ספציפי עם Maven
כדי להריץ רק טסט אחד (או אפילו מתודה אחת) אפשר להשתמש ב--Dtest.
בדוגמה הזו מריצים רק את המתודה actions מתוך המחלקה WulfQA:
cd "/path/to/WulfAutomation" \
&& mvn -Dtest="Android.ReadMe.WulfQA#actions" clean test
הרצת כל המחלקה (כל הטסטים בתוך WulfQA):
cd "/path/to/WulfAutomation" \
&& mvn -Dtest="Android.ReadMe.WulfQA" clean test
אחרי הריצה, Maven ייצור תוצאות Allure בתוך:
target/allure-results
3) להציג את הדו״ח (Allure Serve)
כדי לפתוח דו״ח מקומי בדפדפן (שרת זמני), מריצים:
allure serve target/allure-results
זה ירים שרת מקומי, יפתח דפדפן ויציג את הדו״ח.
4) תוצאה: מה תראו בדו״ח
- שם הטסט לפי @DisplayName
- חומרה לפי @Severity
- תיאור לפי @Description
- ציר זמן של הרצה וסטטוס Pass/Fail
- Attachments אם אתם מצרפים חריגות/צילומי מסך (לדוגמה דרך ExceptionUtils.attachException)
פקודה מלאה (דמו)
cd "/path/to/WulfAutomation" \
&& mvn -Dtest="Android.ReadMe.WulfQA#actions" clean test \
&& allure serve target/allure-results
מקורות רשמיים:
ללימוד עמוק יותר: העתקו את הפרומט הבא ל-ChatGPT, הדביקו ושלחו.
אתה מומחה QA ואוטומציה. קראתי את המאמר הזה: https://qablog.co.il/allure-report
תסביר לי בפשטות (אבל מדויק) איך להריץ דו"ח Allure בפרויקט Java (JUnit5 + Maven), לפי הסדר:
1) איך Allure מתחבר ל-JUnit5 (AllureJunit5 + אנוטציות כמו @Epic/@Feature/@Story/@Severity/@Description)
2) איך להריץ טסט ספציפי ב-Maven עם -Dtest כולל הרצה של מתודה אחת (Class#method)
3) איפה נוצרים קבצי התוצאות (target/allure-results) ומה חשוב לבדוק אם התיקייה ריקה
4) איך לפתוח את הדוח עם: allure serve target/allure-results
5) איך לצרף Attachments לדוח (exceptions, screenshots, logs) כדי שהדוח יהיה שימושי
תשאל אותי עד 5 שאלות קצרות כדי להתאים את ההנחיות אליי (Windows/Mac, Maven עובד?, האם allure CLI מותקן?, האם אני משתמש JUnit5, ומה שם המחלקה/המתודה שאני מריץ).
