DOTNETツールの使用


DotNetツールは、さまざまなタスクや機能を支援するアプリケーションです.テストカバレッジをチェックするツール、特定のクラウドサービス、コードの書式設定などに展開するツールがあります.Nugetにはlist here .
次の記事では、ツールを使用してSwagger CLI , 呼ばれるSwashbuckle.AspNetCore.Cli , 例として.

カンチシート


dotnet new tool-manifest # Create a tool manifest file

dotnet tool list # List installed tools

dotnet tool install ToolName # Install a tool

dotnet tool restore # Install the tools in the manifest file

dotnet tool update ToolName # Update a tool

dotnet tool uninstall ToolName # Uninstall a tool

dotnet ToolName # Run a tool

ウォークスルー


ローカルツールとグローバルツール


ツールはローカルまたはグローバルにインストールできます.ローカルにインストールされたツールは、特定のプロジェクトでのみ動作しますが、ツールのセットアップをよりポータブルにするツールマニフェストファイルを活用できます.
世界的にインストールされたツールは、至る所で利用できます.グローバルツールのコマンドは同じですが--global フラグを渡さなければならない.

ツールマニフェストファイル


コマンドdotnet new tool-manifest ファイルを作成する.config/dotnet-tools.json . これは、インストールされているツールの一覧とそのバージョンが含まれているファイルです.パッケージに精通している場合.NPMのJSONファイルは、このファイルに同じ目的があります.空のファイルは次のようになります.
{
  "version": 1,
  "isRoot": true,
  "tools": {}
}
ツールがインストールされている場合tools オブジェクトには、ツールに関するデータが格納されます.

道具を取り付ける

dotnet tool install Swashbuckle.AspNetCore.Cli swagger cliをインストールし、マニフェストファイルに追加します.あなたが特定のバージョンを望むならば、加えてください--version x.y.z . 複数のNuGetソースが追加された場合、インストーラが最初に間違ったソースを探すので、インストールは失敗する可能性があります.追加--ignore-failed-sources これを回避する.
これはツールをインストールしたマニフェストファイルです.
  "tools": {
    "swashbuckle.aspnetcore.cli": {
      "version": "5.5.1",
      "commands": [
        "swagger"
      ]
    }
  }

道具を動かす


マニフェストファイルから、swagger cliがコマンドで来ることがわかりますswagger . これは、dotnet swagger .
swagger cliはswaggerドキュメントを生成します.それは1つのコマンドだけです.tofile そして、必要な引数を2つ取ります.DLLファイルとエクスポートするAPIのバージョン.dotnet swagger tofile bin/debug/net.../something.dll 1

リストツール


ランdotnet tool list インストールされているツールを見るにはこのコマンドは、グローバルツールの一覧を表示するときに特に便利です.
➜ dotnet tool list
Package Id                   Version   Commands   Manifest
-------------------------------------------------------------------------------------
swashbuckle.aspnetcore.cli   5.5.1     swagger    ...tools/.config/dotnet-tools.json

復元ツール


マニフェストファイルは、ツールを追跡するので、彼らは簡単に実行することによって、新しいマシン上で復元することができますdotnet tool restore .

アンインストールツール

dotnet tool uninstall swashbuckle.aspnetcore.cli swagger cliをアンインストールします.

概要


あそこにある.探検するavailable tools , おそらくあなたの開発経験を強化するツールがあります.