Укажите общие / «общие» значения для конфигураций в CppProperties.json или CMakeSettings.json

Question

При использовании функциональности «Открыть папку» в Visual Studio среда IDE выполняет поиск параметров и конфигураций проекта в специальном файле json. Для проектов CPP это может быть CppProperties.json. Для проектов CMake это может быть CMakeSettings.json.

Этот файл json содержит коллекцию из одной или нескольких «конфигураций», таких как «Debug» или «Release». Я буду использовать недавний проект CMake в качестве примера:

"configurations": [
    {
      "name": "ARM-Debug",
      "generator": "Ninja",
      "configurationType": "Debug",
      "inheritEnvironments": [
        "gcc-arm"
      ],
      "buildRoot": "${env.USERPROFILE}\\CMakeBuilds\\${workspaceHash}\\build\\${name}",
      "installRoot": "${env.USERPROFILE}\\CMakeBuilds\\${workspaceHash}\\install\\${name}",
      "cmakeCommandArgs": "",
      "buildCommandArgs": "-v",
      "ctestCommandArgs": "",
      "intelliSenseMode": "linux-gcc-arm",
      "variables": [
        {
          "name": "CMAKE_TOOLCHAIN_FILE",
          "value": "${workspaceRoot}/cmake/arm-none-eabi-toolchain.cmake"
        }
      ]
    },
    {
      "name": "ARM-Release",
      "generator": "Ninja",
      "configurationType": "Release",
      "inheritEnvironments": [
        "gcc-arm"
      ],
      "buildRoot": "${env.USERPROFILE}\\CMakeBuilds\\${workspaceHash}\\build\\${name}",
      "installRoot": "${env.USERPROFILE}\\CMakeBuilds\\${workspaceHash}\\install\\${name}",
      "cmakeCommandArgs": "",
      "buildCommandArgs": "-v",
      "ctestCommandArgs": "",
      "intelliSenseMode": "linux-gcc-arm",
      "variables": [
        {
          "name": "CMAKE_TOOLCHAIN_FILE",
          "value": "${workspaceRoot}/cmake/arm-none-eabi-toolchain.cmake"
        }
      ]
    }

Как видите, у меня есть две конфигурации с почти идентичными свойствами.

Мой вопрос: возможно ли определить эти общие / общие свойства один раз таким образом, чтобы позволить конфигурациям наследовать их и избежать повторения?

Answer 1

Более простой способ - определить среду на глобальном уровне (вне какой-либо конфигурации), например:

{
  "environments": [
    {
      "namespace" : "env",
      "varName": "varValue"
    }
  ],

Тогда вы можете использовать это везде, где вам нужно, например ::

  "cmakeCommandArgs": "${env.varName}",

Вы также можете использовать несколько сред и использовать их повторно, например:

{
  "environments": [
    {
      "environment": "env1",
      "namespace": "env",
      "varName": "varValueEnv1"
    },
    {
      "environment": "env2",
      "namespace": "env",
      "varName": "varValueEnv2"
    }

  ],
  "configurations": [
    {
      "name": "x64-Release",
      "inheritEnvironments": [
        "msvc_x64_x64", "env2"
      ],
      "cmakeCommandArgs": "${env.varName}",
.....
    }
  ]

x64-Release наследует значение переменных в среде, называемой env2 (пространство имен env)