dotnet 的命令

nuget.config的引用

https://docs.microsoft.com/zh-cn/nuget/reference/nuget-config-file

 

name

dotnet restore - 恢复项目的依赖项和工具。

摘要

• .NET Core 2.x
• .NET Core 1.x

复制

dotnet restore [] [--configfile] [--disable-parallel] [--force] [--ignore-failed-sources] [--no-cache]
    [--no-dependencies] [--packages] [-r|--runtime] [-s|--source] [-v|--verbosity]
dotnet restore [-h|--help]

描述

dotnet restore 命令使用 NuGet 还原依赖项以及在 project 文件中指定的特定于项目的工具。 默认情况下会并行执行对依赖项和工具的还原。

备注

从 .NET Core 2.0 开始，无需运行 dotnet restore，因为它由所有需要还原的命令隐式运行，如 dotnet new、dotnet build 和 dotnet run。 在执行显式还原有意义的某些情况下，它仍然是有效的命令，例如 Visual Studio Team Services 中的持续集成生成中，或在需要显式控制还原发生时间的生成系统中。

为了还原依赖项，NuGet 需要包所在的源。 通常通过 NuGet.config 配置文件提供源。 安装 CLI 工具时提供一个默认的配置文件。 可以通过在项目目录中创建自己的 NuGet.config 文件来指定其他源。也可以在命令提示符处指定每次调用的其他源。

对于依赖项，使用 --packages 参数指定还原操作期间放置还原包的位置。 如未指定，将使用默认的 NuGet 包缓存，可在所有操作系统上的用户主目录中的 .nuget/packages 目录找到它。 例如 Linux 上的 /home/user1 或 Windows 上的 C:\Users\user1。

对于特定于项目的工具，dotnet restore 首先还原打包工具所在的包，然后继续还原 project 文件中指定的工具依赖项。

dotnet restore 命令的行为会受 Nuget.Config 文件（如果有）中某些设置的影响。 例如，在 NuGet.Config 中设置 globalPackagesFolder 会将还原的 NuGet 包置于指定的文件夹中。 这是在 dotnet restore 命令中指定 --packages 选项的替代方法。 有关详细信息，请参阅 NuGet.Config reference（NuGet.Config 引用）。

隐式 dotnet restore

从 .Net Core 2.0 开始，当发出下列命令时，如有必要，将隐式运行 dotnet restore。

• dotnet new
• dotnet build
• dotnet build-server
• dotnet run
• dotnet test
• dotnet publish
• dotnet pack

在大多数情况下，不再需要显式使用 dotnet restore 命令。

有时，隐式运行 dotnet restore 可能不方便。 例如，某些自动化系统（如生成系统）需要显式调用 dotnet restore，以控制还原发生的时间，以便可以控制网络使用量。 要防止隐式运行 dotnet restore，可以通过上述任意命令使用 --no-restore 标记以禁用隐式还原。

参数

ROOT

要还原的项目文件的可选路径。

选项

• .NET Core 2.x
• .NET Core 1.x

--configfile

供还原操作使用的 NuGet 配置文件 (NuGet.config)。

--disable-parallel

禁用并行还原多个项目。

--force

强制解析所有依赖项，即使上次还原已成功，也不例外。 指定此标记等同于删除 project.assets.json 文件。

-h|--help

打印出有关命令的简短帮助。

--ignore-failed-sources

如果存在符合版本要求的包，则源失败时警告。

--no-cache

指定不缓存包和 HTTP 请求。

--no-dependencies

当使用项目到项目 (P2P) 引用还原项目时，还原根项目，不还原引用。

--packages

指定还原包的目录。

-r|--runtime

指定程序包还原的运行时。 这用于还原 .csproj 文件中的  标记中未显式列出的运行时的程序包。 有关运行时标识符 (RID) 的列表，请参阅 RID 目录。 通过多次指定此选项提供多个 RID。

-s|--source

指定要在还原操作期间使用的 NuGet 包源。 此设置会替代 NuGet.config 文件中指定的所有源。多次指定此选项可以提供多个源。

--verbosity

设置命令的详细级别。 允许使用的值为 q[uiet]、m[inimal]、n[ormal]、d[etailed] 和 diag[nostic]。

dotnet test

• ：✓ .NET Core SDK 1.x ✓ .NET Core SDK 2.0

name

dotnet test - 用于执行单元测试的 .NET 测试驱动程序。

摘要

• .NET Core 2.1
• .NET Core 2.0
• .NET Core 1.x

console复制

dotnet test [] [-a|--test-adapter-path] [--blame] [-c|--configuration] [--collect] [-d|--diag] [-f|--framework] [--filter]
    [-l|--logger] [--no-build] [--no-restore] [-o|--output] [-r|--results-directory] [-s|--settings] [-t|--list-tests] [-v|--verbosity]
dotnet test [-h|--help]

描述

dotnet test 命令用于执行给定项目中的单元测试。 dotnet test 命令启动为项目指定的测试运行程序控制台应用程序。 测试运行程序执行为单元测试框架（例如 MSTest、NUnit 或 xUnit）定义的测试，并报告每个测试是否成功。 测试运行程序和单元测试库打包为 NuGet 包并还原为该项目的普通依赖项。

测试项目使用普通  元素指定测试运行程序，如下方示例项目文件所示：

XML复制

  
    netcoreapp2.1
  

  
    
    
    
  

自变量

PROJECT

指向测试项目的路径。 如未指定，则默认为当前目录。

选项

• .NET Core 2.1
• .NET Core 2.0
• .NET Core 1.x

-a|--test-adapter-path

在测试运行中使用来自指定路径的自定义测试适配器。

--blame

在意见模式中运行测试。 此选项有助于隔离导致测试主机出现故障的有问题的测试。 它会在当前目录中创建一个输出文件 (Sequence.xml)，其中捕获了故障前的测试执行顺序。

-c|--configuration {Debug|Release}

定义生成配置。 默认值为 Debug，但项目配置可以替代此默认 SDK 设置。

--collect

为测试运行启用数据收集器。 有关详细信息，请参阅监视和分析测试运行。

-d|--diag

启用测试平台的诊断模式，并将诊断消息写入指定文件。

-f|--framework

查找特定框架的测试二进制文件。

--filter

使用给定表达式筛选掉当前项目中的测试。 有关详细信息，请参阅筛选选项详细信息部分。 若要获取使用选择性单元测试筛选的其他信息和示例，请参阅运行选择性单元测试。

-h|--help

打印出有关命令的简短帮助。

-l|--logger

指定测试结果记录器。

--no-build

不在运行测试项目之前生成它。 还隐式设置 --no-restore 标记。

--no-restore

运行此命令时不执行隐式还原。

-o|--output

查找要运行的二进制文件的目录。

-r|--results-directory

用于放置测试结果的目录。 如果指定的目录不存在，则会创建该目录。

-s|--settings

运行测试时要使用的设置。

-t|--list-tests

列出当前项目中发现的所有测试。

-v|--verbosity

设置命令的详细级别。 允许使用的值为 q[uiet]、m[inimal]、n[ormal]、d[etailed] 和 diag[nostic]。

示例

运行当前目录所含项目中的测试：

dotnet test

运行 test1 项目中的测试：

dotnet test ~/projects/test1/test1.csproj

在当前目录运行项目中的测试，并以 trx 格式生成测试结果文件：

dotnet test --logger:trx

筛选选项详细信息

--filter

 格式为 [|&]。

 是 Test Case 的特性。 下面介绍了常用单元测试框架支持的属性：

测试框架	支持的属性
MSTest	FullyQualifiedName name ClassName 优先级 TestCategory
xUnit	FullyQualifiedName DisplayName 特征

 说明了属性和值之间的关系：

运算符	函数
=	完全匹配
!=	非完全匹配
~	包含

 是字符串。 所有查找都不区分大小写。

不含  的表达式自动被视为 FullyQualifiedName 属性上的 contains（例如，dotnet test --filter xyz 与 dotnet test --filter FullyQualifiedName~xyz 相同）。

表达式可与条件运算符结合使用：

运算符	函数
|	或
&	AND

使用条件运算符时，可以用括号将表达式括起来（例如，(Name~TestMethod1) | (Name~TestMethod2)）。

若要获取使用选择性单元测试筛选的其他信息和示例，请参阅运行选择性单元测试。

请参阅

• 框架和目标
• .NET Core 运行时标识符 (RID) 目录

 

 

 

dotnet core 命令

 

 

 

 

 

dotnet

dotnet命令主要是用来查看一些基本的信息，如平台、版本号等。经常会用到的参数有–version，–info，–help，下面依次运行下看看输出

dotnet –version 
1.0.0-preview2-003121 
dotnet –info 
.NET Command Line Tools (1.0.0-preview2-003121)

Product Information: 
Version: 1.0.0-preview2-003121 
Commit SHA-1 hash: 1e9d529bc5

Runtime Environment: 
OS Name: Mac OS X 
OS Version: 10.11 
OS Platform: Darwin 
RID: osx.10.11-x64 
dotnet –help 
.NET Command Line Tools (1.0.0-preview2-003121) 
Usage: dotnet [host-options] [command] [arguments] [common-options]

Arguments: 
[command] The command to execute 
[arguments] Arguments to pass to the command 
[host-options] Options specific to dotnet (host) 
[common-options] Options common to all commands

Common options: 
-v|–verbose Enable verbose output 
-h|–help Show help

Host options (passed before the command): 
-v|–verbose Enable verbose output 
–version Display .NET CLI Version Number 
–info Display .NET CLI Info

Common Commands: 
new Initialize a basic .NET project 
restore Restore dependencies specified in the .NET project 
build Builds a .NET project 
publish Publishes a .NET project for deployment (including the runtime) 
run Compiles and immediately executes a .NET project 
test Runs unit tests using the test runner specified in the project 
pack Creates a NuGet package

dotnet new

dotnet new命令用来创建一个.net core项目，该命令包含两个选项，分别是-t（或–type）和-l（或-lang），用来指定项目类型和编程语言。

-l, –lang [C#|F#] 
-l的默认值是c#，也可以设置为f#。VB的话应该很快就能支持了。

-t, –type [console|web|lib|xunittest] 
-t的默认值是concole，控制台项目。其它几个参数分别代表web项目，类库项目和测试项目。例如：dotnet new命令会创建一个控制台项目，dotnet new -t web会创建一个web项目（asp.net mvc）。

dotnet restore

dotnet restore [–source] [–packages] [–disable-parallel] [–fallbacksource] [–configfile] 
[–verbosity] [] 
dotnet restore命令通过NuGet来下载定义在project.json文件中的依赖，然后放到用户目录下的.nuget/packages文件夹中。默认情况下，下载依赖组建的过程是并行进行的。 
–packages选项可以指定存放已下载组件的位置，默认是用户目录下的.nuget/packages文件夹。 
–disable-parallel选项用来禁用并行下载。 
–configfile选项用来指定使用哪个NuGet.config文件。 
dotnet restore命令运行完毕后，会生成project.lock.json文件。

dotnet build

dotnet build [–output] [–build-base-path] [–framework] [–configuration] [–runtime] [–version-suffix] 
[–build-profile] [–no-incremental] [–no-dependencies] [] 
dotnet build命令将项目中的所有源代码文件和依赖的组件编译为二进制的dll文件。该命令会读取project.lock.json，如果项目中找不到该文件，则需要先运行dotnet restore命令。 
执行完dotnet build命令后，会在bin/Debug/netcoreapp1.0文件夹下生成.dll文件和.pbd文件等，例如：

bash-3.2$ ls -al bin/Debug/netcoreapp1.0/ 
total 80 
drwxr-xr-x 11 jingjing staff 374 9 6 22:08 . 
drwxr-xr-x 6 jingjing staff 204 9 6 21:52 .. 
-rw-r–r–@ 1 jingjing staff 6148 9 6 23:13 .DS_Store 
-rwxr–r– 1 jingjing staff 1636 9 5 22:38 app.deps.json 
-rwxr–r– 1 jingjing staff 4608 9 5 22:38 app.dll 
-rwxr–r– 1 jingjing staff 496 9 5 22:38 app.pdb 
-rwxr–r– 1 jingjing staff 107 9 5 22:38 app.runtimeconfig.dev.json 
-rwxr–r– 1 jingjing staff 118 9 5 22:38 app.runtimeconfig.json 
-rwxr–r– 1 jingjing staff 3584 9 5 22:05 library.dll 
-rwxr–r– 1 jingjing staff 452 9 5 22:05 library.pdb 
drwxr-xr-x 10 jingjing staff 340 9 6 22:08 publish

dotnet test

dotnet test [–configuration] [–output] [–build-base-path] [–framework] [–runtime] [–no-build] [–parentProcessId] 
[–port] [] 
dotnet test命令用来运行单元测试项目中的测试代码，单元测试项目需要依赖一个单元测试框架（如nunit或xunit）以及对应的单元测试运行器，单元测试运行器在project.json文件中通过testRunner节点来指定。下面是一个使用xunit作为单元测试框架的项目的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"
      ]
    }
  }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21
• 22
• 23
• 24
• 25
• 26

其中，”testRunner”: “xunit”指明了需要的单元测试运行器。

dotnet run

dotnet run [–framework] [–configuration] [–project] [–help] [–] 
dotnet run命令是一个比较便捷的运行代码的命令。它会编译代码，输出信息，并运行代码。

dotnet pack

dotnet pack [–output] [–no-build] [–build-base-path] [–configuration] [–version-suffix] [] 
dotnet pack命令编译代码并生成一个NuGet包，具体来说就是在bin\Debug目录下生成一个.nupkg文件和一个.symbols.nupkg文件。

dotnet publish

dotnet publish [–framework] [–runtime] [–build-base-path] [–output] [–version-suffix] [–configuration] [] 
dotnet publish命令会编译代码，然后读取project.json文件中定义的所有依赖组件，最后将这些东西输出到一个文件夹中。生成的文件默认会输出到\bin\Debug\netcoreapp1.0\publish中，你可以通过-o或–output选项来修改输出位置。当你需要发布你的代码时，该命令的输出文件将是你所需要的全部文件。