blob: f945ad23c1c63e629d6942663304f23de9416d3c (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
|
<img src="https://github.com/wixtoolset/Home/raw/master/imgs/wix-white-bg.png" alt="WiX Toolset" height="128" />
[](https://www.nuget.org/packages/wix)
[](https://www.nuget.org/stats/packages/WiX?groupby=Version)
[](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 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.
|
