Compose 預覽版螢幕截圖測試版本發行說明

0.0.1-alpha14

這個版本包含下列錯誤修正和效能提升:

問題 說明
問題 #469819154 修正 Compose 轉譯器中的記憶體流失問題。
問題 #470058578 修正更新參考圖片時,使用者介面凍結和記憶體錯誤的問題。
問題 #422412664 修正 Windows 和 GitHub Actions 上「指令列超出作業系統限制」的錯誤。
問題 #437223807 修正多模組專案中的資源和資產解析問題。
問題 #464899800 修正 version.properties 中命名衝突導致的 Gradle 外掛程式衝突。
問題 #482433854 修正了使用 kotlin-reflect 或序列化時,可組合項目的初始化錯誤。

0.0.1-alpha13

這個版本推出以下功能:

  • 與 JDK 17 以上版本相容。
  • 修正錯誤,並改善與 Android Studio 的整合。

0.0.1-alpha12

這個版本推出以下功能:

  • 與 Android Gradle 外掛程式 (AGP) 9.0 相容。
  • 支援在 JDK 24 以上版本執行螢幕截圖測試。
  • 支援設定堆積大小上限。
  • 修正算繪失敗問題,並提升測試穩定性。
  • 加強報表功能,納入與新圖片和參考圖片相關的百分比差異和其他中繼資料。

0.0.1-alpha11

這個版本推出以下功能:

  • 與 Android Gradle 外掛程式 (AGP) 8.1 相容。
  • 開始支援剖析含有十進位值的 XML 可繪項目,不受主機語言代碼影響。
  • 如果主體機器使用 JDK 24 以上版本,系統會選取相容的 JDK (11-23),前提是已安裝這類 JDK。

0.0.1-alpha10

這個版本推出以下功能:

  • 從這個版本開始,您需要使用 @PreviewTest 註解標記所有預覽函式。如果預覽畫面沒有註解,系統就不會執行。

  • 參考圖像目錄已從「 {module}/src/{variant}/screenshotTest/reference」變更為「 {module}/src/screenshotTest{Variant}/reference」。這是為了確保產生的參照圖片不會成為正式版程式碼的一部分,並與其他測試類型的目錄結構保持一致。

  • 已移除 {variant}PreviewScreenshotRender 工作。圖片轉譯作業已遷移至 JUnit 測試引擎。

  • 這項update{Variant}ScreenshotTest工作會先比較新算繪圖片與參考圖片,再進行更新。只有差異大於指定閾值的圖片會更新。已移除 --updateFilter 指令列旗標。

0.0.1-alpha06

這個版本推出以下功能:

圖片差異門檻:這項新的全域門檻設定可讓您更精細地控制螢幕截圖比較作業。如要設定,請更新模組的 build.gradle.kts:

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

這個門檻會套用至模組中定義的所有螢幕截圖測試。

  • 修正錯誤:修正部分 Compose 算繪器錯誤,並新增對空白 Compose 的支援。
  • 效能提升:更新了圖片差異演算法,速度更快。