Make the toolsResolverCache path overridable using an environment var…

…iable. Fixes #11432.

Fixes #11432.

documentation/manpages/sdk/dotnet-environment-variables.7

@@ -452,6 +452,9 @@ Configures the default programming language for the \f[V]dotnet new\f[R] command
 The default value is \f[V]C#\f[R].
 Valid values are \f[V]C#\f[R], \f[V]F#\f[R], or \f[V]VB\f[R].
 For more information, see dotnet new.
+.SS \f[V]DOTNET_TOOLS_RESOLVER_CACHE_FOLDER\f[R]
+.PP
+Overrides the default location ($HOME/.dotnet/toolResolverCache) for the shim files for locally installed tools.
 .SH \f[V]dotnet watch\f[R] ENVIRONMENT VARIABLES
 .PP
 For information about \f[V]dotnet watch\f[R] settings that are available as environment variables, see dotnet watch environment variables.

documentation/manpages/sdk/dotnet-tool-install.1

@@ -99,7 +99,7 @@ They\[cq]re stored in the same way as global tools: an executable binary with th
 .SS Local tools
 .PP
 Local tools are stored in the NuGet global directory, whatever you\[cq]ve set that to be.
-There are shim files in \f[V]$HOME/.dotnet/toolResolverCache\f[R] for each local tool that point to where the tools are within that location.
+There are shim files in \f[V]$HOME/.dotnet/toolResolverCache\f[R] for each local tool that point to where the tools are within that location (this path can be overridden with the \f[V]DOTNET_TOOLS_RESOLVER_CACHE_FOLDER\f[R] environment variable).
 .PP
 References to local tools are added to a \f[I]dotnet-tools.json\f[R] file in a \f[I].config\f[R] directory under the current directory.
 If a manifest file doesn\[cq]t exist yet, create it by using the \f[V]--create-manifest-if-needed\f[R] option or by running the following command:

src/Cli/Microsoft.DotNet.Configurer/CliFolderPathCalculator.cs

@@ -40,7 +40,9 @@ public static string WindowsNonExpandedToolsShimPath
         public static string DotnetUserProfileFolderPath =>
             Path.Combine(DotnetHomePath, DotnetProfileDirectoryName);
 
-        public static string ToolsResolverCachePath => Path.Combine(DotnetUserProfileFolderPath, ToolsResolverCacheFolderName);
+        public static string ToolsResolverCachePath =>
+            Environment.GetEnvironmentVariable("DOTNET_TOOLS_RESOLVER_CACHE_FOLDER") ??
+             Path.Combine(DotnetUserProfileFolderPath, ToolsResolverCacheFolderName);
 
         public static string PlatformHomeVariableName => CliFolderPathCalculatorCore.PlatformHomeVariableName;
 

test/dotnet.Tests/CommandTests/ToolRestoreCommandTests.cs

@@ -437,6 +437,55 @@ public void ItRestoresCorrectToolVersion()
             rows[0].Version.Should().Be("8.0.0-rc.1.23419.6");
         }
 
+        [Fact]
+        public void ItRestoresCorrectToolVersionWithOverriddenResolverCachePath()
+        {
+            var testDir = _testAssetsManager.CreateTestDirectory().Path;
+
+            string configContents = """
+                {
+                  "version": 1,
+                  "isRoot": true,
+                  "tools": {
+                    "dotnet-ef": {
+                      "version": "8.0.0-rc.1.23419.6",
+                      "commands": [
+                        "dotnet-ef"
+                      ]
+                    }
+                  }
+                }
+                """;
+
+            File.WriteAllText(Path.Combine(testDir, "dotnet-tools.json"), configContents);
+
+            string CliHome = Path.Combine(testDir, ".home");
+            Directory.CreateDirectory(CliHome);
+
+            var toolsResolverCacheFolder = Path.Combine(testDir, "toolsResolverCache");
+            var toolRestoreCommand = new DotnetCommand(Log, "tool", "restore")
+                .WithEnvironmentVariable("DOTNET_CLI_HOME", CliHome)
+                .WithEnvironmentVariable("DOTNET_SKIP_WORKLOAD_INTEGRITY_CHECK", "true")
+                .WithEnvironmentVariable("DOTNET_TOOLS_RESOLVER_CACHE_FOLDER", toolsResolverCacheFolder)
+                .WithWorkingDirectory(testDir);
+
+            toolRestoreCommand
+                .Execute()
+                .Should()
+                .Pass();
+
+            var cacheFilePath = Path.Combine(toolsResolverCacheFolder, "1", "dotnet-ef");
+
+            string json = File.ReadAllText(cacheFilePath);
+
+            var rows = JsonSerializer.Deserialize<List<CacheRow>>(json);
+
+            rows.Count.Should().Be(1);
+
+            rows[0].Name.Should().Be("dotnet-ef");
+            rows[0].Version.Should().Be("8.0.0-rc.1.23419.6");
+        }
+
         [Fact]
         public void WhenCannotFindManifestFileItPrintsWarning()
         {