Skip to content

APK and AAB

Every successful Android build produces two files. They are the same app — the APK is repacked from the bundle — and which you want depends on who is installing it.

An iOS build produces one file instead, an .ipa, which nobody installs by hand: it goes to TestFlight. See How iOS builds work.

.apk.aab
Full nameAndroid PackageAndroid App Bundle
Install directly on a phoneYesNo
Upload to Google PlayNoYes
Send to a testerYesNo
Contains every screen density and architectureYesYes, split by the store on delivery
SizeLargerSmaller as delivered, because Play sends each device only what it needs

Use the APK to put the app on a phone yourself, to share with your team, or to hand to members directly.

Use the AAB for Google Play. Play has not accepted APK uploads for new apps since 2021.

  1. Transfer it to the phone — email, cloud drive or USB.
  2. Open it on the device.
  3. Allow installs from that source when Android asks.
  4. Open the app.

Android warns about apps that did not come from Play. That warning is about the source, not the app, and it is expected for a build you compiled and installed yourself.

Whether the .aab is uploadable depends on what signed it. With no upload key set up, your build is signed for testing — installable on any phone, refused by Play. See Android signing and the Play Store.

SymptomCauseFix
The phone will not open the .aabApp bundles are not installable filesDownload the .apk instead
App not installed on an older deviceAn earlier build with a different signature is already installedUninstall the old one first
Play rejects the upload as debug-signedThat build was signed for testing, not with your upload keyAndroid signing
The APK installs but shows a white screenThe app cannot reach your siteConfirm the site is public and serving over HTTPS