WiX Toolset [![latest version](https://img.shields.io/nuget/vpre/wix)](https://www.nuget.org/packages/wix) [![download count](https://img.shields.io/nuget/dt/wix)](https://www.nuget.org/stats/packages/WiX?groupby=Version) [![build status](https://img.shields.io/github/actions/workflow/status/wixtoolset/wix/build.yml?branch=develop)](https://github.com/wixtoolset/wix/actions/workflows/build.yml?query=branch%3Adevelop) # WiX Toolset This repository contains the WiX Toolset codebase. # Developing WiX ## Prerequisites - A command line Git client that is in the system path - Visual Studio 2022 (17.8.2 or higher) with the following installed: | Workloads | | :-------- | | ASP.NET and web development | | .NET desktop development | | Desktop development with C++ | | Individual components | | :-------------------- | | .NET 6.0 Runtime (Long Term Support) | | .NET Framework 4.7.2 SDK | | .NET Framework 4.7.2 targeting pack | | .NET Framework 4.6.2 targeting pack | | MSVC v141 - VS 2017 C++ ARM64 build tools (v14.16) | | MSVC v141 - VS 2017 C++ x64/x86 build tools (v14.16) | | MSVC v143 - VS 2022 C++ ARM64/ARM64EC build tools (Latest) | | MSVC v143 - VS 2022 C++ x64/x86 build tools (Latest) | | Git for Windows | - [Download the latest nuget.exe command-line tool](https://www.nuget.org/downloads) and put it in a directory on the path. ##### Getting started: * Fork the WiX repository (https://github.com/wixtoolset/wix.git) into a GitHub domain that you control * Clone the WiX repository from your fork (git clone https://github.com/yourdomain/wix.git) into the directory of your choice ##### To build the WiX toolset: * Start a VS2022 'Developer Command Prompt' * Change directory to the root of the cloned repository * Issue the command `devbuild` (or `devbuild release` if you want to create a release version) ##### Executing your newly built WiX toolset * `build\wix\Debug\publish\wix\wix --help` (Of course changing Debug to Release if you built in Release mode) ##### Pull request expectations * Pick an outstanding WiX issue (or create one). Add a comment requesting that you be assigned to the issue. Wait for confirmation. * To create a PR fork a new branch from the develop branch * Make changes to effect whatever changed behaviour is required for the PR * Push the changes to your repository origin as needed * If there are multiple commits squash them down to one commit. * If the develop branch has changed since you created your new branch rebase to the current development branch. * If needed (ie, you squashed or rebased), do a force push of your branch * Create a PR with your branch against the WiX repository.