This guide describes how to upload APKs to App Distribution and distribute builds
to testers using the Firebase console.
Before you begin
If you haven't already,
add Firebase to your Android
project
.
If you aren't using any other Firebase products, you only have to create a
project and register your app. However, if you decide to use additional
products in the future, be sure to complete all of the steps on the page
linked above.
Step 1. Build your app
When you're ready to distribute a pre-release version of your app to testers,
build your APK using your normal process. You must sign the APK with your debug
key or app signing key.
Step 2. Distribute your app to testers
To distribute your app to testers, upload your APK file using the
Firebase console:
Open the
App Distribution page
of the
Firebase console. Select your Firebase project when prompted.
On the
Releases
page, select the app you want to distribute from
the drop-down menu.
Drag your app's APK file to the console to upload it.
When the upload completes, specify the tester groups and individual testers
you want to receive the build. Then, add release notes for the build.
See
Manage testers
for more on
creating tester groups.
Click
Distribute
to make the build available to testers. The tester
automatically receives an email invitation to test the app.
(Optional) To share links to specific releases with testers who have access
to those releases, click the
Link
icon to copy the release link to the clipboard.
Once you distribute your build, it becomes available in the
App Distribution dashboard of the Firebase console for 150 days (five months).
When the build is 30 days from expiring, an expiration notice appears in both
the console and your tester's list of builds on their test device.
Testers who haven't been invited to test the app receive email invitations to
get started, and existing testers receive email notifications that a new build
is ready to test. For instructions on how to install the test app, see
Get set up as a tester with App Distribution
.
You can monitor the status of each tester-whether they accepted the
invitation and whether they downloaded the app-in the Firebase console.
Testers have 30 days to accept an invitation to test the app before it expires.
When an invitation is 5 days from expiring, an expiration notice appears in the
Firebase console next to the tester on a release. An invitation can be
renewed by resending it using the drop-down menu on the tester row.
Next steps