Självstudie: Publicera ett .NET-konsolprogram med Hjälp av Visual Studio Code

Den här självstudien visar hur du publicerar en konsolapp så att andra användare kan köra den. Publicering skapar den uppsättning filer som behövs för att köra ett program. Om du vill distribuera filerna kopierar du dem till måldatorn.

.NET CLI används för att publicera appen, så du kan följa den här självstudien med en annan kodredigerare än Visual Studio Code om du vill.

Förutsättningar

• Den här självstudien fungerar med konsolappen som du skapar i Skapa ett .NET-konsolprogram med hjälp av Visual Studio Code.

Publicera appen

1. Starta Visual Studio Code.

2. Öppna projektmappen HelloWorld som du skapade i Skapa ett .NET-konsolprogram med hjälp av Visual Studio Code.

3. Välj Visa>terminal på huvudmenyn.

   Terminalen öppnas i mappen HelloWorld .

4. Kör följande kommando:

   dotnet publish --configuration Release
   

   Standardkonfigurationen för bygget är Felsökning, så det här kommandot anger versionskonfigurationen. Utdata från versionskonfigurationen har minimal symbolisk felsökningsinformation och är helt optimerad.

   Kommandoutdata liknar följande exempel:

   Microsoft (R) Build Engine version 17.8.0+b89cb5fde for .NET
   Copyright (C) Microsoft Corporation. All rights reserved.
     Determining projects to restore...
     All projects are up-to-date for restore.
     HelloWorld -> C:\Projects\HelloWorld\bin\Release\net8.0\HelloWorld.dll
     HelloWorld -> C:\Projects\HelloWorld\bin\Release\net8.0\publish\
   

Granska filerna

Som standard skapar publiceringsprocessen en ramverksberoende distribution, vilket är en typ av distribution där det publicerade programmet körs på en dator som har .NET-körningen installerad. Om du vill köra den publicerade appen kan du använda den körbara filen eller köra dotnet HelloWorld.dll kommandot från en kommandotolk.

I följande steg tittar du på de filer som skapats av publiceringsprocessen.

1. Välj Utforskaren i det vänstra navigeringsfältet.

2. Expandera bin/Release/net7.0/publish.

   

   Som bilden visar innehåller de publicerade utdata följande filer:

   • HelloWorld.deps.json

     Det här är programmets körningsberoendefil. Den definierar .NET-komponenterna och biblioteken (inklusive det dynamiska länkbiblioteket som innehåller ditt program) som behövs för att köra appen. Mer information finns i Körningskonfigurationsfiler.

   • HelloWorld.dll

     Det här är den ramverksberoende distributionsversionen av programmet. Om du vill köra det här dynamiska länkbiblioteket anger du dotnet HelloWorld.dll i en kommandotolk. Den här metoden för att köra appen fungerar på alla plattformar som har .NET-körningen installerad.

   • HelloWorld.exe (HelloWorld på Linux eller macOS.)

     Det här är den ramverksberoende körbara versionen av programmet. Filen är operativsystemspecifik.

   • HelloWorld.pdb (valfritt för distribution)

     Det här är filen med felsökningssymboler. Du behöver inte distribuera den här filen tillsammans med ditt program, men du bör spara den om du behöver felsöka den publicerade versionen av ditt program.

   • HelloWorld.runtimeconfig.json

     Det här är programmets körningskonfigurationsfil. Den identifierar den version av .NET som ditt program har skapats för att köras på. Du kan också lägga till konfigurationsalternativ i den. Mer information finns i Konfigurationsinställningar för .NET-körning.

Kör den publicerade appen

1. Högerklicka på publiceringsmappen i Utforskaren (Ctrl-klicka på macOS) och välj Öppna i integrerad terminal.

   

2. Kör appen i Windows eller Linux med hjälp av den körbara filen.

   1. I Windows anger .\HelloWorld.exe och trycker du på Retur.

   2. I Linux anger ./HelloWorld och trycker du på Retur.

   3. Ange ett namn som svar på uppmaningen och tryck på valfri tangent för att avsluta.

3. Kör appen på valfri plattform med hjälp dotnet av kommandot :

   1. Ange dotnet HelloWorld.dll och tryck på Retur.

   2. Ange ett namn som svar på uppmaningen och tryck på valfri tangent för att avsluta.

Ytterligare resurser

• Distribution av .NET-program
• Publicera .NET-appar med .NET CLI
• dotnet publish
• Använda .NET SDK i ci-miljöer (continuous integration)

Nästa steg

I den här självstudien publicerade du en konsolapp. I nästa självstudie skapar du ett klassbibliotek.

Skapa ett .NET-klassbibliotek med Visual Studio Code

Den här självstudien visar hur du publicerar en konsolapp så att andra användare kan köra den. Publicering skapar den uppsättning filer som behövs för att köra ett program. Om du vill distribuera filerna kopierar du dem till måldatorn.

.NET CLI används för att publicera appen, så du kan följa den här självstudien med en annan kodredigerare än Visual Studio Code om du vill.

Förutsättningar

• Den här självstudien fungerar med konsolappen som du skapar i Skapa ett .NET-konsolprogram med hjälp av Visual Studio Code.

Publicera appen

1. Starta Visual Studio Code.

2. Öppna projektmappen HelloWorld som du skapade i Skapa ett .NET-konsolprogram med hjälp av Visual Studio Code.

3. Välj Visa>terminal på huvudmenyn.

   Terminalen öppnas i mappen HelloWorld .

4. Kör följande kommando:

   dotnet publish --configuration Release
   

   Standardkonfigurationen för bygget är Felsökning, så det här kommandot anger versionskonfigurationen. Utdata från versionskonfigurationen har minimal symbolisk felsökningsinformation och är helt optimerad.

   Kommandoutdata liknar följande exempel:

   Microsoft (R) Build Engine version 16.7.4+b89cb5fde for .NET
   Copyright (C) Microsoft Corporation. All rights reserved.
     Determining projects to restore...
     All projects are up-to-date for restore.
     HelloWorld -> C:\Projects\HelloWorld\bin\Release\net7.0\HelloWorld.dll
     HelloWorld -> C:\Projects\HelloWorld\bin\Release\net7.0\publish\
   

Granska filerna

Som standard skapar publiceringsprocessen en ramverksberoende distribution, vilket är en typ av distribution där det publicerade programmet körs på en dator som har .NET-körningen installerad. Om du vill köra den publicerade appen kan du använda den körbara filen eller köra dotnet HelloWorld.dll kommandot från en kommandotolk.

I följande steg tittar du på de filer som skapats av publiceringsprocessen.

1. Välj Utforskaren i det vänstra navigeringsfältet.

2. Expandera bin/Release/net7.0/publish.

   

   Som bilden visar innehåller de publicerade utdata följande filer:

   • HelloWorld.deps.json

     Det här är programmets körningsberoendefil. Den definierar .NET-komponenterna och biblioteken (inklusive det dynamiska länkbiblioteket som innehåller ditt program) som behövs för att köra appen. Mer information finns i Körningskonfigurationsfiler.

   • HelloWorld.dll

     Det här är den ramverksberoende distributionsversionen av programmet. Om du vill köra det här dynamiska länkbiblioteket anger du dotnet HelloWorld.dll i en kommandotolk. Den här metoden för att köra appen fungerar på alla plattformar som har .NET-körningen installerad.

   • HelloWorld.exe (HelloWorld på Linux, inte skapat på macOS.)

     Det här är den ramverksberoende körbara versionen av programmet. Filen är operativsystemspecifik.

   • HelloWorld.pdb (valfritt för distribution)

     Det här är filen med felsökningssymboler. Du behöver inte distribuera den här filen tillsammans med ditt program, men du bör spara den om du behöver felsöka den publicerade versionen av ditt program.

   • HelloWorld.runtimeconfig.json

     Det här är programmets körningskonfigurationsfil. Den identifierar den version av .NET som ditt program har skapats för att köras på. Du kan också lägga till konfigurationsalternativ i den. Mer information finns i Konfigurationsinställningar för .NET-körning.

Kör den publicerade appen

1. Högerklicka på publiceringsmappen i Utforskaren (Ctrl-klicka på macOS) och välj Öppna i terminalen.

   

2. Kör appen i Windows eller Linux med hjälp av den körbara filen.

   1. I Windows anger .\HelloWorld.exe och trycker du på Retur. I Windows med Bash-terminalen anger du ./HelloWorld.exe.

   2. I Linux anger ./HelloWorld och trycker du på Retur.

   3. Ange ett namn som svar på uppmaningen och tryck på valfri tangent för att avsluta.

3. Kör appen på valfri plattform med hjälp dotnet av kommandot :

   1. Ange dotnet HelloWorld.dll och tryck på Retur.

   2. Ange ett namn som svar på uppmaningen och tryck på valfri tangent för att avsluta.

Ytterligare resurser

• Distribution av .NET-program
• Publicera .NET-appar med .NET CLI
• dotnet publish
• Använda .NET SDK i ci-miljöer (continuous integration)

Nästa steg

I den här självstudien publicerade du en konsolapp. I nästa självstudie skapar du ett klassbibliotek.

Skapa ett .NET-klassbibliotek med Visual Studio Code

Den här självstudien visar hur du publicerar en konsolapp så att andra användare kan köra den. Publicering skapar den uppsättning filer som behövs för att köra ett program. Om du vill distribuera filerna kopierar du dem till måldatorn.

.NET CLI används för att publicera appen, så du kan följa den här självstudien med en annan kodredigerare än Visual Studio Code om du vill.

Förutsättningar

• Den här självstudien fungerar med konsolappen som du skapar i Skapa ett .NET-konsolprogram med hjälp av Visual Studio Code.

Publicera appen

1. Starta Visual Studio Code.

2. Öppna projektmappen HelloWorld som du skapade i Skapa ett .NET-konsolprogram med hjälp av Visual Studio Code.

3. Välj Visa>terminal på huvudmenyn.

   Terminalen öppnas i mappen HelloWorld .

4. Kör följande kommando:

   dotnet publish --configuration Release
   

   Standardkonfigurationen för bygget är Felsökning, så det här kommandot anger versionskonfigurationen. Utdata från versionskonfigurationen har minimal symbolisk felsökningsinformation och är helt optimerad.

   Kommandoutdata liknar följande exempel:

   Microsoft (R) Build Engine version 16.7.0+b89cb5fde for .NET
   Copyright (C) Microsoft Corporation. All rights reserved.
     Determining projects to restore...
     All projects are up-to-date for restore.
     HelloWorld -> C:\Projects\HelloWorld\bin\Release\net6.0\HelloWorld.dll
     HelloWorld -> C:\Projects\HelloWorld\bin\Release\net6.0\publish\
   

Granska filerna

Som standard skapar publiceringsprocessen en ramverksberoende distribution, vilket är en typ av distribution där det publicerade programmet körs på en dator som har .NET-körningen installerad. Om du vill köra den publicerade appen kan du använda den körbara filen eller köra dotnet HelloWorld.dll kommandot från en kommandotolk.

I följande steg tittar du på de filer som skapats av publiceringsprocessen.

1. Välj Utforskaren i det vänstra navigeringsfältet.

2. Expandera bin/Release/net6.0/publish.

   

   Som bilden visar innehåller de publicerade utdata följande filer:

   • HelloWorld.deps.json

     Det här är programmets körningsberoendefil. Den definierar .NET-komponenterna och biblioteken (inklusive det dynamiska länkbiblioteket som innehåller ditt program) som behövs för att köra appen. Mer information finns i Körningskonfigurationsfiler.

   • HelloWorld.dll

     Det här är den ramverksberoende distributionsversionen av programmet. Om du vill köra det här dynamiska länkbiblioteket anger du dotnet HelloWorld.dll i en kommandotolk. Den här metoden för att köra appen fungerar på alla plattformar som har .NET-körningen installerad.

   • HelloWorld.exe (HelloWorld på Linux, inte skapat på macOS.)

     Det här är den ramverksberoende körbara versionen av programmet. Filen är operativsystemspecifik.

   • HelloWorld.pdb (valfritt för distribution)

     Det här är filen med felsökningssymboler. Du behöver inte distribuera den här filen tillsammans med ditt program, men du bör spara den om du behöver felsöka den publicerade versionen av ditt program.

   • HelloWorld.runtimeconfig.json

     Det här är programmets körningskonfigurationsfil. Den identifierar den version av .NET som ditt program har skapats för att köras på. Du kan också lägga till konfigurationsalternativ i den. Mer information finns i Konfigurationsinställningar för .NET-körning.

Kör den publicerade appen

1. Högerklicka på publiceringsmappen i Utforskaren (Ctrl-klicka på macOS) och välj Öppna i terminalen.

   

2. Kör appen med hjälp av den körbara filen.

   1. I Windows anger .\HelloWorld.exe och trycker du på Retur.

   2. I Linux eller macOS anger ./HelloWorld och trycker du på Retur.

   3. Ange ett namn som svar på uppmaningen och tryck på valfri tangent för att avsluta.

3. Kör appen på valfri plattform med hjälp dotnet av kommandot :

   1. Ange dotnet HelloWorld.dll och tryck på Retur.

   2. Ange ett namn som svar på uppmaningen och tryck på valfri tangent för att avsluta.

Ytterligare resurser

• Distribution av .NET-program
• Publicera .NET-appar med .NET CLI
• dotnet publish
• Använda .NET SDK i ci-miljöer (continuous integration)

Nästa steg

I den här självstudien publicerade du en konsolapp. I nästa självstudie skapar du ett klassbibliotek.

Skapa ett .NET-klassbibliotek med Visual Studio Code