Skip to content

A GitHub Action to facilitate configuring MSBuild in the workflow PATH for building .NET Framework applications.

License

Notifications You must be signed in to change notification settings

elprans/gha-setup-vcpp-build-tools

 
 

Repository files navigation

elprans/gha-setup-vcpp-build-tools

This is a fork of microsoft/setup-msbuild, which actually sets up the full developer command prompt environment instead of just adding msbuild to the PATH.


You know how handy that 'Visual Studio Developer Command Prompt' is on your local machine? And how it adds several things to PATH to allow you to just issue commands like msbuild or otherwise? Use this action to setup similar flexibility in your Windows-based GitHub Actions runners. This will let you discover where those tool paths are and automatically add them to the PATH environment variables for you so future steps in your Actions workflow can just initiate commands without knowing the full path.

Usage

- name: Set up VC tools environment
  uses: elprans/gha-setup-vcpp-build-tools@v1

Specifying specific versions of Visual Studio

You may have a situation where your Actions runner has multiple versions of Visual Studio and you need to find a specific version of the tool. Simply add the vs-version input to specify the range of versions to find. If looking for a specific version, specify the minimum and maximum versions as shown in the example below, which will look for just 16.4.

- name: Set up VC tools environment
  uses: elprans/gha-setup-vcpp-build-tools@v1
  with:
    vs-version: '[16.4,16.5)'

The syntax is the same used for Visual Studio extensions, where square brackets like "[" mean inclusive, and parenthesis like "(" mean exclusive. A comma is always required, but eliding the minimum version looks for all older versions and eliding the maximum version looks for all newer versions. See the vswhere wiki for more details.

How does this work?

This makes use of the vswhere tool which is a tool delivered by Microsoft to help in identifying Visual Studio installs and various components. This tool is installed on the hosted Windows runners for GitHub Actions. If you are using a self-hosted runner, you either need to make sure vswhere.exe is in your agent's PATH or specify a full path to the location using:

- name: Set up VC tools environment
  uses: elprans/gha-setup-vcpp-build-tools@v1
  with:
    vswhere-path: 'C:\path\to\your\tools\'

Notes on arguments

While the Action enables you to specify a vswhere path as well as a vs-version, these are more advanced options and when using GitHub-hosted runners you should not need these and is recommended you don't specify them. Using these require you to fully understand the runner environment, updates to the tools on the runner, and can cause failures if you are out of sync. For GitHub-hosted runners, omitting these arguments is the preferred usage.

Building this repo

As with most GitHub Actions, this requires NodeJS development tools. After installing NodeJS, you can build this by executing:

npm install
npm run build
npm run pack

which will modify/create the /dist folder with the final index.js output

Credits

Thank you to Warren Buckley for being a core contributor to this Action for the benefit of all developers!

About

A GitHub Action to facilitate configuring MSBuild in the workflow PATH for building .NET Framework applications.

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 94.9%
  • JavaScript 5.1%