הערות לגבי גרסת בדיקה של תצוגה מקדימה של יצירה

‪0.0.1-alpha16

בגרסה הזו הוספנו תמיכה בחבילות בדיקה של AGP, שיפורים בדוחות בדיקה ב-HTML ותיקוני באגים:

  • שילוב של חבילות בדיקה: נוספה תמיכה בהרצת בדיקות צילום מסך של תצוגה מקדימה של Compose באמצעות פלאגין של Android Gradle‏ (AGP). מידע על הגדרה והפעלה של חבילות בדיקה לצילומי מסך זמין במאמר בנושא בדיקות צילומי מסך באמצעות חבילות בדיקה.
  • שיפורים בדוח הבדיקה ב-HTML: נוסף כרטיס מטא-נתונים של כותרת שמציג את פרטי תרחיש הבדיקה (שם, שיטה, תצוגה מקדימה, וריאציה, חבילה ותג סטטוס), ותיבת סיכום שגיאות שמסווגת כשלים (כמו תמונות הפניה חסרות או חוסר התאמה בממדים) עם פונקציונליות של העתקה מהירה ללוח.
  • הבדלים חזותיים דינמיים: ההבדלים החזותיים מציגים עכשיו מעבר הדרגתי רציף מהדגשות עדינות של שינויים קלים בפיקסלים ועד להדגשות בניגודיות גבוהה של הבדלים משמעותיים, כדי למנוע הסתרה של שינויים ברכיבים מקוננים.

הגרסה הזו כוללת גם את תיקוני הבאגים הבאים:

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

‪0.0.1-alpha15

הגרסה הזו כוללת את תיקוני הבאגים הבאים:

בעיה תיאור
בעיה מספר 500417360 תוקנה קריסת הפעלה (NoClassDefFoundError) כשמריצים תצוגות מקדימות עם Kotlin 2.1 ואילך, בגלל תלות kotlin-stdlib חסרה בטוען המחלקות המבודד של מסגרת Layoutlib.
בעיה מספר 384188032 תוקנה קריסת רינדור שהתרחשה כשמנפחים אובייקט ViewHolder בתוך מפעל Composable AndroidView.
בעיה מספר 351302272 נפתרו בעיות בטעינת משאבי drawable בתצוגות מקדימות שבהן המשאבים נמצאים במודולים של פרויקטים תלויים או מקבילים.
בעיה מספר 482664893 הבטחנו שמשימות האימות ייכשלו בצורה מתאימה כשבדיקות צילומי מסך יוצרות חריגים, במקום להצליח בצורה שגויה עם צילום מסך ישן.
בעיה מספר 497675618 סוכני כיסוי של JVM (כמו JaCoCo) תומכים במכשור של מחלקות שאפשר להרכיב (composable).
בעיה מספר 498545960 הוסרו שמות קבצים פנימיים (לדוגמה, ImageVerifier.kt) ממעקב אחר שגיאות במסוף JUnit כדי להבהיר את פלט הניפוי.
בעיה מספר 385613865 הסרנו את השימוש בנתיב מוחלט לתמונות בקובץ ה-XML של תוצאות הבדיקה, והחלפנו אותו בנתיבים יחסיים.
בעיה מספר 513276596 הבטחנו שכשעיבוד נכשל, משימות הבדיקה של צילומי המסך ייכשלו בצורה נכונה, ולא יעברו בשקט עם צילום מסך ריק.
בעיה מספר 340639802 נפתרו בעיות של התנגשויות בשיטת התצוגה המקדימה, שבהן בדיקות הותאמו באופן שגוי לשמות שיטות מלאים שתואמים להן ב-sourceset הראשי.

‪0.0.1-alpha14

הגרסה הזו כוללת את תיקוני הבאגים ושיפורי הביצועים הבאים:

בעיה תיאור
בעיה מספר 469819154 תוקנו דליפות זיכרון ברכיב העיבוד של כתיבת ההודעות.
בעיה מספר 470058578 תוקנו קפיאות בממשק המשתמש ושגיאות בזיכרון בזמן עדכון תמונות ההפניה.
בעיה מספר 422412664 תוקנו שגיאות מסוג 'שורת הפקודה חורגת ממגבלות מערכת ההפעלה' ב-Windows וב-GitHub Actions.
בעיה מספר 437223807 תוקנו בעיות שקשורות לפתרון של משאבים ונכסים בפרויקטים מרובי מודולים.
בעיה מספר 464899800 תוקנה התנגשות בתוסף Gradle שנגרמה מהתנגשות בשמות ב-version.properties.
בעיה מספר 482433854 תוקנו שגיאות אתחול של פונקציות composable באמצעות kotlin-reflect או סריאליזציה.

‪0.0.1-alpha13

בגרסה הזו הוספנו:

  • תאימות ל-JDK מגרסה 17 ואילך.
  • תיקוני באגים ושיפורים בשילוב עם Android Studio.

‪0.0.1-alpha12

בגרסה הזו הוספנו:

  • תאימות ל-Android Gradle Plugin‏ (AGP) 9.0.
  • תמיכה בהרצת בדיקות צילומי מסך ב-JDK 24 ואילך.
  • תמיכה בהגדרת גודל הערימה המקסימלי.
  • תוקנו כשלים בעיבוד ושופרה יציבות הבדיקה.
  • שיפרנו את הדיווח כך שיכלול את ההבדל באחוזים ומטא-נתונים אחרים שקשורים לתמונות חדשות ולתמונות עזר.

‪0.0.1-alpha11

בגרסה הזו הוספנו:

  • תאימות ל-Android Gradle Plugin ‏ (AGP) 8.13.
  • נוספה תמיכה בניתוח של נכסי drawable בפורמט XML עם ערכים עשרוניים, ללא קשר ללוקאל של המחשב המארח.
  • במחשב מארח שמותקנת בו JDK בגרסה 24 ומעלה, תזוהה JDK תואמת (בגרסה 11 עד 23), אם היא מותקנת.

‪0.0.1-alpha10

בגרסה הזו הוספנו:

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

  • הספרייה של תמונת ההפניה השתנתה מ-{module}/src/{variant}/screenshotTest/reference ל-{module}/src/screenshotTest{Variant}/reference. כך מוודאים שתמונות הייחוס שנוצרו לא יהיו חלק מקוד הייצור, ושהן יתאימו למבנה הספריות של סוגי בדיקות אחרים.

  • המשימה {variant}PreviewScreenshotRender מוסרת. עיבוד התמונה מועבר אל JUnit Test Engine.

  • במשימה update{Variant}ScreenshotTest, המערכת תשווה בין תמונות רינדור חדשות לבין תמונות הפניה לפני העדכון. העדכון יתבצע רק בתמונות שבהן ההבדלים גדולים יותר מסף שצוין. הוסר הדגל --updateFilter בשורה של פקודות.

‪0.0.1-alpha06

בגרסה הזו הוספנו:

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

    testOptions {
        screenshotTests {
            imageDifferenceThreshold = 0.0001f // 0.01%
        }
    }

הסף הזה יחול על כל בדיקות צילומי המסך שמוגדרות במודול.

  • תיקוני באגים: תיקנו כמה באגים ב-Compose Renderer והוספנו תמיכה ב-Compose ריק.
  • שיפורים בביצועים: האלגוריתם להשוואת תמונות עודכן כדי לפעול מהר יותר.