react_native_android_application

React Native application for Android.

Description#

Stages a checked-in Android project and invokes its pinned Gradle wrapper through Java. This preserves React Native's New Architecture integration for Codegen, autolinking, CMake, Prefab, and Hermes. The run capability installs the application through the Android Debug Bridge, forwards Metro's port, and launches the application.

Required attributes#

application_id identifies the Android application. Common optional attributes are native_root, module, configuration, architectures, launch_activity, metro_port, node, java, adb, adb_serial, android_sdk, android_ndk, allow_network, gradle_args, apk_path, and exclude_srcs.

Set adb_serial when more than one device is connected. The run capability waits for the selected device, installs the application, forwards Metro's port, and then launches the configured activity or the resolved launcher activity.

The default Gradle output is android/app/build/outputs/apk/<configuration>/app-<configuration>.apk. Set apk_path for product flavors, a differently named module, or an unsigned release package. Generated Gradle build directories are excluded while staging; exclude_srcs adds project-specific exclusions.

The deps edge accepts a React Native dependency set plus optional code generation, autolinking, and release-bundle providers. Non-debug variants stage the JavaScript sources from the matching Android bundle provider before the checked-in Gradle bundling task runs.

Capabilities#

Application installation, port forwarding, and launch are non-cacheable runtime effects.