.NET Core CLI ツールのドキュメント dotnet-test

名前

dotnet-test - 構成されたテストランナーを使用して単体テストを実行します

概要

`dotnet test [--configuration]

[--output] [--build-base-path] [--framework] [--runtime]
[--no-build]
[--parentProcessId] [--port]  
[<project>]`

説明

dotnet test コマンドは、指定されたプロジェクトで単体テストを実行するために使用されます。単体テストは、ドットネット テスト ランナーで使用する単体テスト フレームワーク (NUnit や xUnit など) に依存するクラス ライブラリ プロジェクトです。

テスト プロジェクトは、project.json の「testRunner」ノードを使用してテスト ランナー属性を指定する必要があります。この値には、単体テスト フレームワークの名前が含まれている必要があります。

次の project.json の例は、必要な属性を示しています:

{
  "version": "1.0.0-*",
  "buildOptions": {
    "debugType": "portable"
  },
  "dependencies": {
    "System.Runtime.Serialization.Primitives": "4.1.1",
    "xunit": "2.1.0",
    "dotnet-test-xunit": "1.0.0-rc2-192208-24"
  },
  "testRunner": "xunit",
  "frameworks": {
    "netcoreapp1.0": {
      "dependencies": {
        "Microsoft.NETCore.App": {
          "type": "platform",
          "version": "1.0.0"
        }
      },
      "imports": [
        "dotnet5.4",
        "portable-net451+win8"
      ]
    }
  }
}

dotnet テストは 2 つの実行モードをサポートしています:

コンソール: コンソール モードでは、dotnet テストは渡されたコマンドを完全に実行し、結果を出力します。 --port を渡さずに dotnet test を呼び出すと、そのテストはコンソール モードで実行され、ランナーもコンソール モードで実行されます。

設計フェーズ: エディターや統合開発環境 (IDE) などの他のツールのコンテキストで使用されます。このモードに関する詳細なドキュメントは、dotnet-test protocol で見つけることができます。

オプション

[プロジェクト]

テストするプロジェクトへのパスを指定します。省略した場合、デフォルトは現在のディレクトリになります。

-c, --configuration [Debug|Release]

は、次の構成を生成するために使用されます。デフォルト値は「リリース」です。

-o, --output [DIR]

バイナリが実行されるディレクトリを見つけます。

-b, --build-base-path [DIR]

一時出力用のディレクトリ。

-f, --framework [FRAMEWORK]

テスト バイナリの指定されたフレームワークを表示します。

-r, --runtime [RUNTIME_IDENTIFIER]

テスト バイナリの指定されたランタイムを表示します。

--no-build

は、実行前にテスト プロジェクトをビルドしません。

--parentProcessId

IDE (統合開発環境) を介してプロセスの ID を指定します。親プロセスがそれを処理した場合、テストは終了します。

--port

IDE (統合開発環境) を通じて接続をリッスンするポート番号を指定します。

例

dotnet test

現在のディレクトリ内のプロジェクトでテストを実行します。

dotnet test /projects/test1/project.json

test1 プロジェクトでテストを実行します。