Export¶
./gradlew storeExport renders (if needed) and writes the final, store-ready images to
build/store/export/, together with an index.json that describes every asset.
What export does to each image¶
- Checks the size against the exact dimensions of its store slot. Deviations of up to
sizeTolerancePx(0–2 px) are fixed withsizeMismatchPolicy:CROP_OR_PADtrims or pads symmetrically with the background color,FAILstops the export. Chameleon Store Studio never rescales images. - Removes transparency, which both stores reject, by flattening onto
background. - Encodes a 24-bit PNG. If the PNG exceeds the store's size limit and
jpegFallbackis enabled, it re-encodes as JPEG, lowering the quality fromjpegQualityuntil it fits. - Hashes the image (exact pixel hash and perceptual hash) for baselines and diffs, and records the text captured while rendering.
Images are processed in parallel, so export time grows slowly with the number of screenshots.
Folder layout¶
build/store/export/
├── play_store/
│ ├── en-US/
│ │ ├── phone/01_home.png
│ │ ├── tablet_10/01_home.png
│ │ └── feature_graphic/01_feature_graphic.png
│ └── es-419/…
├── app_store/
│ └── en-US/
│ ├── iphone_6_9/01_home.png
│ └── ipad_13/01_home.png
└── index.json
layout |
Structure |
|---|---|
STORE_LOCALE_DEVICE (default) |
play_store/en-US/phone/01_home.png |
LOCALE_STORE_DEVICE |
en-US/play_store/phone/01_home.png |
LOCALE_DEVICE |
en-US/phone/01_home.png |
The default layout is plain folders per store, locale and device, so you can upload them with your own tooling if you don't use Store Studio's publishing.
Listing texts¶
After storeExport, the storeExportMetadata task runs automatically and writes the
metadata texts as plain files to build/store/export-metadata/. It is a sibling of
build/store/export/ with the same inner layout, so the two trees merge with a plain copy. Only the
enabled targets are written, and empty fields are skipped.
build/store/export-metadata/
├── play_store/
│ ├── en-US/metadata/
│ │ ├── title.txt
│ │ ├── short_description.txt
│ │ ├── full_description.txt
│ │ └── release_notes.txt
│ └── release-notes/
│ ├── whatsnew-en-US
│ └── whatsnew-es-MX
└── app_store/
└── en-US/metadata/
├── name.txt
├── subtitle.txt
└── …
- File names are the same as the input files.
play_store/release-notes/whatsnew-<locale>(no extension) is written for each Google Play locale with release notes. It is the flat format commonly expected by Google Play upload steps in CI.- With
layoutset toLOCALE_STORE_DEVICEthe texts follow the same order (en-US/play_store/metadata/). WithLOCALE_DEVICE, where both stores share the locale folder, they go to<locale>/metadata/<store>/.
You can also run ./gradlew :app:storeExportMetadata on its own.
Configuration¶
storeStudio {
export {
background.set("#19191C") // flatten onto your app's background color
sizeTolerancePx.set(0) // require exact sizes
sizeMismatchPolicy.set(SizeMismatchPolicy.FAIL)
jpegFallback.set(true)
jpegQuality.set(0.92f)
layout.set(ExportLayout.STORE_LOCALE_DEVICE)
lowercaseFolders.set(true)
}
}
exportStoreAssets is an alias of storeExport.