ASP.NET Core 命令行界面
.NET Core 命令行界面(CLI)是一种新的跨平台工具,用于创建、恢复包、构建、运行和发布 .NET 应用程序。
我们创建了第一个 ASP.NET Core 应用程序。Visual Studio 在内部使用此 CLI 还原、生成和发布应用程序。其他更高级别的 IDE、编辑器和工具可以使用 CLI 来支持 .NET Core 应用程序。
针对选定平台,.NET Core CLI 与 .NET Core SDK 一起安装。所以我们不需要在开发机器上单独安装它。我们可以通过在 Windows 中打开命令提示符并编写 dotnet 并按 Enter 键来验证 CLI 是否正确安装。如果它显示如下所示的用法和帮助,则表示它安装正确。
命令结构
以下是命令结构。
所有命令都以名为 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 locals | 清除或列出本地 NuGet 资源。 |
nuget push | 将包推送到服务器并发布。 |
msbuild | 生成项目及其所有依赖项。 |
dotnet install script | 用于安装 .NET Core CLI 工具和共享运行时的脚本。 |
让我们使用命令行界面创建、还原、构建和运行 .NET Core 控制台应用程序,而不使用 Visual Studio。
创建新项目
要创建一个新的 .NET Core 项目,我们必须使用 new 命令,后跟模板名称参数。我们可以使用 CLI 创建控制台、类库、web、mvc、webapi、razor、angular、react等项目。使用控制台模板创建新的 .NET Core 控制台应用程序。
下面将在当前目录中创建与当前目录同名的新控制台项目。
以下命令创建名为 MyConsoleApp 的新控制台项目。-n 或 —name 选项指定项目的名称。
以下命令将创建名为 MyConsoleApp 的新控制台应用程序到 MyProjects 目录。-o 或 —output 选项用于指定应在其中生成项目的输出目录。
创建项目后,在命令提示符下导航到项目目录,以应用特定于项目的命令,在本例中为 C:\MyConsoleApp。
添加包引用
出于不同的目的,我们经常需要添加 NuGet 包引用。例如,应用以下命令将 Newtonsoft.json 包添加到控制台项目中。
这将增加 Newtonsoft.json 包。我们可以通过打开 .csproj 文件来验证它。
还原程序包
要还原程序包或更新现有程序包,我们可以使用下面的 restore 命令。
生成项目
要构建新项目或现有项目,请应用 C:\MyConsoleApp>dotnet 构建命令。
运行项目
要运行控制台项目,请应用如下所示的 dotnetrun 命令。
获取帮助
我们可以通过在要获取帮助的命令末尾键入 -h 或 -help 来获取有关任何 .NET Core CLI 命令的帮助。例如,dotnet new-h 将显示有关新命令、参数和选项的帮助,如下所示。
因此,我们可以使用 .NET Core 命令行界面来创建、恢复包、构建、运行和发布不同类型的 .NET Core 应用程序。