tasks.vs.json スキーマ リファレンス (C++)

"フォルダーを開く" プロジェクトのソース コードをビルドする方法を Visual Studio に伝えるには、tasks.vs.json ファイルを追加します。 ここでは任意のタスクを定義し、ソリューション エクスプローラーのコンテキスト メニューから呼び出すことができます。 すべてのビルド コマンドは CMakeLists.txt で指定されるため、CMake プロジェクトにはこのファイルが使用されません。 CMake 以外のビルド システムでは、tasks.vs.json でビルド コマンドを指定し、ビルド スクリプトを呼び出すことができます。 tasks.vs.json の使用の全般的な情報については、「"フォルダーを開く" の開発のためにビルド タスクとデバッグ タスクをカスタマイズする」を参照してください。

タスクには、type、default、launch、または remote という 4 つの値のいずれかを持つ msbuild プロパティがあります。 リモート接続が必要な場合を除き、ほとんどのタスクでは launch を使用する必要があります。

既定のプロパティ

既定のプロパティは、すべての種類のタスクで使用できます。

起動プロパティ

タスクの種類が launch の場合、次のプロパティを使用できます。

例

次のタスクでは、CppProperties.json スキーマ リファレンスに示すように、フォルダーにメイクファイルが指定され、Mingw64 環境が CppProperties.json で定義されている場合に、make.exe を呼び出します。

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

ソリューション エクスプローラーで .cpp ファイルを右クリックすると、コンテキスト メニューからこれらのタスクを呼び出すことができます。

リモートプロパティ

C++ ワークロードを含む Linux 開発をインストールし、Visual Studio 接続マネージャーを使用してリモート マシンへの接続を追加すると、リモート タスクが有効になります。 リモート タスクを使用すると、リモート システム上でコマンドを実行できます。また、そこにファイルをコピーすることもできます。

タスクの種類が remote の場合、次のプロパティを使用できます。

例

ソリューション エクスプローラーで main.cpp を右クリックすると、次のタスクがコンテキスト メニューに表示されます。 これは、接続マネージャーにおけるubuntuというリモートマシンに依存します。 このタスクによって、Visual Studio で現在開いているフォルダーがリモート マシンの sample ディレクトリにコピーされ、g++ が呼び出され、プログラムがビルドされます。

{
  "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 プロパティ

タスクの種類が msbuild の場合、次のプロパティを使用できます。