# @react-native-community/cli-platform-android

> This package is part of the [React Native CLI](../../README.md). It contains commands for managing the Android part of React Native app.

Latest version **20.2.0** (published 2026-06-25) · MIT license · 0 weekly downloads

## Install

```sh
npm install @react-native-community/cli-platform-android
pnpm add @react-native-community/cli-platform-android
yarn add @react-native-community/cli-platform-android
bun add @react-native-community/cli-platform-android
```

## Health

**Score 60/100 (C)** — status: active.

Positive: has types; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 20.2.0 |
| Published | 2026-06-25 |
| First published | 2019-04-06 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 5 |
| Unpacked size | 140.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2935 |
| Maintainers | bartoszklonowski, titozzz, empyrical, cpojer, mattoakes, ferrannp, mike866, krizzu, trensik, thymikee, nicholaslee119, mmazzarolo, rewieer, janicduplessis, swaagie, kelset, johandutoit, vonovak, wojteg1337, naturalclar, connectdotz, pvinis, brentvatne, evanbacon, eliwhite, simek, alloy, cortinico, safaiyeh, dmitryrykun, lunaleaps, wootwootwoot, react-native-bot, szymonrybczak, react-native-community-bot, okwasniewski |

## Links

- npm: https://www.npmjs.com/package/@react-native-community/cli-platform-android
- Repository: https://github.com/react-native-community/cli
- Homepage: https://github.com/react-native-community/cli/tree/main/packages/cli-platform-android
- Issues: https://github.com/react-native-community/cli/issues
- npm.io page: https://npm.io/package/@react-native-community/cli-platform-android

## Dependencies (5)

- [execa](https://npm.io/package/execa.md) ^5.0.0
- [logkitty](https://npm.io/package/logkitty.md) ^0.7.1
- [picocolors](https://npm.io/package/picocolors.md) ^1.1.1
- [@react-native-community/cli-tools](https://npm.io/package/@react-native-community/cli-tools.md) 20.2.0
- [@react-native-community/cli-config-android](https://npm.io/package/@react-native-community/cli-config-android.md) 20.2.0

## Recent versions

- 20.2.0 (latest) — 2026-06-25
- 17.0.1 (17.x) — 2025-11-05
- 18.0.1 (18.x) — 2025-11-05
- 19.1.2 (19.x) — 2025-11-05
- 20.0.0-alpha.2 (next) — 2025-07-24
- 16.0.3 (16.x) — 2025-04-17
- 14.1.2 (14.x) — 2024-12-12
- 12.3.7 (12.x) — 2024-06-05
- 11.4.1 (11.x) — 2024-02-19
- 9.3.4 (9.x) — 2023-07-17
- 6.3.1 (7.x) — 2022-07-18
- 7.0.1 (v7.0.1) — 2022-02-01
- 20.1.3 — 2026-03-24
- 20.1.2 — 2026-02-24
- 20.1.1 — 2026-01-28
- … 230 more at https://npm.io/package/@react-native-community/cli-platform-android/versions

## README

# @react-native-community/cli-platform-android

This package is part of the [React Native CLI](../../README.md). It contains commands for managing the Android part of React Native app.

## Installation

```sh
yarn add @react-native-community/cli-platform-android
```

## Commands

### `run-android`

Usage:

```sh
npx react-native run-android [options]
```

Builds your app and starts it on a connected Android emulator or device.

#### Options

#### `--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.

#### `--main-activity <string>`

> default: 'MainActivity'

Name of the activity to start.

#### `--device <string>`

Explicitly set the device to use by name. The value is not required if you have a single device connected.

#### `--deviceId <string>`

> **DEPRECATED** - use `--device <string>` instead

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

#### `--no-packager`

Do not launch packager while building.

#### `--port <number>`

> default: process.env.RCT_METRO_PORT || 8081

#### `--terminal <string>`

> default: process.env.REACT_TERMINAL || process.env.TERM_PROGRAM

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

#### `--tasks <list>`

> default: 'installDebug'

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

#### `--active-arch-only`

> default: false

Build native libraries only for the current device architecture for debug builds.

#### `--list-devices`

> default: false

List all available Android devices and simulators and let you choose one to run the app.

#### `--interactive`, `-i`

Manually select a task and device/simulator you want to run your app on.

> [!WARNING]  
> This flag is running `./gradlew tasks` under the hood, which might take some time for more complex apps. If that affects your project, consider using `--mode` and `--deviceId` flags instead.

### `build-android`

Usage:

```sh
npx react-native build-android [options]
```

Builds Android app.

#### Options

#### `--mode <string>`

> default: debug

Mode to build the app. Either 'debug' (default) or 'release'.

#### `--extra-params <string>`

Custom params that will be passed to gradle build command.
Example:

```sh
npx react-native build-android --extra-params "-x lint -x test"
```

#### `--binary-path <path>`

Installs passed binary instead of building a fresh one. This command is not compatible with `--tasks`.

#### `--user` <number | string>

Id of the User Profile you want to install the app on.

### `log-android`

Usage:

```sh
npx react-native log-android
```

Starts [`logkitty`](https://github.com/zamotany/logkitty) displaying pretty Android logs.

---
_Source: https://npm.io/package/@react-native-community/cli-platform-android · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
