.NET Core命令行界面(CLI)是一个新的跨平台工具,用于创建,还原程序包,构建,运行和发布.NET应用程序。
在上一章中,我们使用Visual Studio创建了第一个ASP.NET Core Api 应用程序。Visual Studio在内部使用此CLI还原,生成和发布应用程序。其他更高级别的IDE,编辑器和工具都可以使用CLI支持.NET Core应用程序。
.NET Core CLI与.NET Core SDK一起安装在特定平台上。因此,我们不需要在开发机器上单独安装它。我们可以通过在Windows中打开命令提示符并编写dotnet并按Enter来验证CLI是否已正确安装。如果它显示使用情况和帮助,如下所示,则表明它已正确安装。
以下是命令结构。
dotnet
所有命令均以名为 "dotnet" 的驱动程序的命令名称开头。驱动程序开始执行指定的命令。在dotnet之后,我们可以提供命令(也称为动词)来执行特定操作。每个命令后都可以带有参数和选项。以下是.NET Core 2.x CLI命令。
基本命令 | 描述 |
---|---|
new | 根据指定的模板创建新的项目,配置文件或解决方案。 |
restore | 恢复项目的依赖关系和工具。 |
build | 构建一个项目及其所有依赖项。 |
Run | 运行源代码,无需任何显式的编译或启动命令。 |
publish | 将应用程序及其依赖项打包到一个文件夹中,以部署到托管系统。 |
test | 执行单元测试。 |
vtest | 从指定的文件运行测试。 |
pack | 将代码打包到NuGet包中。 |
clean | 清理项目的输出。 |
sln | 修改.NET Core解决方案文件。 |
help | 显示有关指定命令的帮助 |
store | 将指定的程序集存储在运行时程序包存储中。 |
项目修改命令 | 描述 |
---|---|
add package | 将包引用添加到项目。 |
add reference | 添加项目到项目(P2P)引用。 |
remove package | 从项目中删除程序包引用。 |
remove reference | 删除项目参考 |
list reference | 列出所有项目间参考 |
高级命令 | 描述 |
---|---|
nuget delete | 从服务器删除或取消NuGet软件包。 |
nuget locals | 清除或列出本地NuGet资源。 |
nuget push | 将程序包推送到服务器并发布。 |
msbuild | 构建一个项目及其所有依赖项。 |
dotnet install script | 用于安装.NET Core CLI工具和共享运行时的脚本。 |
让我们使用命令行界面创建,还原,构建和运行.NET Core控制台应用程序,而无需使用Visual Studio。
要创建一个新的.NET Core项目,我们必须使用新命令,后跟模板名称参数。我们可以使用CLI创建Console, Class Library,Web,MVC,WebAPI,Razor,Angular, React 等项目。使用控制台模板创建一个新的.NET Core控制台应用程序。
下面将在当前目录中创建与当前目录同名的新控制台项目。
dotnet new console
以下命令创建一个名为MyConsoleApp的新控制台项目。-n或--name选项可指定项目的名称。
dotnet new console -n MyConsoleApp
以下命令在MyProjects目录中创建一个名为MyConsoleApp的新控制台应用程序。-o或--output选项用于指定应在其中生成项目的输出目录。
dotnet new console -n MyConsoleApp -o D:\MyProjects
创建项目后,在命令提示符下进入D盘的MyProjects文件夹中
。
我们经常需要出于不同目的添加NuGet包引用。例如,用以下命令将Newtonsoft.json包添加到我们的控制台项目。
D:\MyProjects>dotnet add package Newtonsoft.json
这会将Newtonsoft.json包添加到我们的项目中。我们可以通过打开.csproj文件来进行验证。
要还原软件包或更新现有软件包,我们可以使用如下的restore命令。
D:\MyProjects>dotnet restore
要构建新项目或现有项目,请使用 D:\MyConsoleApp>dotnet build
命令。
要运行我们的控制台项目,请应用dotnet run
如下所示的命令。
如上图看到的,它显示输出“ Hello World!”。
我们可以通过在要获取帮助的命令末尾键入-h或-help来获得有关任何.NET Core CLI命令的帮助。例如,dotnet new -h将显示有关我们可以使用的新命令,参数和选项的帮助,如下所示。
因此,我们可以使用.NET Core命令行界面来创建,还原包,构建,运行和发布不同类型的.NET Core应用程序。