Firebase series · Part 3 of 4
Firebase App Distribution: Get Test Builds to Testers Fast
Before an app reaches the store, someone has to try it. App Distribution sends pre-release builds to your testers by email or link, so you can skip emailing APKs around. This is the overview; the official guide covers setup.
- What: deliver pre-release Android and iOS builds to testers.
- How: upload from the console, Gradle, the Firebase CLI or fastlane.
- Who: individual testers or named groups.
- Bonus: release notes, expiry, and tester feedback.
Contents
1. What it is
App Distribution is a pipeline for test builds. You upload an APK, AAB or IPA, choose who gets it, and testers receive an email with a link. It supports Android and iOS, with no store review in between.
2. How a build reaches a tester
Testers install the App Tester app (Android) or a web clip (iOS) and see every build you have shared with them. Each build carries a version, build number and release notes. On iOS, devices must be registered in your provisioning profile.
3. Ways to upload
| Method | Best for |
|---|---|
| Console drag and drop | One-off builds, quick checks. |
| Gradle plugin | Android developers; one command from the project. |
| Firebase CLI | Scripts and any CI. |
| fastlane | Teams already using fastlane for iOS and Android. |
4. Testers and groups
Add testers by email and put them in groups such as QA, Design or Beta. Send a build to a group and everyone in it is notified. Writing short release notes helps testers know what to check.
5. Automating with CI
The real payoff is automation. Let the pipeline upload every successful build and notify the group.
Authenticate CI with a service account or a token as Google documents, and keep it in your CI secret store.
6. Limits and good habits
- It is for testing, not for public release. Use the store tracks for that.
- Use separate Firebase apps or build variants (for example
.debugor.staging) so test and production builds do not collide. - Always include release notes with the commit or ticket.
- Remove testers who left the team.
Official links
Setup steps change often, so follow Google’s own guides rather than a copy here.
← Back to all writing