Visual Studio 2022 - Using Specific MSVC Build Tools #1

jcbrill · 2024-02-19T14:32:26Z

jcbrill
Feb 19, 2024
Maintainer

This document is generated by markedpp from source document fragments; edits will be lost when the document is regenerated.

⚠️ THIS DOCUMENT IS CURRENTLY UNDER CONSTRUCTION ⚠️

Visual Studio 2022 - Using Specific MSVC Build Tools

Preamble - Under Construction.

Executive Summary - Under Construction.

1. Introduction
2. MSVC Installer Files
- 2.1. Batch File Dependencies
- 2.2. Individual Build Tool Target Architecture Installation
  - 2.2.1. Files Installed
  - 2.2.2. Version File Contents
3. VS 2022 With v14.34 Build Tools by Target Architecture
4. VS 2022 With v14.34 Build Tools and the SCons MSVC Cache

1. Introduction

Under construction.

2. MSVC Installer Files

Common document definitions as of 18-Feb-2024:

VS2022INSTALLDIR = C:\Program Files\Microsoft Visual Studio\2022\Community
v14.3 (latest) build tools = 14.39.33519
v14.34-17.4 build tools = 14.34.31933

2.1. Batch File Dependencies

SCons	vcvarsall	VsDevCmd	File	Path
Opt¹	Opt¹	Opt¹	`Microsoft.VCToolsVersion.v143.default.txt`	`%VS2022INSTALLDIR%\VC\Auxiliary`
Req	Req²	Req²	`Microsoft.VCToolsVersion.default.txt`	`%VS2022INSTALLDIR%\VC\Auxiliary`
Req³	Req³	Req³	`vcvars140.bat`	`%VS2022INSTALLDIR%\Common7\Tools\vsdevcmd\ext\vcvars`
Req	Req	Req	`vcvars.bat`	`%VS2022INSTALLDIR%\Common7\Tools\vsdevcmd\ext`
Req	Req	Req	`VsDevCmd.bat`	`%VS2022INSTALLDIR%\Common7\Tools`
Req	Req		`vcvarsall.bat`	`%VS2022INSTALLDIR%\VC\Auxiliary\Build`
amd64			`vcvars64.bat`	`%VS2022INSTALLDIR%\VC\Auxiliary\Build`
amd64			`vcvarsx86_amd64.bat`	`%VS2022INSTALLDIR%\VC\Auxiliary\Build`
x86			`vcvarsamd64_x86.bat`	`%VS2022INSTALLDIR%\VC\Auxiliary\Build`
x86			`vcvars32.bat`	`%VS2022INSTALLDIR%\VC\Auxiliary\Build`
arm			`vcvarsamd64_arm.bat`	`%VS2022INSTALLDIR%\VC\Auxiliary\Build`
arm			`vcvarsx86_arm.bat`	`%VS2022INSTALLDIR%\VC\Auxiliary\Build`
arm64			`vcvarsamd64_arm64.bat`	`%VS2022INSTALLDIR%\VC\Auxiliary\Build`
arm64			`vcvarsx86_arm64.bat`	`%VS2022INSTALLDIR%\VC\Auxiliary\Build`

Legend:

Opt¹
Optional if the -vcvars_ver argument and MSVC_USER_VERSION environment variable are undefined and the Microsoft.VCToolsVersion.v143.default.txt file exists.
Req²
Required when the -vcvars_ver argument and MSVC_USER_VERSION environment variable are undefined and the Microsoft.VCToolsVersion.v143.default.txt file does not exist.
Req³
Required when building with the v14.0 build tools. The v14.0 build tools are not installed in the %VS2022INSTALLDIR% folder. The location is found via the windows registry.
Req
Required.
amd64, x86, arm, arm64
Required that at least one of the two target architecture batch files exists.

2.2. Individual Build Tool Target Architecture Installation

2.2.1. Files Installed

latest x64/x86	latest arm	latest arm64	14.34 x64/x86	14.34 arm	14.34 arm64	File	Path
*	*	*	*	*	*	`Microsoft.VCToolsVersion.v143.default.txt`	`%VS2022INSTALLDIR%\VC\Auxiliary`
*	*	*				`Microsoft.VCToolsVersion.default.txt`	`%VS2022INSTALLDIR%\VC\Auxiliary`
*			*			`vcvars140.bat`	`%VS2022INSTALLDIR%\Common7\Tools\vsdevcmd\ext\vcvars`
*			*			`vcvars.bat`	`%VS2022INSTALLDIR%\Common7\Tools\vsdevcmd\ext`
*	*	*	*	*	*	`VsDevCmd.bat`	`%VS2022INSTALLDIR%\Common7\Tools`
*	*	*				`vcvarsall.bat`	`%VS2022INSTALLDIR%\VC\Auxiliary\Build`
*	*	*				`vcvars64.bat`	`%VS2022INSTALLDIR%\VC\Auxiliary\Build`
*						`vcvarsx86_amd64.bat`	`%VS2022INSTALLDIR%\VC\Auxiliary\Build`
*						`vcvarsamd64_x86.bat`	`%VS2022INSTALLDIR%\VC\Auxiliary\Build`
*	*	*				`vcvars32.bat`	`%VS2022INSTALLDIR%\VC\Auxiliary\Build`
	*					`vcvarsamd64_arm.bat`	`%VS2022INSTALLDIR%\VC\Auxiliary\Build`
	*					`vcvarsx86_arm.bat`	`%VS2022INSTALLDIR%\VC\Auxiliary\Build`
		*				`vcvarsamd64_arm64.bat`	`%VS2022INSTALLDIR%\VC\Auxiliary\Build`
		*				`vcvarsx86_arm64.bat`	`%VS2022INSTALLDIR%\VC\Auxiliary\Build`

2.2.2. Version File Contents

latest x64/x86	latest arm	latest arm64	14.34 x64/x86	14.34 arm	14.34 arm64	Microsoft. VCToolsVersion. default.txt	Microsoft. VCToolsVersion. v143.default.txt
*	*	*				14.39.33519	14.39.33519
			*	*	*		14.34.31933

3. VS 2022 With v14.34 Build Tools by Target Architecture

3.1. Target x64/x86 With v14.34 Build Tools

3.1.1. Installation Steps

New Installation - Workload Method:

Step	Action	Updates	Microsoft. VCToolsVersion. default.txt	Microsoft. VCToolsVersion. v143.default.txt
1	VS Installer	Workloads: [x] Desktop development with C++	14.39.33519	14.39.33519
2	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 C++ x64/x86 build tools (v14.34-17.4)	14.39.33519	14.34.31933

New Installation - Minimal Component Method:

Step	Action	Updates	Microsoft. VCToolsVersion. default.txt	Microsoft. VCToolsVersion. v143.default.txt
1	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 C++ x64/x86 build tools (latest) [x] Windows 11 SDK (10.0.22621.0)	14.39.33519	14.39.33519
2	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 C++ x64/x86 build tools (v14.34-17.4)	14.39.33519	14.34.31933

Existing Installation - x64/x86 Build Tools (v14.34 Only):

Step	Action	Updates	Microsoft. VCToolsVersion. default.txt	Microsoft. VCToolsVersion. v143.default.txt
A	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 C++ x64/x86 build tools (v14.34-17.4) [x] Windows 11 SDK (10.0.22621.0)	no file	14.34.31933
	Existing		no file	14.34.31933
1	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 C++ x64/x86 build tools (latest) [ ] MSVC v143 - VS 2022 C++ x64/x86 build tools (v14.34-17.4)	14.39.33519	14.39.33519
2	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 C++ x64/x86 build tools (v14.34-17.4)	14.39.33519	14.34.31933

3.1.2. Sample Invocations

SCons environment invocations targeting amd64 and x86:

Prefer	VCVer	Result	SCons Environment Invocation
*	14.34	14.34	`Environment(TARGET_ARCH='amd64', MSVC_TOOLSET_VERSION='14.34')`
*	14.34	14.34	`Environment(TARGET_ARCH='x86', MSVC_TOOLSET_VERSION='14.34')`
	default	14.34¹	`Environment(TARGET_ARCH='amd64')`
	default	14.34¹	`Environment(TARGET_ARCH='x86')`
*	14.3	latest	`Environment(TARGET_ARCH='amd64', MSVC_TOOLSET_VERSION='14.3')`
*	14.3	latest	`Environment(TARGET_ARCH='x86', MSVC_TOOLSET_VERSION='14.3')`

¹ The v14.34 build tools will be used as the default build tools until later VS installer invocations modify or remove Microsoft.VCToolsVersion.v143.default.txt.

Windows command-line invocations targeting amd64 and x86 using amd64 build tools:

Prefer	VCVer	Result	Command Line Invocation
*	14.34	14.34	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvars64.bat" -vcvars_ver=14.34`
*	14.34	14.34	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsamd64_x86.bat" -vcvars_ver=14.34`
*	14.34	14.34	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsall.bat" x64 -vcvars_ver=14.34`
*	14.34	14.34	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsall.bat" x64_x86 -vcvars_ver=14.34`
*	14.34	14.34	`"%VS2022INSTALLDIR%\Common7\Tools\VsDevCmd.bat" -host_arch=amd64 -arch=amd64 -vcvars_ver=14.34`
*	14.34	14.34	"%VS2022INSTALLDIR%\Common7\Tools\VsDevCmd.bat" -host_arch=amd64 -arch=x86` -vcvars_ver=14.34
	14.34	14.34	`set VCVARS_USER_VERSION=14.34² "%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvars64.bat"`
	14.34	14.34	`set VCVARS_USER_VERSION=14.34² "%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsamd64_x86.bat"`
	14.34	14.34	`set VCVARS_USER_VERSION=14.34² "%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsall.bat" x64`
	14.34	14.34	`set VCVARS_USER_VERSION=14.34² "%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsall.bat" x64_x86`
	14.34	14.34	`set VCVARS_USER_VERSION=14.34² "%VS2022INSTALLDIR%\Common7\Tools\VsDevCmd.bat" -host_arch=amd64 -arch=amd64`
	14.34	14.34	`set VCVARS_USER_VERSION=14.34² "%VS2022INSTALLDIR%\Common7\Tools\VsDevCmd.bat" -host_arch=amd64 -arch=x86`
	default	14.34¹	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvars64.bat"`
	default	14.34¹	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsamd64_x86.bat"`
	default	14.34¹	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsall.bat" x64`
	default	14.34¹	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsall.bat" x64_x86`
	default	14.34¹	`"%VS2022INSTALLDIR%\Common7\Tools\VsDevCmd.bat" -host_arch=amd64 -arch=amd64`
	default	14.34¹	`"%VS2022INSTALLDIR%\Common7\Tools\VsDevCmd.bat" -host_arch=amd64 -arch=x86`
*	14.3	latest	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvars64.bat" -vcvars_ver=14.3`
*	14.3	latest	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsamd64_x86.bat" -vcvars_ver=14.3`
*	14.3	latest	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsall.bat" x64 -vcvars_ver=14.3`
*	14.3	latest	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsall.bat" x64_x86 -vcvars_ver=14.3`
*	14.3	latest	`"%VS2022INSTALLDIR%\Common7\Tools\VsDevCmd.bat" -host_arch=amd64 -arch=amd64 -vcvars_ver=14.3`
*	14.3	latest	`"%VS2022INSTALLDIR%\Common7\Tools\VsDevCmd.bat" -host_arch=amd64 -arch=x86 -vcvars_ver=14.3`
	14.3	latest	`set VCVARS_USER_VERSION=14.3² "%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvars64.bat"`
	14.3	latest	`set VCVARS_USER_VERSION=14.3² "%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsamd64_x86.bat"`
	14.3	latest	`set VCVARS_USER_VERSION=14.3² "%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsall.bat" x64`
	14.3	latest	`set VCVARS_USER_VERSION=14.3² "%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsall.bat" x64_x86`
	14.3	latest	`set VCVARS_USER_VERSION=14.3² "%VS2022INSTALLDIR%\Common7\Tools\VsDevCmd.bat" -host_arch=amd64 -arch=amd64`
	14.3	latest	`set VCVARS_USER_VERSION=14.3² "%VS2022INSTALLDIR%\Common7\Tools\VsDevCmd.bat" -host_arch=amd64 -arch=x86`

¹ The v14.34 build tools will be used as the default build tools until later VS installer invocations modify or remove Microsoft.VCToolsVersion.v143.default.txt.

² Use of the VCVARS_USER_VERSION environment variable appears to be undocumented.

3.2. Target ARM With v14.34 Build Tools

3.2.1. Installation Steps

New Installation - Workload Method:

Step	Action	Updates	Microsoft. VCToolsVersion. default.txt	Microsoft. VCToolsVersion. v143.default.txt
1	VS Installer	Workloads: [x] Desktop development with C++ Individual Components: [x] MSVC v143 - VS 2022 C++ ARM build tools (latest)	14.39.33519	14.39.33519
2	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 C++ ARM build tools (v14.34-17.4)	14.39.33519	14.34.31933

New Installation - Minimal Component Method:

Step	Action	Updates	Microsoft. VCToolsVersion. default.txt	Microsoft. VCToolsVersion. v143.default.txt
1	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 C++ ARM build tools (latest) [x] MSVC v143 - VS 2022 C++ x64/x86 build tools (latest) [x] Windows 11 SDK (10.0.22621.0)	14.39.33519	14.39.33519
2	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 C++ ARM build tools (v14.34-17.4)	14.39.33519	14.34.31933

Existing Installation - ARM Build Tools (v14.34 Only):

Step	Action	Updates	Microsoft. VCToolsVersion. default.txt	Microsoft. VCToolsVersion. v143.default.txt
A	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 ARM build tools (v14.34-17.4) [x] Windows 11 SDK (10.0.22621.0)	no file	14.34.31933
	Existing		no file	14.34.31933
1	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 C++ ARM build tools (latest) [ ] MSVC v143 - VS 2022 C++ ARM build tools (v14.34-17.4) [x] MSVC v143 - VS 2022 C++ x64/x86 build tools (latest)	14.39.33519	14.39.33519
2	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 C++ ARM build tools (v14.34-17.4)	14.39.33519	14.34.31933

3.2.2. Sample Invocations

SCons environment invocations targeting ARM:

Prefer	VCVer	Result	SCons Environment Invocation
*	14.34	14.34	`Environment(TARGET_ARCH='arm', MSVC_TOOLSET_VERSION='14.34')`
	default	14.34¹	`Environment(TARGET_ARCH='arm')`
*	14.3	latest	`Environment(TARGET_ARCH='arm', MSVC_TOOLSET_VERSION='14.3')`

¹ The v14.34 build tools will be used as the default build tools until later VS installer invocations modify or remove Microsoft.VCToolsVersion.v143.default.txt.

Windows command-line invocations targeting ARM using amd64 build tools:

Prefer	VCVer	Result	Command Line Invocation
*	14.34	14.34	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsamd64_arm.bat" -vcvars_ver=14.34`
*	14.34	14.34	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsall.bat" x64_arm -vcvars_ver=14.34`
*	14.34	14.34	`"%VS2022INSTALLDIR%\Common7\Tools\VsDevCmd.bat" -host_arch=amd64 -arch=arm -vcvars_ver=14.34`
	14.34	14.34	`set VCVARS_USER_VERSION=14.34² "%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsamd64_arm.bat"`
	14.34	14.34	`set VCVARS_USER_VERSION=14.34² "%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsall.bat" x64_arm`
	14.34	14.34	`set VCVARS_USER_VERSION=14.34² "%VS2022INSTALLDIR%\Common7\Tools\VsDevCmd.bat" -host_arch=amd64 -arch=arm`
	default	14.34¹	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsamd64_arm.bat"`
	default	14.34¹	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsall.bat" x64_arm`
	default	14.34¹	`"%VS2022INSTALLDIR%\Common7\Tools\VsDevCmd.bat" -host_arch=amd64 -arch=arm`
*	14.3	latest	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsamd64_arm.bat" -vcvars_ver=14.3`
*	14.3	latest	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsall.bat" x64_arm -vcvars_ver=14.3`
*	14.3	latest	`"%VS2022INSTALLDIR%\Common7\Tools\VsDevCmd.bat" -host_arch=amd64 -arch=arm -vcvars_ver=14.3`
	14.3	latest	`set VCVARS_USER_VERSION=14.3² "%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsamd64_arm.bat"`
	14.3	latest	`set VCVARS_USER_VERSION=14.3² "%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsall.bat" x64_arm`
	14.3	latest	`set VCVARS_USER_VERSION=14.3² "%VS2022INSTALLDIR%\Common7\Tools\VsDevCmd.bat" -host_arch=amd64 -arch=arm`

¹ The v14.34 build tools will be used as the default build tools until later VS installer invocations modify or remove Microsoft.VCToolsVersion.v143.default.txt.

² Use of the VCVARS_USER_VERSION environment variable appears to be undocumented.

3.3. Target ARM64 With v14.34 Build Tools

3.3.1. Installation Steps

New Installation - Workload Method:

Step	Action	Updates	Microsoft. VCToolsVersion. default.txt	Microsoft. VCToolsVersion. v143.default.txt
1	VS Installer	Workloads: [x] Desktop development with C++ Individual Components: [x] MSVC v143 - VS 2022 C++ ARM64/ARM64EC build tools (latest)	14.39.33519	14.39.33519
2	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 C++ ARM64/ARM64EC build tools (v14.34-17.4)	14.39.33519	14.34.31933

New Installation - Minimal Component Method:

Step	Action	Updates	Microsoft. VCToolsVersion. default.txt	Microsoft. VCToolsVersion. v143.default.txt
1	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 C++ ARM64/ARM64EC build tools (latest) [x] MSVC v143 - VS 2022 C++ x64/x86 build tools (latest) [x] Windows 11 SDK (10.0.22621.0)	14.39.33519	14.39.33519
2	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 C++ ARM64/ARM64EC build tools (v14.34-17.4)	14.39.33519	14.34.31933

Existing Installation - ARM64 Build Tools (v14.34 Only):

Step	Action	Updates	Microsoft. VCToolsVersion. default.txt	Microsoft. VCToolsVersion. v143.default.txt
A	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 ARM64/ARM64EC build tools (v14.34-17.4) [x] Windows 11 SDK (10.0.22621.0)	no file	14.34.31933
	Existing		no file	14.34.31933
1	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 C++ ARM64/ARM64EC build tools (latest) [ ] MSVC v143 - VS 2022 C++ ARM64/ARM64EC build tools (v14.34-17.4) [x] MSVC v143 - VS 2022 C++ x64/x86 build tools (latest)	14.39.33519	14.39.33519
2	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 C++ ARM64/ARM64EC build tools (v14.34-17.4)	14.39.33519	14.34.31933

3.3.2. Sample Invocations

SCons environments targeting arm64:

Prefer	VCVer	Result	SCons Environment Invocation
*	14.34	14.34	`Environment(TARGET_ARCH='arm64', MSVC_TOOLSET_VERSION='14.34')`
	default	14.34¹	`Environment(TARGET_ARCH='arm64')`
*	14.3	latest	`Environment(TARGET_ARCH='arm64', MSVC_TOOLSET_VERSION='14.3')`

¹ The v14.34 build tools will be used as the default build tools until later VS installer invocations modify or remove Microsoft.VCToolsVersion.v143.default.txt.

Windows command-line invocations targeting arm64 using amd64 build tools:

Prefer	VCVer	Result	Command Line Invocation
*	14.34	14.34	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsamd64_arm64.bat" -vcvars_ver=14.34`
*	14.34	14.34	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsall.bat" x64_arm64 -vcvars_ver=14.34`
*	14.34	14.34	`"%VS2022INSTALLDIR%\Common7\Tools\VsDevCmd.bat" -host_arch=amd64 -arch=arm64 -vcvars_ver=14.34`
	14.34	14.34	`set VCVARS_USER_VERSION=14.34² "%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsamd64_arm64.bat"`
	14.34	14.34	`set VCVARS_USER_VERSION=14.34² "%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsall.bat" x64_arm64`
	14.34	14.34	`set VCVARS_USER_VERSION=14.34² "%VS2022INSTALLDIR%\Common7\Tools\VsDevCmd.bat" -host_arch=amd64 -arch=arm64`
	default	14.34¹	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsamd64_arm64.bat"`
	default	14.34¹	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsall.bat" x64_arm64`
	default	14.34¹	`"%VS2022INSTALLDIR%\Common7\Tools\VsDevCmd.bat" -host_arch=amd64 -arch=arm64`
*	14.3	latest	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsamd64_arm64.bat" -vcvars_ver=14.3`
*	14.3	latest	`"%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsall.bat" x64_arm64 -vcvars_ver=14.3`
*	14.3	latest	`"%VS2022INSTALLDIR%\Common7\Tools\VsDevCmd.bat" -host_arch=amd64 -arch=arm64 -vcvars_ver=14.3`
	14.3	latest	`set VCVARS_USER_VERSION=14.3² "%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsamd64_arm64.bat"`
	14.3	latest	`set VCVARS_USER_VERSION=14.3² "%VS2022INSTALLDIR%\VC\Auxiliary\Build\vcvarsall.bat" x64_arm64`
	14.3	latest	`set VCVARS_USER_VERSION=14.3² "%VS2022INSTALLDIR%\Common7\Tools\VsDevCmd.bat" -host_arch=amd64 -arch=arm64`

¹ The v14.34 build tools will be used as the default build tools until later VS installer invocations modify or remove Microsoft.VCToolsVersion.v143.default.txt.

² Use of the VCVARS_USER_VERSION environment variable appears to be undocumented.

3.4. Target All With v14.34 Build Tools

3.4.1. Installation Steps

New Installation - Workload Method:

Step	Action	Updates	Microsoft. VCToolsVersion. default.txt	Microsoft. VCToolsVersion. v143.default.txt
1	VS Installer	Workloads: [x] Desktop development with C++ Individual Components: [x] MSVC v143 - VS 2022 C++ ARM build tools (latest) [x] MSVC v143 - VS 2022 C++ ARM64/ARM64EC build tools (latest)	14.39.33519	14.39.33519
2	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 C++ ARM build tools (v14.34-17.4) [x] MSVC v143 - VS 2022 C++ ARM64/ARM64EC build tools (v14.34-17.4) [x] MSVC v143 - VS 2022 C++ x64/x86 build tools (v14.34-17.4)	14.39.33519	14.34.31933

New Installation - Minimal Component Method:

Step	Action	Updates	Microsoft. VCToolsVersion. default.txt	Microsoft. VCToolsVersion. v143.default.txt
1	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 C++ ARM build tools (latest) [x] MSVC v143 - VS 2022 C++ ARM64/ARM64EC build tools (latest) [x] MSVC v143 - VS 2022 C++ x64/x86 build tools (latest) [x] Windows 11 SDK (10.0.22621.0)	14.39.33519	14.39.33519
2	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 C++ ARM build tools (v14.34-17.4) [x] MSVC v143 - VS 2022 C++ ARM64/ARM64EC build tools (v14.34-17.4) [x] MSVC v143 - VS 2022 C++ x64/x86 build tools (v14.34-17.4)	14.39.33519	14.34.31933

Existing Installation - Target All Build Tools (v14.34 Only):

Step	Action	Updates	Microsoft. VCToolsVersion. default.txt	Microsoft. VCToolsVersion. v143.default.txt
A	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 ARM build tools (v14.34-17.4) [x] MSVC v143 - VS 2022 ARM64/ARM64EC build tools (v14.34-17.4) [x] MSVC v143 - VS 2022 x64/x86 build tools (v14.34-17.4) [x] Windows 11 SDK (10.0.22621.0)	no file	14.34.31933
	Existing		no file	14.34.31933
1	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 C++ ARM build tools (latest) [ ] MSVC v143 - VS 2022 C++ ARM build tools (v14.34-17.4) [x] MSVC v143 - VS 2022 C++ ARM64/ARM64EC build tools (latest) [ ] MSVC v143 - VS 2022 C++ ARM64/ARM64EC build tools (v14.34-17.4) [x] MSVC v143 - VS 2022 C++ x64/x86 build tools (latest) [ ] MSVC v143 - VS 2022 C++ x64/x86 build tools (v14.34-17.4)	14.39.33519	14.39.33519
2	VS Installer	Individual Components: [x] MSVC v143 - VS 2022 C++ ARM build tools (v14.34-17.4) [x] MSVC v143 - VS 2022 C++ ARM64/ARM64EC build tools (v14.34-17.4) [x] MSVC v143 - VS 2022 C++ x64/x86 build tools (v14.34-17.4)	14.39.33519	14.34.31933

3.4.2. Sample Invocations

SCons environments for all targets:

Prefer	VCVer	Result	SCons Environment Invocation
*	14.34	14.34	`Environment(TARGET_ARCH='amd64', MSVC_TOOLSET_VERSION='14.34')`
*	14.34	14.34	`Environment(TARGET_ARCH='x86', MSVC_TOOLSET_VERSION='14.34')`
*	14.34	14.34	`Environment(TARGET_ARCH='arm', MSVC_TOOLSET_VERSION='14.34')`
*	14.34	14.34	`Environment(TARGET_ARCH='arm64', MSVC_TOOLSET_VERSION='14.34')`
	default	14.34¹	`Environment(TARGET_ARCH='amd64')`
	default	14.34¹	`Environment(TARGET_ARCH='x86')`
	default	14.34¹	`Environment(TARGET_ARCH='arm')`
	default	14.34¹	`Environment(TARGET_ARCH='arm64')`
*	14.3	latest	`Environment(TARGET_ARCH='amd64', MSVC_TOOLSET_VERSION='14.3')`
*	14.3	latest	`Environment(TARGET_ARCH='x86', MSVC_TOOLSET_VERSION='14.3')`
*	14.3	latest	`Environment(TARGET_ARCH='arm', MSVC_TOOLSET_VERSION='14.3')`
*	14.3	latest	`Environment(TARGET_ARCH='arm64', MSVC_TOOLSET_VERSION='14.3')`

¹ The v14.34 build tools will be used as the default build tools until later VS installer invocations modify or remove Microsoft.VCToolsVersion.v143.default.txt.

Windows command-line invocations for all targets:
- See Target x64/x86 - Sample Invocations above for amd64 and x86 targets.
- See Target ARM - Sample Invocations above for arm targets.
- See Target ARM64 - Sample Invocations above for arm64 targets.

4. VS 2022 With v14.34 Build Tools and the SCons MSVC Cache

4.1. SCons MSVC Cache Force Default Arguments

SCons Environment Variable	Default	Force
`SCONS_CACHE_MSVC_FORCE_DEFAULTS`	`undefined`, False or 0	True or 1

From the Undocumented Features section of README - SCons.Tool.MSCommon:

When enabled, the default msvc toolset version and the default sdk version, if not otherwise specified, are added to the batch file argument list. This is intended to make the cache more resilient to Visual Studio updates that may change the default toolset version and/or the default SDK version.

4.2. v14.34 Build Tools Followed by Latest Build Tools

MSVC version file values :

Step Microsoft.
VCToolsVersion.
default.txt Microsoft.
VCToolsVersion.
v143.default.txt

A 14.39.33519 14.34.31933

B 14.39.33519 14.39.33519

SCons results without the MSVC cache enabled:

Step	Expect	Default	Force	SCons Environment Invocation
A	14.34	14.34	14.34	`Environment(TARGET_ARCH='amd64', MSVC_TOOLSET_VERSION='14.34')`
A	14.34	14.34	14.34	`Environment(TARGET_ARCH='amd64')`
A	latest	latest	latest	`Environment(TARGET_ARCH='amd64', MSVC_TOOLSET_VERSION='14.3'`
B	14.34	14.34	14.34	`Environment(TARGET_ARCH='amd64', MSVC_TOOLSET_VERSION='14.34')`
B	latest	latest	latest	`Environment(TARGET_ARCH='amd64')`
B	latest	latest	latest	`Environment(TARGET_ARCH='amd64', MSVC_TOOLSET_VERSION='14.3'`

SCons results with the MSVC cache enabled:

Step	Expect	Default¹	Force	SCons Environment Invocation
A	14.34	14.34	14.34	`Environment(TARGET_ARCH='amd64', MSVC_TOOLSET_VERSION='14.34')`
A	14.34	14.34	14.34	`Environment(TARGET_ARCH='amd64')`
A	latest	latest	latest	`Environment(TARGET_ARCH='amd64', MSVC_TOOLSET_VERSION='14.3'`
B	14.34	14.34	14.34	`Environment(TARGET_ARCH='amd64', MSVC_TOOLSET_VERSION='14.34')`
B	latest	${\tt{\color{red}14.34}}$	latest	`Environment(TARGET_ARCH='amd64')`
B	latest	latest	latest	`Environment(TARGET_ARCH='amd64', MSVC_TOOLSET_VERSION='14.3'`

¹If a newer Windows SDK version is installed after Step A, the cached environment paths for the Default column would be invalid as they would include the earlier Windows SDK version paths. If the earlier Windows SDK version is still installed, the cached environment would be silently incorrect.

4.3. Latest Build Tools Followed by v14.34 Build Tools

MSVC version file values :

Step Microsoft.
VCToolsVersion.
default.txt Microsoft.
VCToolsVersion.
v143.default.txt

A 14.39.33519 14.39.33519

B 14.39.33519 14.34.31933

SCons results without the MSVC cache enabled:

Step	Expect	Default	Force	SCons Environment Invocation
A	14.34	14.34	14.34	`Environment(TARGET_ARCH='amd64', MSVC_TOOLSET_VERSION='14.34')`
A	latest	latest	latest	`Environment(TARGET_ARCH='amd64')`
A	latest	latest	latest	`Environment(TARGET_ARCH='amd64', MSVC_TOOLSET_VERSION='14.3'`
B	14.34	14.34	14.34	`Environment(TARGET_ARCH='amd64', MSVC_TOOLSET_VERSION='14.34')`
B	14.34	14.34	14.34	`Environment(TARGET_ARCH='amd64')`
B	latest	latest	latest	`Environment(TARGET_ARCH='amd64', MSVC_TOOLSET_VERSION='14.3'`

SCons results with the MSVC cache enabled:

Step	Expect	Default¹	Force	SCons Environment Invocation
A	14.34	14.34	14.34	`Environment(TARGET_ARCH='amd64', MSVC_TOOLSET_VERSION='14.34')`
A	latest	latest	latest	`Environment(TARGET_ARCH='amd64')`
A	latest	latest	latest	`Environment(TARGET_ARCH='amd64', MSVC_TOOLSET_VERSION='14.3'`
B	14.34	14.34	14.34	`Environment(TARGET_ARCH='amd64', MSVC_TOOLSET_VERSION='14.34')`
B	14.34	${\tt{\color{red}latest}}$	14.34	`Environment(TARGET_ARCH='amd64')`
B	latest	latest	latest	`Environment(TARGET_ARCH='amd64', MSVC_TOOLSET_VERSION='14.3'`

¹If a newer Windows SDK version is installed after Step A, the cached environment paths for the Default column would be invalid as they would include the earlier Windows SDK version paths. If the earlier Windows SDK version is still installed, the cached environment would be silently incorrect.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Visual Studio 2022 - Using Specific MSVC Build Tools #1

{{title}}

Replies: 0 comments

Select a reply

Visual Studio 2022 - Using Specific MSVC Build Tools #1

jcbrill Feb 19, 2024 Maintainer

Visual Studio 2022 - Using Specific MSVC Build Tools

Table of Contents

1. Introduction

2. MSVC Installer Files

2.1. Batch File Dependencies

2.2. Individual Build Tool Target Architecture Installation

2.2.1. Files Installed

2.2.2. Version File Contents

3. VS 2022 With v14.34 Build Tools by Target Architecture

3.1. Target x64/x86 With v14.34 Build Tools

3.1.1. Installation Steps

3.1.2. Sample Invocations

3.2. Target ARM With v14.34 Build Tools

3.2.1. Installation Steps

3.2.2. Sample Invocations

3.3. Target ARM64 With v14.34 Build Tools

3.3.1. Installation Steps

3.3.2. Sample Invocations

3.4. Target All With v14.34 Build Tools

3.4.1. Installation Steps

3.4.2. Sample Invocations

4. VS 2022 With v14.34 Build Tools and the SCons MSVC Cache

4.1. SCons MSVC Cache Force Default Arguments

4.2. v14.34 Build Tools Followed by Latest Build Tools

4.3. Latest Build Tools Followed by v14.34 Build Tools

Replies: 0 comments

jcbrill
Feb 19, 2024
Maintainer