Kurz: Instalace a použití místního nástroje .NET pomocí rozhraní příkazového řádku .NET
Tento článek se týká: ✔️ .NET Core 3.0 SDK a novějších verzí
V tomto kurzu se naučíte, jak nainstalovat a používat místní nástroj. Použijete nástroj, který vytvoříte v prvním kurzu této série.
Požadavky
Dokončete první kurz této série.
Nainstalujte modul runtime .NET Core 2.1.
Pro účely tohoto kurzu nainstalujete a použijete nástroj, který cílí na .NET Core 2.1, takže musíte mít na svém počítači nainstalovaný modul runtime. Pokud chcete nainstalovat modul runtime 2.1, přejděte na stránku pro stažení .NET Core 2.1 a vyhledejte odkaz na instalaci modulu runtime ve sloupci Spustit aplikace – runtime .
Vytvoření souboru manifestu
Pokud chcete nainstalovat nástroj pouze pro místní přístup (pro aktuální adresář a podadresáře), musíte ho přidat do souboru manifestu.
Ze složky microsoft.botsay přejděte o jednu úroveň výš do složky úložiště :
cd ..
Vytvořte soubor manifestu spuštěním příkazu dotnet new :
dotnet new tool-manifest
Výstup označuje úspěšné vytvoření souboru.
The template "Dotnet local tool manifest file" was created successfully.
Soubor.config/dotnet-tools.json zatím neobsahuje žádné nástroje:
{
"version": 1,
"isRoot": true,
"tools": {}
}
Nástroje uvedené v souboru manifestu jsou k dispozici pro aktuální adresář a podadresáře. Aktuální adresář je ten, který obsahuje adresář.config se souborem manifestu.
Když použijete příkaz rozhraní příkazového řádku, který odkazuje na místní nástroj, sada SDK vyhledá soubor manifestu v aktuálním adresáři a nadřazených adresářích. Pokud najde soubor manifestu, ale neobsahuje odkazovaný nástroj, bude pokračovat ve vyhledávání prostřednictvím nadřazených adresářů. Hledání skončí, když najde odkazovaný nástroj nebo najde soubor manifestu s nastaveným isRoot
na true
hodnotu .
Instalace robota jako místního nástroje
Nainstalujte nástroj z balíčku, který jste vytvořili v prvním kurzu:
dotnet tool install --add-source ./microsoft.botsay/nupkg microsoft.botsay
Tento příkaz přidá nástroj do souboru manifestu, který jste vytvořili v předchozím kroku. Výstup příkazu ukazuje, ve kterém souboru manifestu se nově nainstalovaný nástroj nachází:
You can invoke the tool from this directory using the following command:
'dotnet tool run botsay' or 'dotnet botsay'
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
Entry is added to the manifest file /home/name/repository/.config/dotnet-tools.json
Soubor.config/dotnet-tools.json teď obsahuje jeden nástroj:
{
"version": 1,
"isRoot": true,
"tools": {
"microsoft.botsay": {
"version": "1.0.0",
"commands": [
"botsay"
]
}
}
}
Použití nástroje
Vyvolejte nástroj spuštěním dotnet tool run
příkazu ze složky úložiště :
dotnet tool run botsay hello from the bot
Obnovení místního nástroje nainstalovaného jinými uživateli
Místní nástroj se obvykle instaluje do kořenového adresáře úložiště. Po vracení souboru manifestu se změnami do úložiště můžou ostatní vývojáři získat nejnovější soubor manifestu. Pokud chcete nainstalovat všechny nástroje uvedené v souboru manifestu, můžou spustit jeden dotnet tool restore
příkaz.
Otevřete soubor.config/dotnet-tools.json a nahraďte obsah následujícím kódem JSON:
{ "version": 1, "isRoot": true, "tools": { "microsoft.botsay": { "version": "1.0.0", "commands": [ "botsay" ] }, "dotnetsay": { "version": "2.1.3", "commands": [ "dotnetsay" ] } } }
Uložte provedené změny.
Provedení této změny je stejné jako získání nejnovější verze z úložiště poté, co balíček
dotnetsay
pro adresář projektu nainstaloval někdo jiný.Spusťte příkaz
dotnet tool restore
.dotnet tool restore
Příkaz vytvoří výstup podobný následujícímu příkladu:
Tool 'microsoft.botsay' (version '1.0.0') was restored. Available commands: botsay Tool 'dotnetsay' (version '2.1.3') was restored. Available commands: dotnetsay Restore was successful.
Ověřte, že jsou dostupné nástroje:
dotnet tool list
Výstupem je seznam balíčků a příkazů, podobně jako v následujícím příkladu:
Package Id Version Commands Manifest -------------------------------------------------------------------------------------------- microsoft.botsay 1.0.0 botsay /home/name/repository/.config/dotnet-tools.json dotnetsay 2.1.3 dotnetsay /home/name/repository/.config/dotnet-tools.json
Otestujte nástroje:
dotnet tool run dotnetsay hello from dotnetsay dotnet tool run botsay hello from botsay
Aktualizace místního nástroje
Nainstalovaná verze místního nástroje dotnetsay
je 2.1.3. Pomocí příkazu dotnet tool update aktualizujte nástroj na nejnovější verzi.
dotnet tool update dotnetsay
Výstup označuje číslo nové verze:
Tool 'dotnetsay' was successfully updated from version '2.1.3' to version '2.1.7'
(manifest file /home/name/repository/.config/dotnet-tools.json).
Příkaz update najde první soubor manifestu, který obsahuje ID balíčku, a aktualizuje ho. Pokud v žádném souboru manifestu, který je v oboru hledání, neexistuje žádné TAKOVÉ ID balíčku, přidá sada SDK novou položku do nejbližšího souboru manifestu. Rozsah hledání probíhá prostřednictvím nadřazených adresářů, dokud se nenajde soubor manifestu s isRoot = true
.
Odebrání místních nástrojů
Odeberte nainstalované nástroje spuštěním příkazu dotnet tool uninstall :
dotnet tool uninstall microsoft.botsay
dotnet tool uninstall dotnetsay
Řešení potíží
Pokud se při sledování kurzu zobrazí chybová zpráva, přečtěte si téma Řešení potíží s využitím nástrojů .NET.
Viz také
Další informace najdete v tématu Nástroje .NET.