Community native modules are usually distributed as npm packages. To understand more about npm packages you may find this guide useful.
Consuming native modules requires updating your app's native build files to depend on the module's native build files, called "linking". Many modules support "autolinking", where these updates are done automatically when running
npx react-native run-windows. Others may require you to link the module manually.
This document outlines the general steps to manually link a module (
react-native-foo) to your project.
Not all community modules have been updated to work with Windows. If you find a module that doesn't work with Windows, please file an issue on GitHub. We're tracking the list of incompatible modules that we're working to add support for on GitHub.
Note that individual modules may have different or specific steps for linking to Windows. The steps outlined in this doc are useful if the module repo doesn't outline how to use the module on Windows.
For more information on how autolinking works, see Autolinking Native Modules.
Step 1: Update the solution file
ReactNativeFooCPP project to your solution.
- Open the solution in Visual Studio 2019
- Right-click Solution icon in Solution Explorer > Add > Existing Project
Step 2: Update the .vcxproj file
Add a reference to
ReactNativeFooCpp to your main application project. From Visual Studio 2019:
- Right-click main application project > Add > Reference...
ReactNativeFooCppfrom Solution Projects
Step 3: Update the
Step 4: Register the package