System Requirements
You can run React-Native for Windows apps only on Windows 10 devices with Windows version: 10.0.16299.0 or higher (aka 1709, aka Redstone 3, aka Fall Creators Update). Some features may not work on all versions. See Windows 10 Compatibility for version support details.
To develop React-Native for Windows apps, you will need the following:
Windows Development Dependencies
- Ensure Developer Mode is turned ON in Windows Settings App.
- Install Visual Studio 2019 with the following options:
- Workloads
- Universal Windows Platform development
- Enable the optional
C++ (v141) Universal Windows Platform tools
- Enable the optional
- Desktop development with C++
- Universal Windows Platform development
- Individual Components
- Compilers, build tools and runtimes
MSVC v141 - VS 2017 C++ x64/x86 build tools (v14.16)
MSVC v141 - VS 2017 C++ ARM build tools (v14.16)
- Development activities
- Node.js development support (optional)
- Compilers, build tools and runtimes
- Workloads
React Native Development Dependencies
Install the standard React Native dependencies
Install Node.js via one of the following methods:
- Using Chocolatey (React Native recommended). To use chocolatey, from an elevated Command Prompt, run:
choco install nodejs.install --version=12.9.1
- Directly from Node.js
- By selecting the "Node.js development support" component in the Visual Studio 2019 installer (above)
For both of the non-chocolatey installations, ensure that you are installing version 12.9.1 as that is the recommended version when building React Native Windows apps.
Install Chrome (optional, but needed for JS debugging)
Install Yarn (optional if only consuming react-native-windows, but required to contribute to react-native-windows)
E2E Test
Please refer to Author and Run E2E Test for React Native Windows
Troubleshooting
- If after running the app, the packager does not update (or) app does not show React Native content - close the packager command prompt window and the app, make sure browser is open, run
yarn start
and run the app from Visual Studio again. - If you get a red error box in your UWP app window with the error message :
ERROR: Instance failed to start. A connection with the server cannot be established
, make sure you have the packager running usingyarn start
and run the app again.