『.NET Core CLI工具文档』（一）.NET Core 命令行工具（CLI）

时间 2020-01-31

标签 core cli 工具文档命令行繁體版

原文原文链接

说明：本文是我的翻译文章，因为我的水平有限，有不对的地方请你们帮忙更正。
原文：.NET Core Command Line Tools
翻译：.NET Core命令行工具git

什么是 .NET Core 命令行界面（CLI）？

.NET Core CLI 是开发 .NET Core 应用程序的一个新的跨平台工具链的基础。它是“基础”的缘由时它是在其它的、高级别工具的主要层，如集成开发环境（IDEs），由编辑器和构建者组成。github

默认它是跨平台的，而且对支持的每一个平台有相同的表现范围。这意味着，当你学会如何使用工具，你能够从任何支持的平台上以一样的方式使用它。json

安装

和其余工具同样，第一件事就是获取工具到你的机器上。根据你的状况，你可使用本地安装程序安装 CLI 或使用安装脚本。服务器

本地安装程序主要是用于开发的机器。CLI 是分别使用每一个支持的平台的原生安装机制，例如在 Ubuntu 上的 DEB 包，或者在 Windows 上的 MSI 包。这些安装程序将安装和安装后用户当即使用 CLI 的须要设置环境。然而，在机器上它们也须要的管理特权。你能够在 .NET Core 开始页查看安装说明。app

安装脚本，另外一方面，不须要管理权限。然而，它们也将不安装任何须备的事物在机器上；你须要手动安装全部的必备的事物。脚本是用于安装创建服务器或当你没有管理特权时但愿安装工具（请注意上面提示的必备的事物）。你能够在安装脚本参考主题找到更多的信息。若是你对如何在持续集成（CI）生成服务器上配置 CLI，请查看 CLI 和 CI 服务器文档。编辑器

默认状况下，CLI 将以一个并行的（SxS）方式安装。这意味着的多个版本的 CLI 工具能够在一台机器上在任何给定的时间共存。如何正确的解释学会使用，在下面的驱动部分是更详细的说明。工具

CLI 有哪些命令？

默认状况下安装如下命令：网站

newui
restore命令行
run
build
test
publish
pack

也有一种方法能够在每一个项目基础上导入更多的命令，以及添加本身的命令。这是更详细的说明在可扩展性部分。

使用 CLI 工做

一个简短的例子

在咱们进入其它更多细节以前，让咱们看看如何使用 CLI 工做，看起来像来自 10,000 英寸的视图。
下面的示例使用来自正常安装的 CLI 几个命令，初始化一个新的、简单的控制台应用程序，还原依赖项，生成应用程序并运行它。

dotnet new
dotnet restore
dotnet build --output /stuff
dotnet /stuff/new.dll

它如何工做？

正如上面看到的简短的示例，当你使用 CLI 工具时有一个模式。在这个模式中，咱们能够识别每一个命令的三个主要部分：

驱动程序（“dotnet”）
命令或者 “verb”
命令参数

让咱们深刻到上面每一个的更多细节。

驱动程序

驱动程序被命名为 dotnet。它是你调用的第一部分。这个驱动程序有两个功能：

执行 IL 代码
执行动词（verb）

它所作的两件事依赖于在命令行上指定的东西。在第一种状况下，你能够指定一个 IL 程序集，dotnet 运行相似这个：dotnet /path/to/your.dll。

在第二种状况下，该驱动程序试图调用指定的命令。这将开启 CLI 命令执行进程。首选，该驱动程序将肯定你想要的工具的版本。你能够在 global.json 文件中使用 sdkVersion 属性指定版本。若是那个不可用，该驱动程序将查找已经在磁盘上安装的工具的最新版本并将使用该版本。一旦版本被肯定，它将执行命令。

“动词”

动词是简单的执行操做命令。dotnet build 将生成代码。dotnet publish 将发布代码。动词被实现是做为一个按每个约定命名的控制台应用程序：dotnet-{verb}。全部的逻辑是表示动词的控制台应用程序实现的。

参数

在命令行上传递的参数是实际调用的 verb/command 的参数。
例如，当你键入 dotnet publish --output publishedapp，--output 参数被传递给 publish 命令。

可移植应用程序的类型

CLI 使应用程序能够移植在两个主要方面：

彻底可移植的应用能够在任何安装 .NET Core 地方运行
独立的应用程序

你能够在应用程序类型描述主题了解更多有关这两种。

从 DNX 迁移

若是你使用 .NET Core RC1 DNX，你可能想知道发生了什么和这些新工具与 DNX 工具如何有联系。总而言之，DNX 工具已经被 .NET Core CLI 工具代替了。
若是你有已存在的项目，或者是仅仅想知道命令如何映射，你可使用 DNX 迁移到 CLI 文档来获取全部的详细信息。

扩展性

固然，不是每个工具你可使用你的工做将是 core CLI 工具的一部分。可是，.NET Core CLI 具备扩展模式，容许你为你的项目指定额外的工具。你能够在可扩展性文档查出更多信息。