Zelfstudie: Een .NET-consoletoepassing publiceren met Visual Studio Code

Deze zelfstudie laat zien hoe u een console-app publiceert, zodat andere gebruikers deze kunnen uitvoeren. Publiceren maakt de set bestanden die nodig zijn om een toepassing uit te voeren. Als u de bestanden wilt implementeren, kopieert u deze naar de doelcomputer.

De .NET CLI wordt gebruikt om de app te publiceren, zodat u deze zelfstudie kunt volgen met een andere code-editor dan Visual Studio Code als u wilt.

Vereisten

• Deze zelfstudie werkt met de console-app die u maakt in Een .NET-consoletoepassing maken met behulp van Visual Studio Code.

Publiceer de app.

1. Visual Studio Code starten.

2. Open de projectmap HelloWorld die u hebt gemaakt in Een .NET-consoletoepassing maken met Visual Studio Code.

3. Kies Terminal weergeven>in het hoofdmenu.

   De terminal wordt geopend in de map HelloWorld .

4. Voer de volgende opdracht uit:

   dotnet publish --configuration Release
   

   De standaard buildconfiguratie is Foutopsporing, dus met deze opdracht wordt de buildconfiguratie van de release opgegeven. De uitvoer van de buildconfiguratie van de release bevat minimale symbolische foutopsporingsgegevens en is volledig geoptimaliseerd.

   De uitvoer van de opdracht is vergelijkbaar met het volgende voorbeeld:

   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\
   

De bestanden controleren

Het publicatieproces maakt standaard een frameworkafhankelijke implementatie. Dit is een type implementatie waarin de gepubliceerde toepassing wordt uitgevoerd op een computer waarop de .NET-runtime is geïnstalleerd. Als u de gepubliceerde app wilt uitvoeren, kunt u het uitvoerbare bestand gebruiken of de dotnet HelloWorld.dll opdracht uitvoeren vanaf een opdrachtprompt.

In de volgende stappen bekijkt u de bestanden die zijn gemaakt door het publicatieproces.

1. Selecteer de Verkenner in de linkernavigatiebalk.

2. Vouw bin/Release/net7.0/publish uit.

   

   Zoals in de afbeelding wordt weergegeven, bevat de gepubliceerde uitvoer de volgende bestanden:

   • HelloWorld.deps.json

     Dit is het runtime-afhankelijkhedenbestand van de toepassing. Hiermee worden de .NET-onderdelen en de bibliotheken (inclusief de dynamische koppelingsbibliotheek die uw toepassing bevat) gedefinieerd die nodig zijn om de app uit te voeren. Zie Runtime-configuratiebestanden voor meer informatie.

   • HelloWorld.dll

     Dit is de frameworkafhankelijke implementatieversie van de toepassing. Als u deze dynamische koppelingsbibliotheek wilt uitvoeren, voert dotnet HelloWorld.dll u deze in bij een opdrachtprompt. Deze methode voor het uitvoeren van de app werkt op elk platform waarop de .NET-runtime is geïnstalleerd.

   • HelloWorld.exe (HelloWorld op Linux of macOS.)

     Dit is de frameworkafhankelijke uitvoerbare versie van de toepassing. Het bestand is besturingssysteemspecifiek.

   • HelloWorld.pdb (optioneel voor implementatie)

     Dit is het bestand met symbolen voor foutopsporing. U hoeft dit bestand niet samen met uw toepassing te implementeren, hoewel u het moet opslaan in het geval dat u fouten moet opsporen in de gepubliceerde versie van uw toepassing.

   • HelloWorld.runtimeconfig.json

     Dit is het runtimeconfiguratiebestand van de toepassing. Hiermee wordt de versie van .NET geïdentificeerd waarop uw toepassing is gebouwd om op uit te voeren. U kunt er ook configuratieopties aan toevoegen. Zie .NET Runtime-configuratie-instellingen voor meer informatie.

De gepubliceerde app uitvoeren

1. Klik in Explorer met de rechtermuisknop op de publicatiemap (Ctrl-klik op macOS) en selecteer Openen in geïntegreerde terminal.

   

2. Voer in Windows of Linux de app uit met behulp van het uitvoerbare bestand.

   1. Voer in Windows enter .\HelloWorld.exe in en druk op Enter.

   2. In Linux voert u Enter in ./HelloWorld en drukt u op Enter.

   3. Voer een naam in als reactie op de prompt en druk op een willekeurige toets om af te sluiten.

3. Voer op elk platform de app uit met behulp van de dotnet opdracht:

   1. Enter en druk op Enterdotnet HelloWorld.dll.

   2. Voer een naam in als reactie op de prompt en druk op een willekeurige toets om af te sluiten.

Aanvullende bronnen

• .NET-toepassingsimplementatie
• .NET-apps publiceren met de .NET CLI
• dotnet publish
• De .NET SDK gebruiken in CI-omgevingen (continue integratie)

Volgende stappen

In deze zelfstudie hebt u een console-app gepubliceerd. In de volgende zelfstudie maakt u een klassebibliotheek.

Een .NET-klassebibliotheek maken met Visual Studio Code

Deze zelfstudie laat zien hoe u een console-app publiceert, zodat andere gebruikers deze kunnen uitvoeren. Publiceren maakt de set bestanden die nodig zijn om een toepassing uit te voeren. Als u de bestanden wilt implementeren, kopieert u deze naar de doelcomputer.

De .NET CLI wordt gebruikt om de app te publiceren, zodat u deze zelfstudie kunt volgen met een andere code-editor dan Visual Studio Code als u wilt.

Vereisten

• Deze zelfstudie werkt met de console-app die u maakt in Een .NET-consoletoepassing maken met behulp van Visual Studio Code.

Publiceer de app.

1. Visual Studio Code starten.

2. Open de projectmap HelloWorld die u hebt gemaakt in Een .NET-consoletoepassing maken met Visual Studio Code.

3. Kies Terminal weergeven>in het hoofdmenu.

   De terminal wordt geopend in de map HelloWorld .

4. Voer de volgende opdracht uit:

   dotnet publish --configuration Release
   

   De standaard buildconfiguratie is Foutopsporing, dus met deze opdracht wordt de buildconfiguratie van de release opgegeven. De uitvoer van de buildconfiguratie van de release bevat minimale symbolische foutopsporingsgegevens en is volledig geoptimaliseerd.

   De uitvoer van de opdracht is vergelijkbaar met het volgende voorbeeld:

   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\
   

De bestanden controleren

Het publicatieproces maakt standaard een frameworkafhankelijke implementatie. Dit is een type implementatie waarin de gepubliceerde toepassing wordt uitgevoerd op een computer waarop de .NET-runtime is geïnstalleerd. Als u de gepubliceerde app wilt uitvoeren, kunt u het uitvoerbare bestand gebruiken of de dotnet HelloWorld.dll opdracht uitvoeren vanaf een opdrachtprompt.

In de volgende stappen bekijkt u de bestanden die zijn gemaakt door het publicatieproces.

1. Selecteer de Verkenner in de linkernavigatiebalk.

2. Vouw bin/Release/net7.0/publish uit.

   

   Zoals in de afbeelding wordt weergegeven, bevat de gepubliceerde uitvoer de volgende bestanden:

   • HelloWorld.deps.json

     Dit is het runtime-afhankelijkhedenbestand van de toepassing. Hiermee worden de .NET-onderdelen en de bibliotheken (inclusief de dynamische koppelingsbibliotheek die uw toepassing bevat) gedefinieerd die nodig zijn om de app uit te voeren. Zie Runtime-configuratiebestanden voor meer informatie.

   • HelloWorld.dll

     Dit is de frameworkafhankelijke implementatieversie van de toepassing. Als u deze dynamische koppelingsbibliotheek wilt uitvoeren, voert dotnet HelloWorld.dll u deze in bij een opdrachtprompt. Deze methode voor het uitvoeren van de app werkt op elk platform waarop de .NET-runtime is geïnstalleerd.

   • HelloWorld.exe (HelloWorld op Linux, niet gemaakt in macOS.)

     Dit is de frameworkafhankelijke uitvoerbare versie van de toepassing. Het bestand is besturingssysteemspecifiek.

   • HelloWorld.pdb (optioneel voor implementatie)

     Dit is het bestand met symbolen voor foutopsporing. U hoeft dit bestand niet samen met uw toepassing te implementeren, hoewel u het moet opslaan in het geval dat u fouten moet opsporen in de gepubliceerde versie van uw toepassing.

   • HelloWorld.runtimeconfig.json

     Dit is het runtimeconfiguratiebestand van de toepassing. Hiermee wordt de versie van .NET geïdentificeerd waarop uw toepassing is gebouwd om op uit te voeren. U kunt er ook configuratieopties aan toevoegen. Zie .NET Runtime-configuratie-instellingen voor meer informatie.

De gepubliceerde app uitvoeren

1. Klik in Explorer met de rechtermuisknop op de publicatiemap (Ctrl-klik op macOS) en selecteer Openen in Terminal.

   

2. Voer in Windows of Linux de app uit met behulp van het uitvoerbare bestand.

   1. Voer in Windows enter .\HelloWorld.exe in en druk op Enter. Voer in Windows met de Bash-terminal het volgende in ./HelloWorld.exe.

   2. In Linux voert u Enter in ./HelloWorld en drukt u op Enter.

   3. Voer een naam in als reactie op de prompt en druk op een willekeurige toets om af te sluiten.

3. Voer op elk platform de app uit met behulp van de dotnet opdracht:

   1. Enter en druk op Enterdotnet HelloWorld.dll.

   2. Voer een naam in als reactie op de prompt en druk op een willekeurige toets om af te sluiten.

Aanvullende bronnen

• .NET-toepassingsimplementatie
• .NET-apps publiceren met de .NET CLI
• dotnet publish
• De .NET SDK gebruiken in CI-omgevingen (continue integratie)

Volgende stappen

In deze zelfstudie hebt u een console-app gepubliceerd. In de volgende zelfstudie maakt u een klassebibliotheek.

Een .NET-klassebibliotheek maken met Visual Studio Code

Deze zelfstudie laat zien hoe u een console-app publiceert, zodat andere gebruikers deze kunnen uitvoeren. Publiceren maakt de set bestanden die nodig zijn om een toepassing uit te voeren. Als u de bestanden wilt implementeren, kopieert u deze naar de doelcomputer.

De .NET CLI wordt gebruikt om de app te publiceren, zodat u deze zelfstudie kunt volgen met een andere code-editor dan Visual Studio Code als u wilt.

Vereisten

• Deze zelfstudie werkt met de console-app die u maakt in Een .NET-consoletoepassing maken met behulp van Visual Studio Code.

Publiceer de app.

1. Visual Studio Code starten.

2. Open de projectmap HelloWorld die u hebt gemaakt in Een .NET-consoletoepassing maken met Visual Studio Code.

3. Kies Terminal weergeven>in het hoofdmenu.

   De terminal wordt geopend in de map HelloWorld .

4. Voer de volgende opdracht uit:

   dotnet publish --configuration Release
   

   De standaard buildconfiguratie is Foutopsporing, dus met deze opdracht wordt de buildconfiguratie van de release opgegeven. De uitvoer van de buildconfiguratie van de release bevat minimale symbolische foutopsporingsgegevens en is volledig geoptimaliseerd.

   De uitvoer van de opdracht is vergelijkbaar met het volgende voorbeeld:

   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\
   

De bestanden controleren

Het publicatieproces maakt standaard een frameworkafhankelijke implementatie. Dit is een type implementatie waarin de gepubliceerde toepassing wordt uitgevoerd op een computer waarop de .NET-runtime is geïnstalleerd. Als u de gepubliceerde app wilt uitvoeren, kunt u het uitvoerbare bestand gebruiken of de dotnet HelloWorld.dll opdracht uitvoeren vanaf een opdrachtprompt.

In de volgende stappen bekijkt u de bestanden die zijn gemaakt door het publicatieproces.

1. Selecteer de Verkenner in de linkernavigatiebalk.

2. Vouw bin/Release/net6.0/publish uit.

   

   Zoals in de afbeelding wordt weergegeven, bevat de gepubliceerde uitvoer de volgende bestanden:

   • HelloWorld.deps.json

     Dit is het runtime-afhankelijkhedenbestand van de toepassing. Hiermee worden de .NET-onderdelen en de bibliotheken (inclusief de dynamische koppelingsbibliotheek die uw toepassing bevat) gedefinieerd die nodig zijn om de app uit te voeren. Zie Runtime-configuratiebestanden voor meer informatie.

   • HelloWorld.dll

     Dit is de frameworkafhankelijke implementatieversie van de toepassing. Als u deze dynamische koppelingsbibliotheek wilt uitvoeren, voert dotnet HelloWorld.dll u deze in bij een opdrachtprompt. Deze methode voor het uitvoeren van de app werkt op elk platform waarop de .NET-runtime is geïnstalleerd.

   • HelloWorld.exe (HelloWorld op Linux, niet gemaakt in macOS.)

     Dit is de frameworkafhankelijke uitvoerbare versie van de toepassing. Het bestand is besturingssysteemspecifiek.

   • HelloWorld.pdb (optioneel voor implementatie)

     Dit is het bestand met symbolen voor foutopsporing. U hoeft dit bestand niet samen met uw toepassing te implementeren, hoewel u het moet opslaan in het geval dat u fouten moet opsporen in de gepubliceerde versie van uw toepassing.

   • HelloWorld.runtimeconfig.json

     Dit is het runtimeconfiguratiebestand van de toepassing. Hiermee wordt de versie van .NET geïdentificeerd waarop uw toepassing is gebouwd om op uit te voeren. U kunt er ook configuratieopties aan toevoegen. Zie .NET Runtime-configuratie-instellingen voor meer informatie.

De gepubliceerde app uitvoeren

1. Klik in Explorer met de rechtermuisknop op de publicatiemap (Ctrl-klik op macOS) en selecteer Openen in Terminal.

   

2. Voer de app uit met behulp van het uitvoerbare bestand.

   1. Voer in Windows enter .\HelloWorld.exe in en druk op Enter.

   2. Voer in Linux of macOS enter ./HelloWorld en druk op Enter.

   3. Voer een naam in als reactie op de prompt en druk op een willekeurige toets om af te sluiten.

3. Voer op elk platform de app uit met behulp van de dotnet opdracht:

   1. Enter en druk op Enterdotnet HelloWorld.dll.

   2. Voer een naam in als reactie op de prompt en druk op een willekeurige toets om af te sluiten.

Aanvullende bronnen

• .NET-toepassingsimplementatie
• .NET-apps publiceren met de .NET CLI
• dotnet publish
• De .NET SDK gebruiken in CI-omgevingen (continue integratie)

Volgende stappen

In deze zelfstudie hebt u een console-app gepubliceerd. In de volgende zelfstudie maakt u een klassebibliotheek.

Een .NET-klassebibliotheek maken met Visual Studio Code