『.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 具備擴展模式，容許你爲你的項目指定額外的工具。你能夠在可擴展性文檔查出更多信息。