Skip to main content

Generate Debug and Release APK for React Native App

Β· 4 min read
Tech Fiddle
Rudra Sen


What is an .apk file?

An Android Package Kit APK is the package file format used by the Android Operating System for ~Distribution~ and Installation of Mobile Apps. It is similar to the .exe file you have on Windows Operating System, a .apk file is for Android.

Do You Know Why I Cut The ~Distribution~ Word?

I Cut that Because As Per New Google Play Guidelines, The New Format to Distribute Apps on the Play Store is an AAB File. I will Write a Blog Post on How to Generate AAB for RN (React Native App) Soon.

Debug APK​

What can I use it for?​

A debug .apk file will allow you to install and test your app before publishing to app stores. Mind you, this is not yet ready for publishing, and there are quite a few things you’ll need to do to before you can publish. Nevertheless, it’ll be useful for initial distribution and testing. You’ll need to enable debugging options on your phone to run this type of apk.


  • react-native version > 0.58

How to generate one in 3 steps?​

  • Go to the root of the project in the terminal and run the below command:
react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/app/src/main/assets/ --assets-dest android/app/src/main/res
  • Go to android directory:
cd android
  • Now in this android folder, run this command
./gradlew assembleDebug
  • There! you’ll find the apk file in the following path:


Release APK​

Generate a keystore​

You will need a Java generated signing key which is a keystore file used to generate a React Native executable binary for Android. You can create one using the keytool in the Terminal with the following command:

keytool -genkey -v -keystore your_key_name.keystore -alias your_key_alias -keyalg RSA -keysize 2048 -validity 10000

Once you run the keytool utility, you’ll be prompted to type in a password.


Make sure you Remember the Password!

You can change your_key_name with any name you want, as well as your_key_alias. This key uses key-size 2048, instead of default 1024 for Security Reasons.

Adding Keystore to your project​

Firstly, you need to copy the file your_key_name.keystore and paste it under the android/app directory in your React Native project folder. On Terminal:

mv my-release-key.keystore /android/app

You need to open your android\app\build.gradle file and add the keystore configuration. There are two ways of configuring the project with keystore. First, the common and unsecured way:

android {
signingConfigs {
release {
storeFile file('your_key_name.keystore')
storePassword 'your_key_store_password'
keyAlias 'your_key_alias'
keyPassword 'your_key_file_alias_password'
buildTypes {
release {
signingConfig signingConfigs.release

This is not a good security practice since you store the password in plain text. Instead of storing your keystore password in .gradle file, you can stipulate the build process to prompt you for these passwords if you are building from the command line. To prompt for password with the Gradle build file, change the above config as:

signingConfigs {
release {
storeFile file('your_key_name.keystore')
storePassword System.console().readLine("\nKeystore password:")
keyAlias System.console().readLine("\nAlias: ")
keyPassword System.console().readLine("\Alias password: ")
react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/app/src/main/assets/
--assets-dest android/app/src/main/res/

Release APK Generation​

Place your Terminal Working Directory to android and Build The APK File:

cd android && gradlew assembleRelease

As a result, the APK creation process is done. You can find the generated APK at android/app/build/outputs/apk/app-release.apk. This is the actual app, which you can send to your phone to install on it, but you need an AAB File to Publish Your App to the Google Play Store.

πŸŽ‰ Congratulations, you’ve just generated a React Native Release Build APK for Android.



Subscribe to our YouTube Channel: