Developer guidance

Prerequisites

• Windows 10 1809 (17763) or later

• Developer Mode enabled

• Visual Studio 2022

  • Or use WinGet to install it ;) (although you may need to adjust the workloads via Tools->Get Tools and Features...)

• The following workloads:

  • .NET Desktop Development
  • Desktop Development with C++
  • Universal Windows Platform Development
  • Check .vsconfig file for full components list

• Windows SDK for Windows 11 (10.0.26100)

[!NOTE] You can also get it through winget install Microsoft.WindowsSDK.10.0.26100 or via Visual Studio > Get Tools and Features > Individual Components > Windows 10 SDK (10.0.26100.0)

• The following extensions:

  • Microsoft Visual Studio Installer Projects

Building the client

1. Clone the repository
2. Configure your system using the configuration file in the repository. Run one of the following configurations from the project root so relative paths resolve correctly:
   • For VS Community: winget configure .config/configuration.winget
   • For VS Professional: winget configure .config/configuration.vsProfessional.winget
   • For VS Enterprise: winget configure .config/configuration.vsEnterprise.winget
3. Run vcpkg integrate install from the Developer Command Prompt / Developer PowerShell for VS 2022. This is a one-time setup step until the configuration file in step 2 is updated to work with vcpkg setup.

Open winget-cli\src\AppInstallerCLI.sln in Visual Studio and build. We currently only build using the solution; command-line methods of building a VS solution should work as well.

Running and Debugging

After the build finishes, deploy the solution from Build > Deploy Solution. You can then run the client from the command line using wingetdev.

To enable step-through debugging, right click on AppInstallerCLIPackage in the Solution Explorer, select Properties, and navigate to the Debug tab. In the Debugger type selection, change "Application process" and "Background task process" to "Native Only". This will allow you to add breakpoints and step through the code. The main entry point for the client is in src/AppInstallerCLI/main.cpp

The best way to debug the client is to select Do not launch, but debug my code when it starts in the Debug tab and start the debugging session with <kbd>F5</kbd>. You can then use the wingetdev command in a terminal session, or any PowerShell code for COM API interaction, which will get picked up by the debugger.

Running Unit Tests

The unit tests are located inside the AppInstallerCLITests project. When the solution is built, all tests are compiled under src/<ARCHITECTURE>/<Debug|Release>/AppInstallerCLITests. An executable AppInstallerCLITests.exe is generated in this directory to run the tests. Run AppInstallerCLITests.exe from the command line to execute the tests. To see all available options, run AppInstallerCLITests.exe --help.

[!TIP] If you just want to run a particular test, you can specify the test name as an argument to the executable. For example, AppInstallerCLITests.exe EnsureSortedErrorList.