Paparazzi
An Android library to render your application screens without a physical device or emulator.
See the project website for documentation and APIs.
Jetifier
If using Jetifier to migrate off Support libraries, add the following to your gradle.properties
to exclude bundled Android dependencies.
android.jetifier.blacklist=android-base-common,common
Releases
Our change log has release history.
Using plugin application:
buildscript {
repositories {
mavenCentral()
google()
}
dependencies {
classpath 'app.cash.paparazzi:paparazzi-gradle-plugin:0.6.0'
}
}
apply plugin: 'app.cash.paparazzi'
Using the plugins DSL:
plugins {
id 'app.cash.paparazzi' version '0.6.0'
}
Snapshots of the development version are available in Sonatype's snapshots
repository.
repositories {
mavenCentral()
maven {
url 'https://oss.sonatype.org/content/repositories/snapshots/'
}
}
Tasks
$ ./gradlew some-project:testDebug
Runs tests and generates an HTML report at some-project/build/reports/paparazzi/debug/
showing all test runs and snapshots.
$ ./gradlew some-project:recordPaparazziDebug
Saves snapshots as golden values to a predefined source-controlled location (default: src/test/snapshots
).
$ ./gradlew some-project:verifyPaparazziDebug
Runs tests and verifies against previously-recorded golden values.
Check out the sample.
License
Copyright 2019 Square, Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.