Paparazzi

一个Android包, 能够在没有物理设备或者模拟器的情况下, 渲染应用页面.

class LaunchViewTest {
  @get:Rule
  val paparazzi = Paparazzi(
    deviceConfig = PIXEL_5,
    theme = "android:Theme.Material.Light.NoActionBar"
    // ...see docs for more options
  )

  @Test
  fun launchView() {
    val view = paparazzi.inflate<LaunchView>(R.layout.launch)
    // or...
    // val view = LaunchView(paparazzi.context)

    view.setModel(LaunchModel(title = "paparazzi"))
    paparazzi.snapshot(view)
  }

  @Test
  fun launchComposable() {
    paparazzi.snapshot {
      MyComposable()
    }
  }
}

任务

$ ./gradlew sample:testDebug

运行测试并且在sample/build/reports/paparazzi/生成HTML报告, 报告会显示全部测试的运行的快照.

$ ./gradlew sample:recordPaparazziDebug

将快照保存为黄金值到预定义的受源代码管理的位置(默认保存到src/test/snapshots).

$ ./gradlew sample:verifyPaparazziDebug

运行测试并检验之前记录的黄金值. 失败的话会在sample/out/failures生成diff文件.

要想查看更多的信息, 请查看sample项目.

Git LFS

推荐使用Git LFS保存快照. 下面是快速设置:

$ brew install git-lfs
$ git config core.hooksPath  # optional, confirm where your git hooks will be installed
$ git lfs install --local
$ git lfs track "**/snapshots/**/*.png"
$ git add .gitattributes

在CI上, 可以像这样设置:

$HOOKS_DIR/pre-receive

# compares files that match .gitattributes filter to those actually tracked by git-lfs
diff <(git ls-files ':(attr:filter=lfs)' | sort) <(git lfs ls-files -n | sort) >/dev/null

ret=$?
if [[ $ret -ne 0 ]]; then
  echo >&2 "This remote has detected files committed without using Git LFS. Run 'brew install git-lfs && git lfs install' to install it and re-commit your files.";
  exit 1;
fi

your_build_script.sh

if [[ is running snapshot tests ]]; then
  # fail fast if files not checked in using git lfs
  "$HOOKS_DIR"/pre-receive
  git lfs install --local
  git lfs pull
fi

Jetifier

如果在使用Jetifier迁移Support包, 将下面的内容添加到gradle.properties文件来排除捆绑的Android依赖.

android.jetifier.ignorelist=android-base-common,common

Releases

变更日志保留了发版的历史.

应用插件:

buildscript {
  repositories {
    mavenCentral()
    google()
  }
  dependencies {
    classpath 'app.cash.paparazzi:paparazzi-gradle-plugin:1.0.0'
  }
}

apply plugin: 'app.cash.paparazzi'

使用插件DSL:

plugins {
  id 'app.cash.paparazzi' version '1.0.0'
}

开发版的快照在Sonatype的快照仓库.

 repositories {
   // ...
   maven {
     url 'https://oss.sonatype.org/content/repositories/snapshots/'
   }
 }

包名 app.cash.paparazzi

类型

函数

作者：bytebeats
链接：https://juejin.cn/post/7147491565047398408