Everything is configured in the storeStudio { } block of the module that applies the plugin. All
options have sensible defaults; most projects only set stores, devices and locales.
Each block below is optional. The full option list with defaults is in the reference tables; the
dedicated pages explain when to change them.
storeStudio{rendering{// see RenderingmaxParallelProcesses.set(2)rendererJvmArgs.set(listOf("-Xmx3g"))}export{// see Exportbackground.set("#FFFFFF")layout.set(ExportLayout.STORE_LOCALE_DEVICE)}validation{// see ValidationfailOnWarning.set(true)severityOverrides.put("ORDER_DUPLICATE",Severity.INFO)}metadata{// see Store Metadatadirectory.set(layout.projectDirectory.dir("store/metadata"))}baseline{// see Baselines & Visual Diffrequired.set(true)}reports{/* … */}// see HTML ReportsstatusBar{/* … */}// see Composing Screenshotsci{/* … */}// see CI Integrationpublishing{/* … */}// see Publishing}
STRICT: any pixel or text difference is a change. PERCEPTUAL: tolerates small rendering differences between operating systems; text changes still count.
perceptualThreshold
0.05
Maximum perceptual distance (0–1) still considered unchanged.
failOnDrift
true
storeVerify fails when images changed.
required
false
storeVerify fails when no baseline is recorded, instead of skipping.
baseExportDir
unset
Export of the base revision to compare against (same as --base-export).
Each store uses its own platform's icon first. Only the conventional names above are searched, in the
module and then in the root project; anything else must be configured. A store without an icon of
its own previews the other store's icon, and shows the Chameleon placeholder when neither exists.
Only the Google Play icon is ever uploaded, so an iOS icon is never sent to Google Play.
The fake device status bar drawn by DeviceMockup. Off by default: screenshots have no status
bar unless you enable it here or pass statusBar to a single DeviceMockup. See
Composing Screenshots.
Option
Default
Description
enabled
false
Draws the status bar on every device mockup that doesn't override it.
style
AUTO
AUTO picks the iOS look for iPhone and iPad frames and the Android look for the rest. ANDROID and IOS force a look.
time
"9:41"
Clock text.
wifi, cellular
4
Signal levels, 0 to 4.
battery
100
Battery percentage, 0 to 100. At 20% or less it turns red, unless charging.
charging
false
Shows a charging bolt.
darkIcons
false
Dark ink instead of white. This applies to every screenshot, so override it on dark screens.
showTime, showWifi, showCellular, showBattery
true
Hides the element when false. Hidden elements take no space.
IPA to upload. Required by storePublishAppStoreBinary.
appStore.build.bundleShortVersion, bundleVersion
from the IPA
Version and build number.
appStore.build.betaGroups
empty
TestFlight groups to add the build to.
appStore.build.submitBetaReview, submitForReview
false
Submit for TestFlight beta review or App Store review.
appStore.build.useReleaseNotesAsWhatToTest
true
Use the release notes as TestFlight What to Test.
appStore.build.pollInterval, processingTimeout
15s, 1h
Processing checks and their maximum duration.
Keep secrets out of build files
Read credentials from environment variables or Gradle properties, for example
serviceAccountJson.set(providers.environmentVariable("PLAY_SERVICE_ACCOUNT_JSON")).