Delen via


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

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.

    Explorer showing published files

    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.

    Context menu showing Open 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.

    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

Volgende stappen

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

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

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.

    Explorer showing published files

    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.

    Context menu showing Open 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

Volgende stappen

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

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

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.

    Explorer showing published files

    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.

    Context menu showing Open 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

Volgende stappen

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