This document describes how to set up your development environment and contribute changes to the Microsoft/react-native-windows project. This document assumes basic working knowledge with Git and related tools. We are providing instructions specific to this project.
If you wish to contribute changes back to the Microsoft/react-native-windows repository, start by creating your own fork of the repository. This is essential. This will keep the number of branches on the main repository to a small count. There are lots of developers in this project and creating lots of branches on the main repository does not scale. In your own fork, you can create as many branches as you like.
https://github.com/johndoe/react-native-windows.git
. Notice how your GitHub username is in the repository location.> git clone https://github.com/johndoe/react-native-windows.git
Setting up the upstream repository
Before starting to contribute changes, please setup your upstream repository to the primary Microsoft/react-native-windows repository.
git remote -v
, you should see only your fork in the output list> git remote -v
origin https://github.com/johndoe/react-native-windows.git (fetch)
origin https://github.com/johndoe/react-native-windows.git (push)
> git remote add upstream https://github.com/Microsoft/react-native-windows.git
git remote -v
should show the upstream repository also> git remote -v
origin https://github.com/johndoe/react-native-windows.git (fetch)
origin https://github.com/johndoe/react-native-windows.git (push)
upstream https://github.com/Microsoft/react-native-windows.git (fetch)
upstream https://github.com/Microsoft/react-native-windows.git (push)
Create a branch from your fork and start making the code changes. Once you are happy with the changes and want to merge them to the main Microsoft/react-native-windows project, create a pull request from your branch directly to "Microsoft/react-native-windows main".
Members on the Microsoft/react-native-windows core team will help merge your changes.
Merging upstream main into your fork mainFrom time to time, your fork will get out of sync with the upstream remote. Use the following commands to get the main branch of your fork up up to date.
> git fetch upstream
> git checkout main
> git pull upstream main
> git push
Merging upstream main into your current branch
Use these commands instead if you would like to update your current branch in your fork from the upstream remote.
> git fetch upstream
> git pull upstream main
> git push
For more details on moving changes between your fork and the upstream branch, see this document
Reverting an accidental changeInstructions for how to roll back an unintentional change to one of the upstream branches.
Checkout upstream/0.71-stable and create a new fix71 branch
git checkout upstream/0.71-stable
git switch -c fix71
Revert the unwanted commits (this will prompt to create a separate revert commit for each original commit)
Create new change
Push up branch for PR
Sign off on PR https://github.com/microsoft/react-native-windows/pull/11193
Now, after that PR is in, time to clean up your local 0.71-stable git fetch upstream
git checkout --force 0.71-stable
git merge upstream/0.71-stable
git push -u origin 0.71-stable
Now start over with your backport
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4