référence de schéma tasks.vs.json (C++)

Pour indiquer à Visual Studio comment générer votre code source dans un projet Open Folder, ajoutez un fichier tasks.vs.json . Vous pouvez définir n’importe quelle tâche arbitraire ici, puis l’appeler à partir du menu contextuel Explorateur de solutions. Les projets CMake n’utilisent pas ce fichier, car toutes les commandes de build sont spécifiées dans CMakeLists.txt. Pour les systèmes de génération autres que CMake, tasks.vs.json est l’emplacement où vous pouvez spécifier des commandes de build et appeler des scripts de génération. Pour obtenir des informations générales sur l’utilisation de tasks.vs.json, consultez Personnaliser les tâches de génération et de débogage pour le développement « Ouvrir le dossier ».

Une tâche a une type propriété qui peut avoir l’une des quatre valeurs suivantes : default, , launchremoteou msbuild. La plupart des tâches doivent utiliser launch , sauf si une connexion à distance est requise.

Propriétés par défaut

Les propriétés par défaut sont disponibles sur tous les types de tâches :

Propriétés de lancement

Lorsque le type de tâche est launch, ces propriétés sont disponibles :

Exemple

Les tâches suivantes appellent make.exe lorsqu’un makefile est fourni dans le dossier et que l’environnement Mingw64 a été défini dans CppProperties.json, comme indiqué dans la référence de schéma CppProperties.json :

 {
  "version": "0.2.1",
  "tasks": [
    {
      "taskLabel": "gcc make",
      "appliesTo": "*.cpp",
      "type": "launch",
      "contextType": "custom",
      "inheritEnvironments": [
        "Mingw64"
      ],
      "command": "make"
    },
    {
      "taskLabel": "gcc clean",
      "appliesTo": "*.cpp",
      "type": "launch",
      "contextType": "custom",
      "inheritEnvironments": [
        "Mingw64"
      ],
      "command": "make",
      "args": ["clean"]
    }
  ]
}

Ces tâches peuvent être appelées à partir du menu contextuel lorsque vous cliquez avec le bouton droit sur un fichier .cpp dans Explorateur de solutions.

Propriétés distantes

Les tâches distantes sont activées lorsque vous installez le développement Linux avec la charge de travail C++ et ajoutez une connexion à un ordinateur distant à l’aide de Visual Studio Connecter ion Manager. Une tâche distante exécute des commandes sur un système distant et peut également copier des fichiers vers celui-ci.

Lorsque le type de tâche est remote, ces propriétés sont disponibles :

Exemple

La tâche suivante s’affiche dans le menu contextuel lorsque vous cliquez avec le bouton droit sur main.cpp dans Explorateur de solutions. Il dépend d’un ordinateur distant appelé ubuntu dans Connecter ion Manager. La tâche copie le dossier ouvert actuel dans Visual Studio dans le sample répertoire de l’ordinateur distant, puis appelle g++ pour générer le programme.

{
  "version": "0.2.1",
  "tasks": [
    {
      "taskLabel": "Build",
      "appliesTo": "main.cpp",
      "type": "remote",
      "contextType": "build",
      "command": "g++ main.cpp",
      "remoteMachineName": "ubuntu",
      "remoteCopyDirectory": "~/sample",
      "remoteCopyMethod": "sftp",
      "remoteWorkingDirectory": "~/sample/hello",
      "remoteCopySourcesOutputVerbosity": "Verbose"
    }
  ]
}

MSBuild (propriétés)

Lorsque le type de tâche est msbuild, ces propriétés sont disponibles :