Edit this page
Learn how to configure and install a .apk for Android Emulators and devices when using EAS Build.
Edit this page
The default file format used when building Android apps with EAS Build is an Android App Bundle (AAB/.aab). This format is optimized for distribution to the Google Play Store. However, AABs can't be installed directly on your device. To install a build directly to your Android device or emulator, you need to build an Android Package (APK/.apk) instead.
To generate an .apk, modify the eas.json by adding one of the following properties in a build profile:
developmentClient
to true
(default)distribution
to internal
android.buildType
to apk
android.gradleCommand
to :app:assembleRelease
, :app:assembleDebug
or any other gradle command that produces .apk{
"build": {
"preview": {
"android": {
"buildType": "apk"
}
},
"preview2": {
"android": {
"gradleCommand": ":app:assembleRelease"
}
},
"preview3": {
"developmentClient": true
},
"preview4": {
"distribution": "internal"
},
"production": {}
}
}
Now you can run your build with the following command:
-
eas build -p android --profile preview
Remember that you can name the profile whatever you like. We named the profile preview
. However, you can call it local
, emulator
, or whatever makes the most sense for you.
If you haven't installed or run an Android Emulator before, follow the Android Studio emulator guide before proceeding.
Once your build is completed, the CLI will prompt you to automatically download and install it on the Android Emulator. When prompted, press Y to directly install it on the emulator.
In case you have multiple builds, you can also run the eas build:run
command at any time to download a specific build and automatically install it on the Android Emulator:
-
eas build:run -p android
The command also shows a list of available builds of your project. You can select the build to install on the emulator from this list. Each build in the list has a build ID, the time elapsed since the build creation, the build number, the version number, and the git commit information. The list also displays invalid builds if a project has any.
For example, the image below lists the build of a project:
When the build's installation is complete, it will appear on the home screen. If it's a development build, open a terminal window and start the development server by running the command npx expo start
.
Pass the --latest
flag to the eas build:run
command to download and install the latest build on the Android Emulator:
-
eas build:run -p android --latest
eas build
is done.adb
eas build
is done.adb install path/to/the/file.apk
.