Deploy & App Stores

How to Publish a Windsurf-Built App on Google Play

Publishing a Windsurf-built app on Google Play is a natural fit for an agentic editor: Cascade can build the Android project with Gradle, run it on an emulator, read logs and fix errors in a loop on any operating system. You then sign an .aab, release it via Play Console and, on a new personal account, complete a closed test with 12 testers for 14 days.

neooutput editorial team 3 min read Auf Deutsch lesen

How do you let Cascade build and test Android apps?

Install the Android SDK and a JDK, make sure Gradle works from the terminal and let Cascade run the build commands. Because Android tooling is fully command-line capable, the agent can verify its own changes.

Keep Android Studio around for the emulator manager, Layout Inspector and profiling, and open the same project there when you need visual debugging.

  • ./gradlew assembleDebug and tests after each agent change
  • adb logcat output pasted or streamed back to Cascade
  • Emulator with a recent and an older Android version

What should your Windsurf rules include for Android?

Lock down the identifiers and spell out Android conventions. Agents forget the back button and runtime permissions surprisingly often without explicit rules.

Add a rule that any targetSdk change must come with a summary of behavior changes, because Google Play's target API requirement moves regularly.

  • applicationId fixed, versionCode increments per release
  • Runtime permission requests for every dangerous permission
  • Edge-to-edge insets and predictive back support
  • Keystore and Play service account files never committed

How do you produce the signed .aab?

Create the upload keystore yourself, have Cascade configure Gradle signing from environment variables and build with ./gradlew bundleRelease. Enroll in Play App Signing so Google holds the app signing key.

Test the release variant on a device; minification can break code paths that worked in debug.

  1. Create upload keystore and back it up securely
  2. Cascade: add signing config and a release CI workflow
  3. Build the .aab and upload it manually as the first release in Play Console
  4. Cascade: add fastlane supply or Play Developer API uploads for later releases

How do you handle the 14-day closed test?

New personal accounts must keep at least 12 testers opted into a closed test for 14 consecutive days before requesting production access. Recruit testers in advance and start the test with your first stable build.

Ship fixes during the test. Combining tester reports with logcat output lets Cascade turn bugs into fixes quickly, and Google asks about your testing when you apply for production.

Which Android capabilities should the app include?

Add the features that make the app worth installing: push via Firebase Cloud Messaging, App Links verified with assetlinks.json, offline handling and a clean back stack. Each is a good, well-scoped task for Cascade.

If you sell digital content or subscriptions, Google Play Billing is generally required; test with license testers.

How do you complete Data safety and policies?

Have Cascade produce a data inventory from the code and dependencies, then verify it and fill in the Data safety form yourself. The answers must match your privacy policy.

Provide account deletion in the app and via a web link, test credentials for app access, the content rating questionnaire and target audience declarations.

What is the fastest path to a stable release?

Rules, CI and early closed testing make the difference. neooutput helps teams adopt Windsurf and other agentic tools through workshops and delivery by our AI Code Engineers, and appsubmitter.io supports Play Store submissions.

If your Windsurf project is a web app and a native Android project feels like overkill, WebViewGold converts the deployed web app into native Android and iOS apps without code, including configurable push notifications, deep links and an offline screen. The result must still offer native value beyond the website, particularly for Apple's guideline 4.2 if you publish on iOS as well.

Frequently asked questions

Can Windsurf run the Android emulator?

Cascade can launch emulators and install builds via terminal commands if the Android SDK is installed. For visual inspection, Android Studio's tools are still more convenient.

Do I need Android Studio for publishing?

Not strictly. Gradle can build and sign the .aab from the command line. Android Studio helps with debugging and profiling.

What if my account is an organization account?

Organization accounts are currently not subject to the 12-tester, 14-day rule, but they require business verification such as a D-U-N-S number.

Can Cascade fill in the Play Console forms?

It can draft texts and Data safety answers. A human should review and submit declarations, since the account owner is responsible for their accuracy.

All insights