Tasks.vs.json-Schemareferenz (C++)

Fügen Sie eine tasks.vs.json-Datei hinzu, damit Visual Studio weiß, wie Ihr Quellcode in einem „Ordner öffnen“-Projekt erstellt werden soll. Sie können in dieser Datei eine beliebige Aufgabe definieren und diesen dann über das Kontextmenü des Projektmappen-Explorers aufrufen. CMake-Projekte verwenden diese Datei in der Regel nicht, da alle Buildbefehle in CMakeLists.txt angegeben sind. Bei anderen Buildsystemen als CMake können Sie in tasks.vs.json Ihre Buildbefehle angeben und Buildskripts aufrufen. Allgemeine Informationen zur Verwendung von tasks.vs.json finden Sie unter Anpassen von Build- und Debugtasks für die Open Folder-Entwicklung.

Eine Aufgabe hat eine type-Eigenschaft, die einen von vier Werten aufweisen kann: default, launch, remote oder msbuild. Die meisten Aufgaben sollten launch verwenden, es sei denn, eine Remoteverbindung ist erforderlich.

Standardeigenschaften

Die Standardeigenschaften sind für alle Aufgabentypen verfügbar:

Eigenschaft	Type	Beschreibung
taskLabel	string	(Erforderlich.) Gibt die Aufgabenbezeichnung an, die auf der Benutzeroberfläche verwendet wird.
appliesTo	Zeichenfolge	(Erforderlich.) Gibt an, für welche Dateien der Befehl ausgeführt werden kann. Die Verwendung von Platzhaltern wird unterstützt, z. B. „“, „.cpp“, „/*.txt“.
contextType	Zeichenfolge	Zulässige Werte sind: „custom“, „build“, „clean“ und „rebuild“. Bestimmt, wo im Kontextmenü die Aufgabe angezeigt wird. Der Standardwert ist „custom“.
output	Zeichenfolge	Gibt ein Ausgabetag für Ihren Task an.
inheritEnvironments	array	Gibt mehrere Umgebungsvariablen an, die aus mehreren Quellen geerbt werden. Sie können Variablen in Dateien wie CMakeSettings.json oder CppProperties.json definieren und sie für den Aufgabenkontext verfügbar machen. Visual Studio 16.4:: Geben Sie Umgebungsvariablen pro Aufgabe mithilfe der env.VARIABLE_NAME Syntax an. Wenn Sie die Festlegung einer Variable aufheben möchten, legen Sie sie auf „null“ fest.
passEnvVars	boolean	Gibt an, ob zusätzliche Umgebungsvariablen für den Aufgabenkontext eingeschlossen werden sollen oder nicht. Diese Variablen unterscheiden sich von denen, die mithilfe der envVars-Eigenschaft definiert werden. Der Standardwert ist „True“.

Starteigenschaften

Wenn der Aufgabentyp launch ist, sind die folgenden Eigenschaften verfügbar:

Eigenschaft	Type	Beschreibung
command	string	Gibt den vollständigen Pfad des Prozesses oder Skripts für den Start an.
args	array	Gibt eine durch Kommas getrennte Liste an Argumenten an, die an den Befehl übergeben werden.
launchOption	Zeichenfolge	Zulässige Werte: "None", "ContinueOnError","IgnoreError". Gibt an, wie der Befehl fortgesetzt werden soll, wenn Fehler auftreten.
workingDirectory	Zeichenfolge	Gibt das Verzeichnis an, in dem der Befehl ausgeführt wird. Standardwert: Das aktuelle Arbeitsverzeichnis des Projekts.
customLaunchCommand	Zeichenfolge	Gibt eine globale Bereichsanpassung an, die angewendet werden soll, bevor der Befehl ausgeführt wird. Dies ist hilfreich, wenn Umgebungsvariablen wie %PATH% festgelegt werden sollen.
customLaunchCommandArgs	Zeichenfolge	Gibt Argumente für customLaunchCommand an. (Erfordert customLaunchCommand.)
env	Gibt eine Schlüssel-Wert-Liste benutzerdefinierter Umgebungsvariablen an. Beispiel: „myEnv“: „myVal“.
commands	array	Gibt eine Liste von Befehlen an, die in Reihenfolge aufgerufen werden sollen.

Beispiel

Die folgenden Aufgaben rufen make.exe auf, wenn eine Makefile im Ordner bereitgestellt wird und die Mingw64-Umgebung in CppProperties.json definiert wurde. Sehen Sie sich dazu die CppProperties.json-Schemareferenz an:

 {
  "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"]
    }
  ]
}

Die Aufgaben können im Kontextmenü aufgerufen werden, wenn Sie mit der rechten Maustaste auf eine CPP-Datei im Projektmappen-Explorer klicken.

Remoteeigenschaften

Remoteaufgaben sind möglich, wenn Sie die Workload „Linux Entwicklung mit C++“ installieren und eine Verbindung zu einem Remotecomputer hinzufügen, indem Sie den Verbindungs-Manager in Visual Studio verwenden. Eine Remoteaufgabe führt Befehle auf einem Remotesystem aus und kann auch Dateien dorthin kopieren.

Wenn der Aufgabentyp remote ist, sind die folgenden Eigenschaften verfügbar:

Eigenschaft	Type	Beschreibung
remoteMachineName	string	Der Name des Remotecomputers. Dieser muss einem Computername im Verbindungs-Manager entsprechen.
command	Zeichenfolge	Der Befehl, um den Remotecomputer zu senden. Standardmäßig werden Befehle im $HOME-Verzeichnis auf dem Remotesystem ausgeführt.
remoteWorkingDirectory	Zeichenfolge	Das aktuelle Arbeitsverzeichnis auf dem Remotecomputer.
localCopyDirectory	Zeichenfolge	Das lokale Verzeichnis, das auf den Remotecomputer kopiert werden soll. Der Standardwert ist das aktuelle Arbeitsverzeichnis.
remoteCopyDirectory	Zeichenfolge	Das Verzeichnis auf dem Remotecomputer, in das localCopyDirectory kopiert wird.
remoteCopyMethod	Zeichenfolge	Die Methode, die für den Kopiervorgang verwendet wird. Zulässige Werte sind: „none“, „sftp“, „rsync“. „rsync“ wird für große Projekte empfohlen.
remoteCopySourcesOutputVerbosity	Zeichenfolge	Zulässige Werte: "Normal","Verbose","Diagnostic".
rsyncCommandArgs	Zeichenfolge	Der Standard ist „-t --delete“.
remoteCopyExclusionList	array	Durch Kommas getrennte Liste von Dateien in localCopyDirectory, die bei Kopiervorgängen ausgeschlossen werden sollen.

Beispiel

Die folgende Aufgabe wird im Kontextmenü angezeigt, wenn Sie mit der rechten Maustaste auf main.cpp im Projektmappen-Explorer klicken. Die Aufgabe hängt von einem Remotecomputer namens ubuntu im Verbindungs-Manager ab. Die Aufgabe kopiert den aktuellen Ordner in Visual Studio in das sample-Verzeichnis auf dem Remotecomputer und ruft dann g++ ab, um das Programm zu erstellen.

{
  "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-Eigenschaften

Wenn der Aufgabentyp msbuild ist, sind die folgenden Eigenschaften verfügbar:

Eigenschaft	Type	Beschreibung
verbosity	string	Gibt die VerbosityAllowed-Werte des MSBuild-Projekts an: "Quiet", "Minimal", "Normal", "Detailed", "Diagnostic".
toolsVersion	Zeichenfolge	Gibt die Toolsetversion an, mit der das Projekt erstellt werden soll, z. B. „2.0“, „3.5“, „4.0“, „Current“. Der Standardwert ist „Current“.
globalProperties	Objekt	Gibt eine Schlüssel-Wert-Liste der globalen Eigenschaften an, die in das Projekt übergeben werden sollen, z. B. „Configuration“:„Release“.
properties	Objekt	Gibt eine Schlüssel-Wert-Liste zusätzlicher nur für das Projekt geltender Eigenschaften an.
targets	array	Gibt die Liste der Ziele an, die im Projekt der Reihe nach aufgerufen werden sollen. Das Standardziel des Projekts wird verwendet, wenn keines angegeben ist.