This is a new React Native project, bootstrapped using @react-native-community/cli.

Getting Started

Note: Make sure you have completed the React Native - Environment Setup instructions till "Creating a new application" step, before proceeding.

Step 1: Start the Metro Server

First, you will need to start Metro, the JavaScript bundler that ships with React Native.

To start Metro, run the following command from the root of your React Native project:

# using npm
npm start

# OR using Yarn
yarn start

Step 2: Start your Application

Let Metro Bundler run in its own terminal. Open a new terminal from the root of your React Native project. Run the following command to start your Android or iOS app:

For Android

# using npm
npm run android

# OR using Yarn
yarn android

For iOS

# using npm
npm run ios

# OR using Yarn
yarn ios

If everything is set up correctly, you should see your new app running in your Android Emulator or iOS Simulator shortly provided you have set up your emulator/simulator correctly.

This is one way to run your app — you can also run it directly from within Android Studio and Xcode respectively.

Build APK

First Disable Metro Bundler

By default, React Native apps built in debug mode expect the Metro Bundler to be running. To avoid this requirement (because we want the APK to run independently), you need to make a small change:

Open the MainApplication.java file in your Android project, located at: android/app/src/main/java/com/yourprojectname/MainApplication.java

Inside MainApplication.java, look for the following line:

public boolean getUseDeveloperSupport() {
    return BuildConfig.DEBUG;
}

Replace it with:

public boolean getUseDeveloperSupport() {
    return false;  // Disable developer support to avoid requiring Metro bundler
}

Step 1: Clean the project (optional but recommended):

./gradlew clean

Step 2: Bundle the latest JavaScript

npx react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/app/src/main/assets/index.android.bundle --assets-dest android/app/src/main/res/

Step 3: build the APK

# debug APK
./gradlew assembleDebug
# OR for release:
./gradlew assembleRelease

Step 4: Install the APK on your device

adb install android/app/build/outputs/apk/debug/app-debug.apk

Now what?

• If you want to add this new React Native code to an existing application, check out the Integration guide.
• If you're curious to learn more about React Native, check out the Introduction to React Native.

Troubleshooting

If you can't get this to work, see the Troubleshooting page.

Learn More

To learn more about React Native, take a look at the following resources:

• React Native Website - learn more about React Native.
• Getting Started - an overview of React Native and how setup your environment.
• Learn the Basics - a guided tour of the React Native basics.
• Blog - read the latest official React Native Blog posts.
• @facebook/react-native - the Open Source; GitHub repository for React Native.