@nrwl/react-native:run-android

Run Android target options.

Options can be configured in project.json when defining the executor, or when invoking it. Read more about how to configure targets and executors here: https://nx.dev/reference/project-configuration#targets.

project.json:

{
  "name": "mobile",
  //...
  "targets": {
    //...
    "run-android": {
      "executor": "@nrwl/react-native:run-android",
      "options": {}
    }
  }
}

nx run mobile:run-android

Examples

To see all the avaiable emulators, run command:

emulator -list-avds

The deviceId option allows you to launch your android app in a specific device/simulator:

    "run-android": {
      "executor": "@nrwl/react-native:run-android",
      "options": {
        "deviceId": "Pixel_5_API_30"
      }
    }

Options playground

Try out this interactive editor of the configuration object. Values are validated as you type and hovering over labels will give you more information.

Examples

These buttons show the config object for specific common tasks.

Options

variant

string

Default: debug

Specify your app's build variant (e.g. debug, release).

appId

string

Specify an applicationId to launch after build. If not specified, package from AndroidManifest.xml will be used.

appIdSuffix

string

Specify an applicationIdSuffix to launch after build.

activeArchOnly

boolean

Default: false

Builds only for the active architecture (e.g. x86_64, arm64-v8a).

deviceId

string

Builds your app and starts it on a specific device/simulator with the given device id (listed by running adb devices on the command line).

interactive

boolean

Default: true

Run packager server in interactive mode.

jetifier

boolean

Default: true

Run Jetifier – the AndroidX transition tool. By default it runs before Gradle to ease working with libraries that don't support AndroidX yet.

mainActivity

string

Default: MainActivity

Name of the activity to start.

port

number

Default: 8081

The port where the packager server is listening on.

packager

boolean

Default: true

Starts the packager server.

resetCache

boolean

Default: false

Resets metro cache.

sync

boolean

Default: true

Syncs npm dependencies to package.json (for React Native autolink).

tasks

string

Run custom Gradle tasks. If this argument is provided, then --variant option is ignored. Example: yarn react-native run-android --tasks clean,installDebug.

terminal

string

Launches the Metro Bundler in a new window using the specified terminal path.