Set Build Target Same As Launch Target feature (#4519)

* Set Build Target Same As Launch Target feature

* Leverage selectBuildAndLaunchTarget, update docs and changelog

- selectLaunchTarget delegates to selectBuildAndLaunchTarget when
  cmake.setBuildTargetSameAsLaunchTarget is enabled
- Remove redundant auto-sync from setLaunchTargetName
- Update setting description to mention debug target
- Add missing docs entry in cmake-settings.md
- Add changelog entry for PR #4519

Co-authored-by: Copilot <[email protected]>

* Remove trailing commas in config emitters and test fixture

Co-authored-by: Copilot <[email protected]>

---------

Co-authored-by: Hannia Valera <[email protected]>
Co-authored-by: Garrett Campbell <[email protected]>
Co-authored-by: snehara99 <[email protected]>
Co-authored-by: Sneha Ramachandran <[email protected]>
Co-authored-by: Copilot <[email protected]>

Author: 5 people

CHANGELOG.md

@@ -8,6 +8,7 @@ Features:
 - Add individual CTest test nodes to the Project Outline with inline run/debug buttons, and enable debugging tests from both the Outline and Test Explorer without requiring a launch.json. [#4721](https://github.com/microsoft/vscode-cmake-tools/pull/4721)
 - Add "Delete Cache, Reconfigure and Build" command that chains cache deletion, reconfiguration, and build into a single action. [#4723](https://github.com/microsoft/vscode-cmake-tools/pull/4723)
 - Add "Set Build and Launch/Debug Target" command that sets both the build target and launch target simultaneously. [#4732](https://github.com/microsoft/vscode-cmake-tools/pull/4732)
+- Add `cmake.setBuildTargetSameAsLaunchTarget` setting to automatically set the build target when the launch/debug target is changed. [#4519](https://github.com/microsoft/vscode-cmake-tools/pull/4519) [@nikita-karatun](https://github.com/nikita-karatun)
 - Add `cmake.additionalBuildProblemMatchers` setting to define custom problem matchers for build output. Supports tools like clang-tidy, PCLint Plus, cppcheck, or custom scripts integrated via `add_custom_command`/`add_custom_target`. [#4077](https://github.com/microsoft/vscode-cmake-tools/issues/4077)
 
 Improvements:

docs/cmake-settings.md

@@ -76,6 +76,7 @@ Options that support substitution, in the table below, allow variable references
 | `cmake.preRunCoverageTarget` | Target to build before running tests with coverage using the test explorer. | `null` | no |
 | `cmake.revealLog` | Controls when the CMake output log should be revealed. | `always` | no |
 | `cmake.saveBeforeBuild` | If `true` (the default), saves open text documents when build or configure is invoked before running CMake. | `true` | no |
+| `cmake.setBuildTargetSameAsLaunchTarget` | If `true`, setting the launch/debug target automatically sets the build target to match. | `false` | no |
 | `cmake.setBuildTypeOnMultiConfig` | If `true`, set build type on multi-config generators. | `false` | no |
 | `cmake.showConfigureWithDebuggerNotification` | If `true`, show notification when configure with debugger. | `true` | no |
 | `cmake.showNotAllDocumentsSavedQuestion` | If `true`, show not all documents saved question. | `true` | no |

package.json

@@ -4014,6 +4014,12 @@
             "default": false,
             "description": "%cmake-tools.configuration.cmake.useFolderPropertyInBuildTargetDropdown.description%",
             "scope": "resource"
+        },
+        "cmake.setBuildTargetSameAsLaunchTarget": {
+          "type": "boolean",
+          "default": false,
+          "description": "%cmake-tools.configuration.cmake.setBuildTargetSameAsLaunchTarget.description%",
+          "scope": "resource"
         }
       }
     },

package.nls.json

@@ -374,6 +374,7 @@
     "cmake-tools.configuration.cmake.postRunCoverageTarget.description": "Target to build after running tests with coverage using the test explorer",
     "cmake-tools.configuration.cmake.coverageInfoFiles.description": "LCOV coverage info files to be processed after running tests with coverage using the test explorer.",
     "cmake-tools.configuration.cmake.useFolderPropertyInBuildTargetDropdown.description": "Controls if the default build target dropdown is grouped by the CMake folder groups.",
+    "cmake-tools.configuration.cmake.setBuildTargetSameAsLaunchTarget.description": "When enabled, setting the launch/debug target automatically sets the build target to match. The build target can still be changed independently.",
     "cmake-tools.debugger.pipeName.description": "Name of the pipe (on Windows) or domain socket (on Unix) to use for debugger communication.",
     "cmake-tools.debugger.clean.description": "Clean prior to configuring.",
     "cmake-tools.debugger.configureAll.description": "Configure for all projects.",

src/cmakeProject.ts

@@ -2636,14 +2636,19 @@ export class CMakeProject {
 
     /**
      * Implementation of `cmake.selectLaunchTarget`
+     * When cmake.setBuildTargetSameAsLaunchTarget is true, delegates to
+     * selectBuildAndLaunchTarget so the build target is also updated.
      */
     async selectLaunchTarget(name?: string): Promise<string | null> {
+        if (this.workspaceContext.config.setBuildTargetSameAsLaunchTarget) {
+            return this.selectBuildAndLaunchTarget(name);
+        }
         return this.setLaunchTargetByName(name);
     }
 
     /**
      * Implementation of `cmake.selectBuildAndLaunchTarget`
-     * Sets both the build target and the launch target simultaneously.
+     * Sets both the build target and the launch/debug target simultaneously.
      */
     async selectBuildAndLaunchTarget(name?: string): Promise<string | null> {
         const result = await this.setLaunchTargetByName(name);
@@ -2671,8 +2676,7 @@ export class CMakeProject {
             return null;
         } if (executableTargets.length === 1) {
             const target = executableTargets[0];
-            await this.workspaceContext.state.setLaunchTargetName(this.folderName, target.name, this.isMultiProjectFolder);
-            this._launchTargetName.set(target.name);
+            await this.setLaunchTargetName(target.name);
             return target.path;
         }
 
@@ -2690,11 +2694,15 @@ export class CMakeProject {
         if (!chosen) {
             return null;
         }
-        await this.workspaceContext.state.setLaunchTargetName(this.folderName, chosen.label, this.isMultiProjectFolder);
-        this._launchTargetName.set(chosen.label);
+        await this.setLaunchTargetName(chosen.label);
         return chosen.detail;
     }
 
+    private async setLaunchTargetName(name: string) {
+        await this.workspaceContext.state.setLaunchTargetName(this.folderName, name, this.isMultiProjectFolder);
+        this._launchTargetName.set(name);
+    }
+
     async getCurrentLaunchTarget(): Promise<ExecutableTarget | null> {
         const targetName = this.workspaceContext.state.getLaunchTargetName(this.folderName, this.isMultiProjectFolder);
         const target = (await this.executableTargets).find(e => e.name === targetName);

src/config.ts

@@ -235,6 +235,7 @@ export interface ExtensionConfigurationSettings {
     postRunCoverageTarget: string | null;
     coverageInfoFiles: string[];
     useFolderPropertyInBuildTargetDropdown: boolean;
+    setBuildTargetSameAsLaunchTarget: boolean;
     additionalBuildProblemMatchers: BuildProblemMatcherConfig[];
 }
 
@@ -627,6 +628,10 @@ export class ConfigurationReader implements vscode.Disposable {
         return this.configData.useFolderPropertyInBuildTargetDropdown;
     }
 
+    get setBuildTargetSameAsLaunchTarget(): boolean {
+        return this.configData.setBuildTargetSameAsLaunchTarget;
+    }
+
     private readonly emitters: EmittersOf<ExtensionConfigurationSettings> = {
         autoSelectActiveFolder: new vscode.EventEmitter<boolean>(),
         defaultActiveFolder: new vscode.EventEmitter<string | null>(),
@@ -698,6 +703,7 @@ export class ConfigurationReader implements vscode.Disposable {
         postRunCoverageTarget: new vscode.EventEmitter<string | null>(),
         coverageInfoFiles: new vscode.EventEmitter<string[]>(),
         useFolderPropertyInBuildTargetDropdown: new vscode.EventEmitter<boolean>(),
+        setBuildTargetSameAsLaunchTarget: new vscode.EventEmitter<boolean>(),
         additionalBuildProblemMatchers: new vscode.EventEmitter<BuildProblemMatcherConfig[]>()
     };
 

test/unit-tests/config.test.ts

@@ -86,6 +86,7 @@ function createConfig(conf: Partial<ExtensionConfigurationSettings>): Configurat
         postRunCoverageTarget: null,
         coverageInfoFiles: [],
         useFolderPropertyInBuildTargetDropdown: true,
+        setBuildTargetSameAsLaunchTarget: false,
         additionalBuildProblemMatchers: []
     });
     ret.updatePartial(conf);