react-native-permissions/windows/README.md

An unified permissions API for React Native on iOS, Android and Windows

# react-native-permissions Windows Implementation

## Module Installation

You can either use autolinking on react-native-windows 0.63 and later or manually link the module on earlier realeases.

## Automatic install with autolinking on RNW >= 0.63

RNPermissions supports autolinking. Just call: `npm i react-native-permissions --save`

## Manual installation on RNW >= 0.62

1. `npm install react-native-permissions --save`
2. Open your solution in Visual Studio 2019 (eg. `windows\yourapp.sln`)
3. Right-click Solution icon in Solution Explorer > Add > Existing Project...
4. Add `node_modules\react-native-permissions\windows\RNPermissions\RNPermissions.vcxproj`
5. Right-click main application project > Add > Reference...
6. Select `RNPermissions` in Solution Projects
7. In app `pch.h` add `#include "winrt/RNPermissions.h"`
8. In `App.cpp` add `PackageProviders().Append(winrt::RNPermissions::ReactPackageProvider());` before `InitializeComponent();`

## Module development

If you want to contribute to this module Windows implementation, first you must install the [Windows Development Dependencies](https://aka.ms/rnw-deps).

You must temporarily install the `react-native-windows` package. Versions of `react-native-windows` and `react-native` must match, e.g. if the module uses `react-native@0.62`, install `npm i react-native-windows@^0.62 --dev`.

Now, you will be able to open corresponding `RNPermissions...sln` file, e.g. `RNPermissions62.sln` for `react-native-windows@0.62`.