『.NET Core CLI工具文檔』（十一）dotnet-test

說明：本文是我的翻譯文章，因爲我的水平有限，有不對的地方請你們幫忙更正。
原文：dotnet-test
翻譯：dotnet-test

名稱

dotnet-test - 使用配置的測試運行器運行單元測試

概要

`dotnet test [--configuration]

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

描述

dotnet test 命令是用於在給定的項目執行單元測試。單元測試是依賴關係於單元測試框架（例如：NUnit 或 xUnit）的類庫項目，而且該單元測試框架是用於 dotnet 測試運行器。

測試項目須要在 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 test 支持兩種運行模式：

1. 控制檯：在控制檯模式下，dotnet test 是徹底執行被傳遞給它的任意命令，並輸出結果。任什麼時候候你調用 dotnet test 沒有傳遞 --port，它運行在控制檯模式下，這反過來將致使運行器在控制檯模式下運行。

2. 設計階段：在其餘工具，好比編輯器或集成開發環境（IDEs）的上下文中使用。你能夠在 dotnet-test protocol 找到更多關於這個模式的文檔。

選項

[project]

指定要測試項目的路徑。若是省略，則默認爲當前目錄。

-c, --configuration [Debug|Release]

用於生成下的配置。默認值是 Release。

-o, --output [DIR]

找到二進制運行的目錄。

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

臨時輸出的目錄。

-f, --framework [FRAMEWORK]

查看測試二進制文件的指定框架。

-r, --runtime [RUNTIME_IDENTIFIER]

查看測試二進制文件的指定運行時。

--no-build

沒有生成以前，運行它的測試項目。

--parentProcessId

經過 IDEs（集成開發環境）指定進程的 ID。若是父進程已經處理了，測試將退出。

--port

經過 IDEs（集成開發環境）指定端口號來偵聽鏈接。

例子

dotnet test

在當前目錄中的項目運行測試。

dotnet test /projects/test1/project.json

在 test1 項目中運行測試。

參考

• dotnet-test通訊協議