Edit

Using Community Native Modules

Community native modules are usually distributed as npm packages. To understand more about npm packages you may find this guide useful.

This document outlines the general steps to 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.

Step 1: Update the solution file

Add the ReactNativeFooCPP project to your solution.

1. Open the solution in Visual Studio 2019
2. Right-click Solution icon in Solution Explorer > Add > Existing Project
3. Select node_modules\react-native-foo\windows\vNext\ReactNativeFooCPP\ReactNativeFooCPP.vcxproj

Step 2: Update the .vcxproj file

Add a reference to ReactNativeFooCpp to your main application project. From Visual Studio 2019:

1. Right-click main application project > Add > Reference...
2. Check ReactNativeFooCpp from Solution Projects

Step 3: Update the pch.h file

Add #include "winrt/ReactNativeFooCPP.h".

Step 4: Register the package

Add PackageProviders().Append(winrt::ReactNativeFooCPP::ReactPackageProvider()); before InitializeComponent();.