2.6 KiB
2.6 KiB
Contributing
When contributing to this repository, please first discuss the change you wish to make via issue, email, or any other method with the owners of this repository before making a change.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
Pull Request Process
Initial setup
- Fork repository and create your feature branch out of main.
- Run
yarn
in the repo root to install NPM dependencies. - Open the example solution in Visual Studio.
- In the Solution Explorer, right-click on
Solution 'example'
and selectRestore NuGet Packages
.
Build and run Codegen
- In the Solution Explorer, right-click on the
Codegen
project and selectSet as Startup Project
. - Build the Codegen project (
Build > Build Codegen
). Once completed, you are ready to run the project, see output, and make your desired changes. - Run the Codegen project (
Debug > Start Debugging
).
Make and verify your Codegen changes
If you make changes to the Codegen project, be sure to build and re-run the Codegen.
- If you make changes in a .tt file in Visual Studio, all you need to do is save the file and that will generate corresponding .cs file that reflects your change.
- Run the Codegen steps above in Visual Studio to verify your changes to the output files.
Make and verify your ReactNativeXaml changes
If you make changes to the ReactNativeXaml project, or to the Codegen output files (above), make sure that the ReactNativeXaml project still builds.
- Make sure the example.sln is loaded in Visual Studio, see Initial setup
- Set the Solution Configuration to
Debug
orRelease
. - Set the Solution Platforms to
x86
orx64
(notAnyCPU
). - Run
Build > Build Solution
.
Make and verify your TS changes
If you make changes to the package TypeScript files, be sure to build them.
- Run
yarn build
from the repo root.
Prepare and submit a PR
- Once changes are ready, run
yarn change
at the root of the repository to create a patch (it will ask for a description of the change). The version scheme we use is SemVer - Open a pull request and address review feedback.
Technical details
You can find more details to setting up in the Technical Guide.