Home

Awesome

React Native Tools

Build Status

Stable: Visual Studio Marketplace Version Visual Studio Marketplace Rating (Stars)

Preview: Visual Studio Marketplace Version Visual Studio Marketplace Rating (Stars)

React Native Tools Preview

The extension has a nightly version which is released on a daily basis at 9 PM PST on each day that changes occur. To avoid conflicts, if both extensions are installed - only stable version will be activated. So to use the preview version it is needed to disable or remove the stable version and reload VS Code.

About the extension

This VS Code extension provides a development environment for React Native and Expo projects. Using this extension, you can debug your code and quickly run react-native or expo commands from the command palette.

React Native features

<!-- TABLE OF CONTENTS -->

Table of Contents

Getting started

Before going any further make sure that you:

Please notice that the extension uses .vscode/.react directory at the project root to store intermediate files required for debugging. Although these files usually get removed after debug session ends, you may want to add this directory to your project's .gitignore file.

React Native commands in the Command Palette

In the Command Palette, type React Native and choose a command.

React Native commands

The Run Android command triggers react-native run-android and starts your app for Android.

The Run iOS command similarly triggers react-native run-ios and starts your app in the iOS simulator (e.g. iPhone 6).

The Packager commands allow you to start/stop the Metro Bundler (formerly React Packager).

The full list of commands is:

NameCommand IDDescription
Launch Android EmulatorreactNative.launchAndroidSimulatorPrompts you to select the name of the available Android emulator and launch it. If only one emulator is installed in the system, it will be selected automatically
Launch iOS SimulatorreactNative.launchIOSSimulatorPrompts you to select the available system version of the iOS simulator, then select the simulator name for the selected system and launch it. If only one simulator is installed in the system, it will be selected automatically
Launch ExpoWebreactNative.launchExpoWebCheck if the current project is an Expo project. If so, lanuch ExpoWeb.
Run Android on EmulatorreactNative.runAndroidSimulatorRun an Android application on Emulator. Launch order: check target platform support, load run arguments, start Packager, run app on the selected emulator. Make sure the emulator utility is added to PATH
Run Android on DevicereactNative.runAndroidDeviceRun an Android application on Device. Launch order: check target platform support, load run arguments, start Packager, run app in all connected devices
Run iOS on SimulatorreactNative.runIosSimulatorRun an iOS application on Simulator. Launch order: load run arguments, check target platform support, start Packager, run app in only one connected emulator
Run iOS on DevicereactNative.runIosDeviceRun an iOS application on Device. Launch order: load run arguments, check target platform support, start Packager, run app in only one connected device
Run ExporeactNative.runExponentRun an Exponent application. Launch order: login to exponent, load run arguments, start Packager, run app
Run WindowsreactNative.runWindowsRun a RNW application. Launch order: check target platform support, load run arguments, start Packager, run app
Run MacOSreactNative.runMacOSRun a RNmacOS application. Launch order: check target platform support, load run arguments, start Packager, run app
Start PackagerreactNative.startPackagerStart Packager in context project workspace folder
Stop PackagerreactNative.stopPackagerStop Packager
Restart PackagerreactNative.restartPackagerRestart Packager and clear the Packager's cache
Publish To ExporeactNative.publishToExpHostPublish to Exponent Host. Launch order: login to exponent, execute Run Expo command, then publish app to host
Show Dev MenureactNative.showDevMenuShow development menu for running aplication on iOS or Android device or emulator
ReloadAppreactNative.reloadAppReload an application
Run Element InspectorreactNative.runInspectorLoad development tools for inspect application UI elements
Stop Element InspectorreactNative.stopInspectorStop development tools for inspect application UI elements
Run React Native LogCat MonitorreactNative.startLogCatMonitorCreates a LogCat Monitor for the chosen online Android device to see the device LogCat logs. Default filtering arguments: ["*:S", "ReactNative:V", "ReactNativeJS:V"]. How to configure filtering.
Stop React Native LogCat MonitorreactNative.stopLogCatMonitorStops an existing LogCat Monitor and removes its output channel
Run Network InspectorreactNative.startNetworkInspectorRun Network inspector
Stop Network InspectorreactNative.stopNetworkInspectorStop Network inspector
Check development environment configurationreactNative.testDevEnvironmentChecks your development environment for common problems
Open the eas project in a web pagereactNative.openEASProjectInWebPageOpen EAS build in your EAS project portal
Open react native upgrade helper in web pagereactNative.openRNUpgradeHelperOpen an official project upgrade tools in browser, support RN, RN for Windows, RN for MacOS
Revert extension input in open package modulereactNative.revertOpenModuleQuickly revert some codes in Open Module which are changed by react-native-tools
Run doctorreactNative.docterExecute react-native doctor to check basic environemt for react-native development
Run expo doctorreactNative.ExpoDocterExecute expo docter to check basic environemt for Expo development
Expo prebuildreactNative.expoPrebuildCreate the android and ios directories for running your React code
Expo prebuild cleanupreactNative.expoPrebuildCleanClean directories generated by prebuild
Reopen QR Code in ExporeactNative.reopenQRCodeReopen expo generated QR code in webview

Using commands in VS Code tasks

To run React Native Tools commands via VS Code tasks, you can create a .vscode/tasks.json file in your project and add tasks configurations the following way:

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Run Android on Emulator",
      "command": "${command:reactNative.runAndroidSimulator}",
      "problemMatcher": []
    }
  ]
}

Customize metro configuration

Metro is a JavaScript bundler for React Native and include in React Native package. Metro configuration can be customized in metro.config.js.

Debugging React Native applications

To debug react-native application:

  1. Create launch.json file in .vscode folder.
  2. Click on Add Configuration button and choose React Native option.
  3. Select any scenario needed in dropdown list.

Add React Native debug configuration

  1. Choose the appropriate configuration in the Configuration dropdown, and then press F5 (or click Green Arrow Configure-gear button) to start debugging your app in VS Code.

React Native launch targets

Optional: The extension also allows to start debugging without creating the launch.json file in one of the following ways:

The extension allows you to debug multiple devices and configurations, please read the following sections for more information for your particular use case.

Hermes engine and direct debugging (Recommended)

React-native set Hermes as default engine from 0.70. Please see official documentation to get details.

The Hermes engine is an open source JavaScript engine created by Facebook to optimize building and running React Native applications. It improves app performance and decreases app size.

Click here to learn more about Hermes and how to enable it for your application. To turn off Hermes, you can do the same changes in documentation but set Hermes Flag to False.

Attach to Hermes application

To attach to a running Hermes application use Attach to Hermes application launch configuration:

{
  "name": "Attach to Hermes application",
  "cwd": "${workspaceFolder}",
  "type": "reactnativedirect",
  "request": "attach"
}

Android applications

Android Hermes debugging

To debug while using Hermes engine use Debug Android Hermes launch configuration:

{
  "name": "Debug Android Hermes",
  "cwd": "${workspaceFolder}",
  "type": "reactnativedirect",
  "request": "launch",
  "platform": "android"
}

Custom build for Android apps

If you want to use a custom applicationIdSuffix for your application to launch specific build, you can either pass it as part of the runArguments parameter arguments as shown below:

"runArguments": ["--appIdSuffix", "customAppIdSuffix", ...]
// or
"runArguments": ["--appIdSuffix=customAppIdSuffix", ...]

iOS applications

iOS Hermes debugging

To debug your iOS Hermes application, you can use Debug iOS Hermes launch configuration to debug an iOS Hermes application:

{
  "name": "Debug iOS Hermes",
  "cwd": "${workspaceFolder}",
  "type": "reactnativedirect",
  "request": "launch",
  "platform": "ios"
}

iOS devices

Debugging on an iOS device requires following manual steps:

Custom scheme for iOS apps

If you want to use a custom scheme for your application you can either pass it as part of the runArguments parameter arguments as shown below:

"runArguments": ["--scheme", "customScheme", ...]
// or
"runArguments": ["--scheme=customScheme", ...]

Please be aware, specifying the scheme value as a part of the runArguments parameter arguments will override the scheme configuration parameter value, if it set.

iOS direct debugging

The extension provides experimental support of iOS direct debugging. See more info here: react-native-community/discussions-and-proposals#40, react-native-community/discussions-and-proposals#206

For now the extension supports iOS direct debugging only on real iOS devices.

To be able to debug an iOS app directly, you need to install ios-webkit-debug-proxy:

You can use the following debug scenarios to debug iOS apps directly:

    "name": "Debug Direct iOS - Experimental",
    "cwd": "${workspaceFolder}",
    "type": "reactnativedirect",
    "request": "launch",
    "platform": "ios",
    "port": 9221,
    "target": "device"
    "name": "Attach to the React Native iOS - Experimental",
    "cwd": "${workspaceFolder}",
    "type": "reactnativedirect",
    "request": "attach",
    "platform": "ios",
    "port": 9221

Expo applications

Extension also support Expo application debugging scenarios.

To create Expo application, please prepare your environment by following the Expo CLI Quickstart instruction.

You can verify if the environment is ready to use by React Native: Run Expo Doctor in command palette.

Debug on Expo Go

If you're using Expo Go, follow below steps tp start debugging Expo application:

  1. Open your project in VS Code with this extension installed.
  2. Add below configure in launch.json.
{
  "name": "Debug Exponent Hermes",
  "request": "launch",
  "type": "reactnativedirect",
  "cwd": "${workspaceFolder}",
  "platform": "exponent",
  "expoHostType": "local"
}
  1. Wait while some dependencies are configured - the extension will install Expo Development Library(xdl) when this feature is used for the first time.
  2. Once the packager starts, the extension will open a separate tab with QR code and app link. You can open app in Expo Go and start debugging. Expo QRCode

Debug on expo-dev-client

If you want to debug Expo app using expo-dev-client, follow below steps to start debugging Expo application:

  1. Open your project in VS Code with this extension installed.
  2. In project folder, install expo-dev-client for your app using npx expo install expo-dev-client.
  3. Create your app in development mode eas build --profile development --platform all, replace --platform all to android or iOS to build specific platform application(need development account for iOS platform).
  4. After build success, download your build and install application to your device or simulator.
  5. In project, using npx expo start --dev-client to start Metro and load application in device or simulator.
  6. Add Attach to application command launch.json, and start debugging.
{
  "name": "Attach to Hermes application",
  "request": "attach",
  "type": "reactnativedirect",
  "cwd": "${workspaceFolder}"
}

Debug on Expo Web

Expo support open application in browser, the expo web application is generated by react-native-web. It can help user open application without any Android emulator, iOS simulator or device. React-native-tools supports debugging Expo Web application in Chrome and Edge. Follow below steps to start Expo Web debugging:

  1. Open your project in VS Code with this extension installed.
  2. Check and install related package: react-dom, react-native-web and @expo/webpack-config (this package is deprecated from Expo 49) by npx expo install command.
  3. Add Expo Web debugging configure in launch.json and start debugging.
{
  "name": "Debug Expo Web - Experimental",
  "request": "launch",
  "type": "reactnativedirect",
  "cwd": "${workspaceFolder}",
  "platform": "expoweb",
  "browserTarget": "chrome",
  "url": "http://localhost:8081"
}

Configuring Expo

The extension supports running through Exponent not just the applications created with Expo but even pure React Native applications (in that case you need to add expo package to node_modules in order to make it work with Expo: npm install expo --save-dev. In either cases it uses app.json configuration file in the root of the project.)

If you are running Debug Exponent Hermes configuration or any of palette commands like Run in Exponent, Publish to Exponent then this file will be created automatically if absent or updated with the following basic configuration section:

{
  "expo": {
    "slug": "MyApp", // Project slug
    "name": "MyApp", // Project name
    "sdkVersion": "31.0.0", // Expo SDK version
    "entryPoint": ".vscode\\exponentIndex.js" // Entrypoint for the project
  },
  "name": "MyApp" // Project name
}

Full list of configuration parameters for expo section in app.json may be found on official Expo documentation page.

For running pure React Native app, the extension, creates and uses .vscode/exponentIndex.js which points to the app entrypoint (index.js or index.android.js or index.ios.js) file.

If you want to change your app entrypoint (for example, from index.js to index.android.js), delete .vscode/exponentIndex.js and then restart your debugging session.

NOTE: The extension caches the version of the exponent SDK used by your project. This is helpful since we don't want to install the SDK each time you run exponent. If you want the extension to update the SDK version based on your React Native version, just restart VS Code and if it is supported it should work. If it does not please open an issue.

Expo Hermes

Expo using Hermes as default engine, you can switch engine on a specific platform using below configure.

{
  "expo": {
    "jsEngine": "hermes",
    "ios": {
      "jsEngine": "jsc"
    }
  }
}

Note: You maybe need to create developer account to run eas build. Any other issue or limitiation, please see expo hermes ducomentation.

React Native for Windows

Please make sure that your development environment is configured properly in accordance with the official system requirements.

And follow the official guide to enable Hermes engine for a Windows application.

Windows Hermes debugging

To debug React Native for Windows applications, you can use below configure in launch.json:

{
  "name": "Debug Windows Hermes",
  "cwd": "${workspaceFolder}",
  "type": "reactnativedirect",
  "request": "launch",
  "platform": "windows"
}

Also you can attach running application using Attach to Hermes application configuration to .vscode/launch.json in your project.

React Native for MacOS

Please make sure that your development environment is configured properly in accordance with the official system requirements.

And follow the official guide to enable Hermes engine for a macOS application.

MacOS Hermes debugging

To debug a macOS Hermes application you can use Debug macOS Hermes debugging scenario:

{
  "name": "Debug macOS Hermes",
  "request": "launch",
  "type": "reactnativedirect",
  "cwd": "${workspaceFolder}",
  "platform": "macos"
}

Also you can attach running application using Attach to Hermes application configuration to .vscode/launch.json in your project.

Debug out of React Native project directory

If your project structure like this:

common
  - utils.ts
app
  - src/
  - metro.config.js

When you import utils.ts in your project. Using

import { commonFunction } from "../../common/utils";

Will get error when start Metro:

error: bundling failed: Error: Unable to resolve module `../../common/utils` from `src/App.js`

To import files in metro.config.js, user can debug code out of react native project.

  1. Add extra module and watch folder for the file parent folder.
const extraNodeModules = {
  common: path.resolve(__dirname + "/../common"),
};
const watchFolders = [path.resolve(__dirname + "/../common")];
  1. Add module and watch folder in metro config.
const config = {
  resolver: {
    extraNodeModules,
  },
  watchFolders,
};
  1. After mapping common key to common/ path, we can include any files inside common/ relative to this path. Metro is started, launching or debugging is working well.
import { commonFunction } from "common/utils";

TypeScript and Haul

Sourcemaps

The debugger uses sourcemaps to let you debug with your original sources, but sometimes the sourcemaps aren't generated properly and overrides are needed. In the config we support sourceMapPathOverrides, a mapping of source paths from the sourcemap, to the locations of these sources on disk. Useful when the sourcemap isn't accurate or can't be fixed in the build process.

The left hand side of the mapping is a pattern that can contain a wildcard, and will be tested against the sourceRoot + sources entry in the source map. If it matches, the source file will be resolved to the path on the right hand side, which should be an absolute path to the source file on disk.

Below there are some examples of how sourcemaps could be resolved in different scenarios:

// webRoot = /Users/me/project
"sourceMapPathOverrides": {
    "webpack:///./~/*": "${webRoot}/node_modules/*",       // Example: "webpack:///./~/querystring/index.js" -> "/Users/me/project/node_modules/querystring/index.js"
    "webpack:///./*":   "${webRoot}/*",                    // Example: "webpack:///./src/app.js" -> "/Users/me/project/src/app.js",
    "webpack:///*":     "*",                               // Example: "webpack:///project/app.ts" -> "/project/app.ts"
    "webpack:///src/*": "${webRoot}/*"                     // Example: "webpack:///src/app.js" -> "/Users/me/project/app.js"
}

Haul debugging

The extension provides functional to attach to Haul packager based applications. You can use the Attach to packager scenario to attach to a Haul based app and debug it. For now launch scenarios aren't supported. You can find more info in the issue.

You can prepare your React Native application to work with Haul by following the Haul Getting started guide.

If you use the legacy version of Haul as your React Native bundler instead of the default Metro, it could be required to add sourceMapPathOverrides to the launch.json file.

For example:

{
  // Other configurations
  "sourceMapPathOverrides": {
    "webpack:///./~/*": "${workspaceRoot}/node_modules/*",
    "webpack:///./*": "${workspaceRoot}/*",
    "webpack:///*": "*"
  }
}

Debugger configuration properties

The following is a list of all the configuration properties the debugger accepts in launch.json:

NameDescriptionTypeDefaults
cwdThe path to the project root folderstring${workspaceFolder}
sourceMapsWhether to use JavaScript source maps to map the generated bundled code back to its original sourcesbooleantrue
sourceMapPathOverridesA set of mappings for rewriting the locations of source files from what the source map says, to their locations on disk. See Sourcemaps for detailsobjectn/a
sourceMapRenamesWhether to use the "names" mapping in sourcemaps. This requires requesting source content, which could slow debuggingbooleanfalse
enableDebugWhether to enable debug mode. If set to "false", an application will be launched without debuggingbooleantrue
webkitRangeMin, webkitRangeMaxCombines to specify the port range that you want the ios-webkit-debug-proxy to use to find the specific device described in the Direct iOS debug configuration9223, 9322
traceLogging level in debugger process. May be useful for diagnostics. If set to "Trace" all debugger process logs will be available in Debug Console output windowstringlog
addressTCP/IP address of packager to attach to for debuggingstringlocalhost
portPort of packager to attach to for debuggingstring8081
remoteRootThe source root of the remote hoststringnull
localRootThe local source root that corresponds to the 'remoteRoot'string${workspaceFolder}
skipFilesAn array of file or folder names, or glob patterns, to skip when debuggingarray[]
debuggerWorkerUrlPathPath to the app debugger worker to override. For example, if debugger tries to attach to http://localhost:8081/debugger-ui/debuggerWorker.js and you get 404 error from packager output then you may want to change debuggerWorkerUrlPath to another value suitable for your packager ("debugger-ui" will be replaced with the value you provide)stringdebugger-ui/
platformThe platform to target. Possible values: android, ios, exponent, windowsstringn/a
targetTarget to run on. Possible values: simulator, device, <iOS target name/udid>, <Android target id>, <Android emulator AVD name>. If the value is simulator or device then the quick pick window will be expanded with the names of the available virtual or physical targets, then, in case there are more than one available target with specified type, the target value in launch.json will be changed to the name or id of the selected target. If you have only one target with specified type available, it will be selected automatically. If you're using Android emulator targets, please, make sure the emulator utility is added to PATHstringsimulator
logCatArgumentsArguments to be used for LogCat (The LogCat output will appear on an Output Channel). It can be an array such as: [":S", "ReactNative:V", "ReactNativeJS:V"]array["*:S", "ReactNative:V", "ReactNativeJS:V"]
runArgumentsRun arguments to be passed to react-native run-<platform> command (override all other configuration params)arrayn/a
launchActivityThe Android activity to be launched for debugging, e.g. it specifies --main-activity parameter in react-native run argumentsstringMainActivity
expoHostTypeThe connection type to be used on Expo debugging to communicate with a device or an emulator. Possible values: <ul><li>tunnel - allows to deploy and debug an application by means of Expo cloud services</li><li>lan - allows to deploy and install an application via your LAN</li><li>local - allows to debug an application on an emulator or an Android device without network connection</li></ul>stringlan
envEnvironment variables passed to the debugger and react-native run-<platform> commandobject{}
envFileAbsolute path to a file containing environment variable definitionsstring${workspaceFolder}/.env
variantA variant to be passed to react-native run-android, e.g. use devDebug to specify --variant=devDebugstringn/a
schemeA scheme name to be passed to react-native run-ios, e.g. devDebug to specify --scheme=devDebugstringn/a
productNameiOS bundle display name e.g. AwesomeProject value means that the extension will search for AwesomeProject.app bundlestringn/a
jsDebugTraceEnable trace collection for depended extension vscode-js-debugbooleann/a

Remote JavaScript Debugging (Deprecated)

Remote JavaScript debugging is deprecated by react-native team from 0.73 and may be removed officially at any time.

We strongly recommend to use Hermes engine and direct debugging in your application.

Below config showed classic debug mode in extension, we may remove it from extension in the future if it's totally removed officially.

{
  "name": "Debug Android",
  "request": "launch",
  "type": "reactnative",
  "cwd": "${workspaceFolder}",
  "platform": "android"
}

Customization

The extension can be further customized for other React Native scenarios. These are the most common:

Debug in vscode workspace

Extension supports vscode multiple root workspace for development. If you have several react-native project in workspace, extension will show project selection list when react-native packager is starting. Also you can add settings in workspace to ignore specific project in selection list.

	"settings": {
		"react-native.workspace.exclude": [
			"ProjectFolderName1",
			"ProjectFolderName2"
		]
	}

Logging

The extension logging is divided by several output channels:

There are also some global extension technical logs that might be exposed to the output. To see them set the following properties in your VS Code Settings:

{
  "react-native-tools": {
    "logLevel": "Trace"
  }
}

logLevel can be None (no logs), Error, Warning, Info, Debug, Trace (all logs). Default is Info.

Build APK and generate bundle

You can add VSCode tasks to build an .apk file and generate iOS/Android bundles.

The following is an example of a tasks.json for react-native init projects. Place it in the .vscode folder in your project to use it:

{
  "version": "2.0.0",
  "presentation": {
    "reveal": "always",
    "panel": "new"
  },
  "tasks": [
    {
      "label": "Build APK Debug",
      "group": "build",
      "type": "shell",
      "windows": {
        "command": "cd android; if($?) {./gradlew assembleDebug}"
      },
      "linux": {
        "command": "cd android && ./gradlew assembleDebug"
      }
    },
    {
      "label": "Build APK Release",
      "group": "build",
      "type": "shell",
      "windows": {
        "command": "cd android; if($?) {./gradlew assembleRelease}"
      },
      "linux": {
        "command": "cd android && ./gradlew assembleRelease"
      }
    },
    {
      "label": "Generate Android Bundle",
      "group": "build",
      "type": "shell",
      "command": "npx react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/main.jsbundle"
    },
    {
      "label": "Generate iOS Bundle",
      "group": "build",
      "type": "shell",
      "command": "npx react-native bundle --platform ios --dev false --entry-file index.js --bundle-output ios/main.jsbundle"
    }
  ]
}

To learn more about tasks in VSCode read the official documentation.

Visit generating Signed APK to learn more about this subject.

Specifying custom arguments for react-native run-* command

Using custom run arguments for react-native run-<platform>: NOTE: This overrides all other configuration parameters.

{
  "react-native.android.runArguments.simulator": [
    "--appFolder",
    "/Users/test/AwesomeProject/android/app",
    "--deviceId",
    "emulator-5555"
  ],
  "react-native.ios.runArguments.device": [
    "--project-path",
    "ios",
    "--device",
    "Max's iPhone"
  ]
}

NOTE: You can get the list of installed simulator devices by:

iOS devices (macOS only):

xcrun simctl list --json devices

Android devices:

adb devices

NOTE: If you want to run the application on an iOS device, make sure you have ios-deploy installed globally.

brew install ios-deploy

Setting up the React Native packager

To use a custom port for the react-native packager:

{
  "react-native": {
    "packager": {
      "port": portNumber
    }
  }
}

If you change this port, then for iOS device and simulator scenarios you will have to modify the native code files. Instructions here.

If you use Android, you need to change the debug server by:

  1. CTRL+M(CMD+M) in the emulator
  2. Go to Dev Settings
  3. Debug server host for device => enter localhost:<yourPortNumber>.
  4. Reload application (press R twice)
  5. (Hermes only) Hermes engine listens port 8081 for debugging by default, to change it you might need to modify your metro.config.js file adding "port": portNumber argument in there to the server settings.
// Example of metro.config.js (<= 0.72.0)
module.exports = {
  server: {
    port: 9091,
  },
};

OR

// Example of metro.config.js (0.72.0)
const config = {
  server: {
    port: 9091,
  },
};
<details> <summary>Port setup instruction</summary>

image

image

image

</details>

NOTE: Some aspects of React Native hard-code the port to the default as specified in this issue.

Custom environment variables

Extension supports passing custom environment variables to the React Native Packager process context. To add custom variables you can create .env file in the root folder of your project and add needed environment variables in the following format:


Variable1_name=Variable1_value
Variable2_name=Variable2_value

Variables that are declared in this .env file can override the original environment variables from process.env of the Packager process.

It is possible to transfer environment variables (via env and envFile arguments in launch.json) from the launch or attach debug scenarios to the Packager. If these variables are defined, then they will be used, otherwise the .env file is used.

Change project root

To specify a subfolder in which the react-native project is located, set react-native-tools.projectRoot. You can use either an absolute or relative path in your VS Code Settings:

{
  "react-native-tools": {
    "projectRoot": "./your/react-native/project"
  }
}

Configure an Android LogCat Monitor

There are two ways to filter your LogCat Monitor output depending on how LogCat Monitor was launched:

  1. Since LogCat Monitor is launched for all Android launch scenarios by default, you can add logCatArguments to your debug scenario in launch.json file like in the following example:
{
  "name": "Debug Android Hermes",
  "cwd": "${workspaceFolder}",
  "type": "reactnativedirect",
  "request": "launch",
  "platform": "android",
  "logCatArguments": ["ReactNativeJS:V"]
}
  1. If you want to launch LogCat Monitor from the Command Palette command React Native: Run React Native LogCat Monitor with filtering options set react-native.android.logCatArguments settings in your settings.json:
{
  "react-native.android.logCatArguments": [
    "*:S",
    "ReactNative:V",
    "ReactNativeJS:V"
  ]
}

To have better understanding on how LogCat filtering works take into account that the extension launches LogCat with flag -s and then adds user-provided filters as arguments. Please see the official instruction on how does LogCat filtering works.

Configure dependencies versions for debugging Expo projects

To debug Expo applications the extension requires additional dependencies, such as xdl and @expo/metro-config. These packages are installed automatically on the first start of the Expo debugging scenario. You can configure the dependencies versions by adding the react-native.expo.dependencies parameter, which contains packages names and appropriate versions, to the settings.json file:

{
  "react-native.expo.dependencies": {
    "xdl": "59.2.0",
    "@expo/metro-config": "0.2.0",
    "@expo/ngrok": "^4.1.0"
  }
}

To enable new versions of the dependencies, it's required to restart VS Code editor. After that the extension will download the new versions of the packages on the next Expo debugging starting.

Configure custom key bindings for extension commands

The extension provides context variables for the following features:

Context variableFeature
isRNPackagerRunning - true if the packager is runningMetro packager
isRNTNetworkInspectorRunning - true if the Network inspector is runningNetwork inspector

Using these context variables you can assign the same keyboard combination for some pair commands for more convenient use. For example, you can configure the same key bindings for Start Packager and Stop Packager commands using when clauses, as shown below: image

Configure custom colors for extension output logs

The extension provides custom TextMate tokens, with the help of which it is now possible to customize the colors of the logs in output channels:

ScopeDescription
rnt.output.stringSingle and double quoted strings
rnt.output.urlLinks, email and ip address, filepaths
rnt.output.timestampDate and time
rnt.output.numericConstant decimal numbers
rnt.output.processLogs of processes such as npm, bundle, and other build tasks
rnt.output.errorErrors, exceptions, fails and stack for them
rnt.output.warnWarning logs
rnt.output.infoInfo logs
rnt.output.debugDebug logs
rnt.output.verboseVerbose logs
rnt.output.constantSuch values as true, false, null, undefined, NaN
rnt.output.successLogs indicating successful completion of the process, such as BUILD SUCCESSFUL and others

Now you can customize React Native Tools output logs with editor.tokenColorCustomizations parameter in settings.json this way:

"editor.tokenColorCustomizations": {
  "textMateRules": [
    {
      "settings": {
        "foreground": "#c57ca0",
        "fontStyle": "bold",
      },
      "scope": "rnt.output.string"
    }
  ]
}

Element inspector (Deprecated)

In the extension you can run React DevTools Element inspector to inspect the DOM-tree of your application. It's required to install the react-devtools package globally to run React DevTools from the extension.

Note: react-devtools is deprecated from 0.76.

npm install -g react-devtools

Integration with React Native Inspector

You can open the in-app developer menu and choose "Show Element Inspector". It will bring up an overlay that lets you tap on any UI element and see information about it:

Element inspector usage

Using the Run Element Inspector Command Palette command you can launch React DevTools in the extension. Inspector will enter a special collapsed mode, and use the DevTools as primary UI. In this mode, clicking on something in the emulator will bring up the relevant components in the DevTools:

Element inspector usage

Network Inspector

The extension provides Network inspector feature to inspect outgoing network traffic in your apps. You can browse all requests being made and their responses in VS Code DevTools console.

image

Network inspector requirements

Before using the Network inspector, please make sure that your system meets the following requirements:

The Network inspector uses functional of the Flipper plugin integrated to React Native apps. Please make sure that it's enabled in your application. You can use this guide to integate Flipper into your projects.

Network inspector usage

For now the Network inspector doesn't support Expo applications.

Network inspector logs theme

The extension provides “Dark” and “Light” color themes for Network Inspector logs. You can configure the theme in the extension configuration in your VS Code Settings.

{
  "react-native-tools.networkInspector.consoleLogsColorTheme": "Dark"
}

Developing inside a Docker Container

The extension supports VS Code Remote Development features on Linux. Please follow the VS Code official documentation to setup your environment and install related extensions(Remote Development is recommended) to use a remote development approach.

You can use official React Native Docker image provided by the react-native-community.

Here are the steps to run React Native debugging inside a Docker Container on a real Android device:

  1. In the local react-native project, add Dev Container configure folder and files:

    .devcontainer
      -devcontainer.json
      -Dockerfile
    
  2. Сreate Dockerfile extending reactnativecommunity/react-native-android image. For example you can use the following Dockerfile:

    FROM reactnativecommunity/react-native-android:latest
    
    RUN npm install -g expo-cli react-native-cli
    
  3. Configure your devcontainer.json file as needed. Below is a sample configuration:

    {
      "name": "React Native Android Container",
    
      // Sets the run context to one level up instead of the .devcontainer folder.
      "context": "..",
    
      // Update the 'dockerFile' property if you aren't using the standard 'Dockerfile' filename.
      "dockerFile": "Dockerfile",
    
      // The optional 'runArgs' property can be used to specify additional runtime arguments.
      "runArgs": [
        "--privileged", // give all capabilities to a container, in other words, the container can then do almost everything that the host can do
        "--net",
        "host", // forwarding all host machine ports
        "-v",
        "/dev/bus/usb:/dev/bus/usb" // mount connected USB devices to a container
      ],
      "customizations": {
        "vscode": {
          "settings": {
            // This will ignore your local shell user setting for Linux since shells like zsh are typically
            // not in base container images. You can also update this to an specific shell to ensure VS Code
            // uses the right one for terminals and tasks. For example, /bin/bash (or /bin/ash for Alpine).
            "terminal.integrated.shell.linux": null
          },
          // Add the IDs of extensions you want installed when the container is created in the array below.
          "extensions": ["msjsdiag.vscode-react-native"]
        }
      }
    }
    
  4. Open Command Palette and run the following command Dev Containers: Open Folder in Container to reopen your project in a container

  5. Connect your device via USB and start debugging the same way as on local machine.

Currently the above scenario doesn't work on macOS and Windows. Docker Container implementation on these OS uses Virtual Machine tools which may have problems with USB forwarding for mobile devices.

Contributing

Please see our contributing guide for more information.

Known Issues

Here is the list of common known issues you may experience while using the extension:

IssueDescription
Debugger doesn't stop at breakpointsBreakpoints require sourcemaps to be correctly configured. If you are using TypeScript, then make sure to follow the Getting started section for how to ensure sourcemaps are correctly set up. Also, similar issues may occur on React Native version 0.58.* in some special cases (see #928, #907), bumping dependencies versions of react and react-native package to the more recent ones should resolve these. If you are on Linux, make sure that the project folder which is opened is not a symbolic link to the real folder, that might cause problems with sourcemaps (see #1456)
'adb: command not found'If you receive an error adb: command not found, you need to update your system Path to include the location of your ADB executable.The ADB executable file is located in a subdirectory along with your other Android SDK files.
Can't communicate with socket pipe(Linux only) If you have two workspaces open that only differ in casing, the extension will fail to communicate effectively.
"Add configuration" button doesn't work when trying to add debug configuration to launch.jsonYou have to add some json configuration to launch.json manually. Please, see (#985).
Error None of these files exist: * .vscode/exponentIndex appears when running React Native apps via ExpoOn some project configurations (mostly on macOS) there could be problems with running RN app via Expo for the first time. You can resolve this by explicitly adding module.exports.watchFolders = ['.vscode']; to your Metro config. This will help Metro bundler to find the custom entry point generated by the extension needed to work with Expo. For details you can see the issue (#1327).
High CPU load notification while starting debugging Expo appWhen you start debugging the Expo application you may receive the notification "The extension 'React Native Tools' took a very long time to complete its last operation and it has prevented other extensions from running". The issue occurs because of importing the xdl package, which extension uses for debugging Expo applications. The xdl package has the large size and some peculiarities of its structure, so it may cause high CPU load.

Known-Issues provides a complete list of active and resolved issues.

Telemetry reporting

VS Code React Native extension collects usage data and sends it to Microsoft to help improve our products and services. Read our privacy statement to learn more.

If you don’t wish to send usage data to Microsoft, edit VSCodeTelemetrySettings.json file at ~/.vscode-react-native and add optIn:false.

Code of conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.