Självstudie: Installera och använda ett lokalt .NET-verktyg med hjälp av .NET CLI
Den här artikeln gäller för: ✔️ .NET Core 3.0 SDK och senare versioner
I den här handledningen lär du dig hur du installerar och använder ett lokalt verktyg. Du använder ett verktyg som du skapar i den första guiden i den här serien.
Förutsättningar
Slutför första handledning i den här serien.
Installera .NET Core 2.1-körningen.
I den här självstudien installerar och använder du ett verktyg som är avsett för .NET Core 2.1, så du måste ha den runtime installerad på din dator. Om du vill installera 2.1-runtime går du till nedladdningssidan .NET Core 2.1 och hitta installationslänken för runtime i kolumnen Kör appar – Runtime.
Skapa en manifestfil
Om du bara vill installera ett verktyg för lokal åtkomst (för den aktuella katalogen och underkatalogerna) måste det läggas till i en manifestfil.
Från mappen microsoft.botsay navigerar du upp en nivå till mappen lagringsplats:
cd ..
Skapa en manifestfil genom att köra kommandot dotnet new:
dotnet new tool-manifest
Utdata anger att filen har skapats.
The template "Dotnet local tool manifest file" was created successfully.
Filen .config/dotnet-tools.json har ännu inga verktyg:
{
"version": 1,
"isRoot": true,
"tools": {}
}
Verktygen som anges i en manifestfil är tillgängliga för den aktuella katalogen och underkatalogerna. Den aktuella katalogen är den som innehåller katalogen .config med manifestfilen.
När du använder ett CLI-kommando som refererar till ett lokalt verktyg söker SDK efter en manifestfil i den aktuella katalogen och överordnade kataloger. Om den hittar en manifestfil, men filen inte innehåller det refererade verktyget, fortsätter sökningen genom överordnade kataloger. Sökningen avslutas när det refererade verktyget hittas eller en manifestfil med isRoot
inställd på true
.
Installera botsay som ett lokalt verktyg
Installera verktyget från det paket som du skapade i den första självstudien:
dotnet tool install --add-source ./microsoft.botsay/nupkg microsoft.botsay
Det här kommandot lägger till verktyget i manifestfilen som du skapade i föregående steg. Kommandoutdata visar vilken manifestfil som det nyligen installerade verktyget finns i:
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
Filen .config/dotnet-tools.json har nu ett verktyg:
{
"version": 1,
"isRoot": true,
"tools": {
"microsoft.botsay": {
"version": "1.0.0",
"commands": [
"botsay"
]
}
}
}
Använd verktyget
Anropa verktyget genom att köra kommandot dotnet tool run
från mappen lagringsplats:
dotnet tool run botsay hello from the bot
Återställa ett lokalt verktyg som installerats av andra
Du installerar vanligtvis ett lokalt verktyg i rotkatalogen på lagringsplatsen. När du checkar in manifestfilen på lagringsplatsen kan andra utvecklare hämta den senaste manifestfilen. Om du vill installera alla verktyg som anges i manifestfilen kan de köra ett enda dotnet tool restore
kommando.
Öppna filen .config/dotnet-tools.json och ersätt innehållet med följande JSON:
{ "version": 1, "isRoot": true, "tools": { "microsoft.botsay": { "version": "1.0.0", "commands": [ "botsay" ] }, "dotnetsay": { "version": "2.1.3", "commands": [ "dotnetsay" ] } } }
Spara ändringarna.
Att göra den här ändringen är detsamma som att hämta den senaste versionen från lagringsplatsen efter att någon annan har installerat paketet
dotnetsay
för projektkatalogen.Kör kommandot
dotnet tool restore
.dotnet tool restore
Kommandot genererar utdata som i följande exempel:
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.
Kontrollera att verktygen är tillgängliga:
dotnet tool list
Utdata är en lista över paket och kommandon, ungefär som i följande exempel:
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
Testa verktygen:
dotnet tool run dotnetsay hello from dotnetsay dotnet tool run botsay hello from botsay
Uppdatera ett lokalt verktyg
Den installerade versionen av det lokala verktyget dotnetsay
är 2.1.3. Använd kommandot dotnet tool update för att uppdatera verktyget till den senaste versionen.
dotnet tool update dotnetsay
Utdata anger det nya versionsnumret:
Tool 'dotnetsay' was successfully updated from version '2.1.3' to version '2.1.7'
(manifest file /home/name/repository/.config/dotnet-tools.json).
Uppdateringskommandot hittar den första manifestfilen som innehåller paket-ID:t och uppdaterar den. Om det inte finns något sådant paket-ID i någon manifestfil som ingår i sökomfånget lägger SDK:n till en ny post i den närmaste manifestfilen. Sökomfånget är uppe via överordnade kataloger tills en manifestfil med isRoot = true
hittas.
Ta bort lokala verktyg
Ta bort de installerade verktygen genom att köra kommandot dotnet tool uninstall:
dotnet tool uninstall microsoft.botsay
dotnet tool uninstall dotnetsay
Felsöka
Om du får ett felmeddelande när du följer självstudien kan du läsa Felsöka problem med användning av .NET-verktyg.
Se även
Mer information finns i .NET-verktyg.