Skip to content

Tasks Reference

All tasks belong to the store studio group (./gradlew tasks --group "store studio"). Run them on a module, for example ./gradlew :app:storeExport.

Everyday tasks

Task Description
storeExport Render if needed and export store-ready images. Alias: exportStoreAssets.
storeValidate Validate images and listing text against store rules. Runs with check in app modules.
storeStudio Lifecycle: validation, baseline verification, gallery and listing preview.
storeGallery HTML gallery. Alias of exportStoreGalleryHtml.
storeListingPreview HTML store listing preview. Alias of exportStoreListingPreviewHtml.

Pipeline

Task Description
storeMergeManifest Merge KSP manifests of this module and its project dependencies.
storePrepareLayoutlib Resolve and unpack Layoutlib (cached across builds).
storeRender Render with Layoutlib. Cacheable.
storeRenderRobolectric Render the jobs Layoutlib couldn't with Robolectric.
storeParseMetadata Parse store/metadata into metadata.json.
storeExportMetadata Write the listing texts and release notes as plain files to build/store/export-metadata/. Runs after storeExport.

Baselines and diff

Task Options Description
storeRecordBaseline Record the current export as the approved baseline.
storeVerify Fail if the export differs from the committed baseline (baseline.failOnDrift). Skipped when there is none, unless baseline.required.
storeDiff --render-base, --against=<ref>, --base-export=<dir> Compute changes into diff.json.
exportStoreDiffHtml --include-unchanged HTML diff report and Markdown summary.
storeDiffReport Lifecycle for the diff report.

CI

Task Options Description
storeCi --[no-]fail-on-drift, --[no-]fail-on-validation, --post-pr-comment, --pr-number=<n> Quality gate with summary and PR comment.
storeCiCheck Lifecycle alias of storeCi.

Publishing

Task Options Description
storePublish --target=ALL|PLAY_STORE|APP_STORE, --parts=<parts>, --publish-dry-run, --track, --release-status, --release-name, --upload-timeout=<duration>, --release-file, --ipa, --package-name, --bundle-id, --beta-group, --submit-beta-review, --submit-for-review Full release: app binary + complete listing across configured stores.
storePublishListing --target=ALL|PLAY_STORE|APP_STORE, --parts=<parts>, --publish-dry-run, --track, --package-name, --bundle-id Complete listing without binary across configured stores.
storePublishTexts same as storePublishListing Listing texts only across configured stores (does not render or export).
storePublishReleaseNotes same as storePublishListing Release notes / What's New only across configured stores (does not render or export).
storePublishImages same as storePublishListing Visual assets (screenshots, feature graphic, icon) only across configured stores.
storePublishPlay --parts=<parts>, --track, --release-status, --release-name, --upload-timeout=<duration>, --release-file, --mapping-file, --user-fraction, --in-app-update-priority, --existing-edit-id, --changes-not-sent-for-review, --package-name, --publish-dry-run Full release: binary + complete listing in a single atomic Google Play Edit.
storePublishPlayListing --parts=<parts>, --publish-dry-run, --track, --changes-not-sent-for-review, --package-name Complete listing (images, texts, and release notes) on Google Play, without binary.
storePublishPlayTexts same as storePublishPlayListing Title and descriptions only (does not render or export).
storePublishPlayReleaseNotes same as storePublishPlayListing Release notes only on a track (does not render or export).
storePublishPlayImages same as storePublishPlayListing Screenshots, feature graphic, and icon only.
storePublishAppStore --parts=<parts>, --publish-dry-run, --bundle-id, --ipa, --bundle-short-version, --bundle-version, --beta-group, --submit-beta-review, --submit-for-review IPA binary + complete listing on App Store Connect in a single coordinated session (experimental).
storePublishAppStoreListing --parts=<parts>, --publish-dry-run, --bundle-id Complete listing without binary on App Store Connect.
storePublishAppStoreTexts same as storePublishAppStoreListing Listing texts only (does not render or export).
storePublishAppStoreReleaseNotes same as storePublishAppStoreListing What's New only (does not render or export).
storePublishAppStoreImages same as storePublishAppStoreListing Screenshots only.

See Publishing for what each task publishes and Selecting parts with --parts for --parts=<parts> (binary, texts, images, releaseNotes, all).

Gradle properties: -PstoreStudio.publish.dryRun=true, -PstoreStudio.publish.track=<track>, -PstoreStudio.publish.parts=<parts>, -PstoreStudio.publish.betaGroups=<g1,g2>, -PstoreStudio.publish.submitBetaReview=true|false, and -PstoreStudio.publish.submitForReview=true|false.

Binary publishing

These tasks upload only the app binary itself. They do not render, export, or validate screenshots, and they do not touch listing texts or images. Details and every option are in Binary Publishing.

Task Options Description
storePublishPlayBinary --release-file=<path> (repeatable), --track, --release-status, --user-fraction, --in-app-update-priority, --release-name, --upload-timeout=<duration>, --mapping-file, --existing-edit-id, --changes-not-sent-for-review, --publish-dry-run Binary + mapping + release notes only (does not render or export). Uploads the AAB to a Google Play track. Without --release-file, uses the AGP bundle of release.variant.
storePublishAppStoreBinary --ipa=<path>, --bundle-short-version, --bundle-version, --beta-group=<name> (repeatable), --submit-beta-review, --submit-for-review, --publish-dry-run IPA binary only. Uploads the IPA to App Store Connect and waits for processing.
storePublishBinary Lifecycle: binaries only for configured stores. Runs the Play binary task when an Android application is configured or release files are set, and the App Store task when an IPA is set.

Use --publish-dry-run, not --dry-run: Gradle handles --dry-run itself and skips the tasks.

Gradle properties for the diff

Command-line options only reach the task you name. When storeDiff runs as a dependency (of storeCi, storeDiffReport or exportStoreDiffHtml), set its base with properties: -PstoreStudio.diff.renderBase=true, -PstoreStudio.diff.against=<ref> and -PstoreStudio.diff.baseExport=<dir>.

Diagnostics

Task Description
storeDoctor Check JDK, Android SDK, plugins, KSP and configuration, with fixes for each problem.
storeDump Print the resolved configuration and render matrix (screenshots × slots × locales).