Documentation
Google Play Internal
Create the Play app, invite a service account, and let CapWrap create (or store) the upload keystore.
Android requires a Play Console developer account and an application with the same package name as the Capacitor App ID.
1. Create the app in Play Console
Create the app, set the package name to your App ID (app.yourbrand.mobile). Complete Play’s basic listing / declarations far enough that internal testing is allowed. CapWrap uploads to the internal testing track, not production.
Enroll in Play App Signing (Google’s default). CapWrap signs an upload bundle; Google re-signs what users install.
2. Create a service account
A service account is a Google login for tools.
- In Play Console: Setup → API access (or Users and permissions → API access). Link a Google Cloud project (Play can create one). Google’s guide: Use the Google Play Developer API.
- In Google Cloud → Service accounts, create an account (name it something like
capwrap-play). Skip extra Cloud roles. Create a JSON key and download it — shown once. - Copy the service account email (
name@project.iam.gserviceaccount.com). In Play Console, invite that email to this app with permission to release to testing tracks. Production release is not required. - In Google Cloud, enable the Google Play Android Developer API. If Google says it is activating, wait a minute.
3. Keystore
A keystore stamps the upload. Play will reject an unsigned AAB.
- New app: in CapWrap choose I don’t have a keystore. CapWrap creates one and stores it. Download it from Settings if you will ever sign in Android Studio — never create a second upload key.
- Existing Play app: upload the
.jks/.keystoreyou already registered, plus passwords and alias.
4. Save in CapWrap
Settings → Play Store: package name, JSON, then save (and mint or upload the keystore).
JSON and keystore never go into Git. You can download the CapWrap-created keystore later; keep alias and passwords private.
After the first upload
Play Console → Testing → Internal testing. Testers need the opt-in link. Like Apple, processing is not instant.
Closed testing and production promote are not started from CapWrap yet.