WiX Toolset
This repository contains the WiX Toolset codebase.
Developing WiX
Prerequisites
- Visual Studio 2022 (17.0.4 or higher) with the following installed:
| Workloads |
|---|
| ASP.NET and web development |
| .NET desktop development |
| Desktop development with C++ |
| Individual components |
|---|
| .NET Framework 4.7.2 SDK |
| .NET Framework 4.7.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 build tools (Latest) |
| MSVC v143 - VS 2022 C++ x64/x86 build tools (Latest) |
- Download the latest nuget.exe command-line tool 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(ordevbuild releaseif 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.