Esercitazione: Pubblicare un'applicazione console .NET con Visual Studio Code

Questa esercitazione illustra come pubblicare un'app console in modo che altri utenti possano eseguirla. Con la pubblicazione viene creato il set di file necessari per eseguire un'applicazione. Per distribuire i file, copiarli nel computer di destinazione.

L'interfaccia della riga di comando .NET viene usata per pubblicare l'app, quindi puoi seguire questa esercitazione con un editor di codice diverso da Visual Studio Code, se preferisci.

Prerequisiti

Pubblicazione dell'app

  1. Avviare Visual Studio Code.

  2. Aprire la cartella del progetto HelloWorld creato in Creare un'applicazione console .NET con Visual Studio Code.

  3. Scegliere Visualizza>terminale dal menu principale.

    Il terminale viene aperto nella cartella HelloWorld.

  4. Esegui questo comando:

    dotnet publish --configuration Release
    

    La configurazione della build predefinita è Debug, quindi questo comando specifica la configurazione della build di release. L'output della configurazione della build di release contiene informazioni di debug simbolico minime ed è completamente ottimizzato.

    L'output del comando è simile a quello dell'esempio seguente:

    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\
    

Esaminare i file

Per impostazione predefinita, il processo di pubblicazione crea una distribuzione dipendente dal framework, ovvero un tipo di distribuzione in cui l'applicazione pubblicata viene eseguita in un computer in cui è installato il runtime .NET. Per eseguire l'app pubblicata, è possibile usare il file eseguibile o eseguire il comando dotnet HelloWorld.dll da un prompt dei comandi.

Nei passaggi seguenti verranno esaminati i file creati dal processo di pubblicazione.

  1. Selezionare Esplora risorse nella barra di spostamento a sinistra.

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

    Explorer showing published files

    Come illustrato nell'immagine, l'output pubblicato include i file seguenti:

    • HelloWorld.deps.json

      Questo è il file delle dipendenze di runtime dell'applicazione. Definisce i componenti .NET e le librerie (inclusa la libreria di collegamento dinamico che contiene l'applicazione) necessari per l'esecuzione dell'applicazione. Per altre informazioni, vedere File di configurazione del runtime.

    • HelloWorld.dll

      Questa è la versione di distribuzione dell'applicazione dipendente dal framework. Per eseguire questa libreria di collegamento dinamico, digitare dotnet HelloWorld.dll nel prompt dei comandi. Questo metodo di esecuzione dell'app funziona su qualsiasi piattaforma in cui sia installato il runtime .NET.

    • HelloWorld.exe (HelloWorld su Linux o macOS.)

      Si tratta della versione eseguibile dipendente dal framework dell'applicazione. Il file è specifico del sistema operativo.

    • HelloWorld.pdb (facoltativo per la distribuzione)

      Si tratta del file dei simboli di debug. Non è necessario distribuire tale file insieme all'applicazione, anche se è consigliabile salvarlo nel caso in cui sia necessario eseguire il debug della versione pubblicata dell'applicazione.

    • HelloWorld.runtimeconfig.json

      È il file di configurazione di runtime dell'applicazione. Identifica la versione di .NET su cui è stata compilata l'applicazione. È anche possibile aggiungere opzioni di configurazione. Per altre informazioni, vedere Impostazioni di configurazione del runtime .NET.

Eseguire l'app pubblicata

  1. In Esplora risorse fare clic con il pulsante destro del mouse sulla cartella publish (Ctrl+clic su macOS) e scegliere Apri nel terminale integrato.

    Context menu showing Open in Terminal

  2. In Windows o Linux eseguire l'app usando l'eseguibile.

    1. In Windows immettere .\HelloWorld.exe e premere Invio.

    2. In Linux immettere ./HelloWorld e premere Invio.

    3. Immettere un nome in risposta al prompt e premere un tasto qualsiasi per uscire.

  3. In qualsiasi piattaforma eseguire l'app usando il comando dotnet:

    1. Immettere dotnet HelloWorld.dll e premere Invio.

    2. Immettere un nome in risposta al prompt e premere un tasto qualsiasi per uscire.

Risorse aggiuntive

Passaggi successivi

In questa esercitazione è stata pubblicata un'app console. Nell'esercitazione successiva viene creata una libreria di classi.

Questa esercitazione illustra come pubblicare un'app console in modo che altri utenti possano eseguirla. Con la pubblicazione viene creato il set di file necessari per eseguire un'applicazione. Per distribuire i file, copiarli nel computer di destinazione.

L'interfaccia della riga di comando .NET viene usata per pubblicare l'app, quindi puoi seguire questa esercitazione con un editor di codice diverso da Visual Studio Code, se preferisci.

Prerequisiti

Pubblicazione dell'app

  1. Avviare Visual Studio Code.

  2. Aprire la cartella del progetto HelloWorld creato in Creare un'applicazione console .NET con Visual Studio Code.

  3. Scegliere Visualizza>terminale dal menu principale.

    Il terminale viene aperto nella cartella HelloWorld.

  4. Esegui questo comando:

    dotnet publish --configuration Release
    

    La configurazione della build predefinita è Debug, quindi questo comando specifica la configurazione della build di release. L'output della configurazione della build di release contiene informazioni di debug simbolico minime ed è completamente ottimizzato.

    L'output del comando è simile a quello dell'esempio seguente:

    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\
    

Esaminare i file

Per impostazione predefinita, il processo di pubblicazione crea una distribuzione dipendente dal framework, ovvero un tipo di distribuzione in cui l'applicazione pubblicata viene eseguita in un computer in cui è installato il runtime .NET. Per eseguire l'app pubblicata, è possibile usare il file eseguibile o eseguire il comando dotnet HelloWorld.dll da un prompt dei comandi.

Nei passaggi seguenti verranno esaminati i file creati dal processo di pubblicazione.

  1. Selezionare Esplora risorse nella barra di spostamento a sinistra.

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

    Explorer showing published files

    Come illustrato nell'immagine, l'output pubblicato include i file seguenti:

    • HelloWorld.deps.json

      Questo è il file delle dipendenze di runtime dell'applicazione. Definisce i componenti .NET e le librerie (inclusa la libreria di collegamento dinamico che contiene l'applicazione) necessari per l'esecuzione dell'applicazione. Per altre informazioni, vedere File di configurazione del runtime.

    • HelloWorld.dll

      Questa è la versione di distribuzione dell'applicazione dipendente dal framework. Per eseguire questa libreria di collegamento dinamico, digitare dotnet HelloWorld.dll nel prompt dei comandi. Questo metodo di esecuzione dell'app funziona su qualsiasi piattaforma in cui sia installato il runtime .NET.

    • HelloWorld.exe (HelloWorld su Linux, non creato su macOS.)

      Si tratta della versione eseguibile dipendente dal framework dell'applicazione. Il file è specifico del sistema operativo.

    • HelloWorld.pdb (facoltativo per la distribuzione)

      Si tratta del file dei simboli di debug. Non è necessario distribuire tale file insieme all'applicazione, anche se è consigliabile salvarlo nel caso in cui sia necessario eseguire il debug della versione pubblicata dell'applicazione.

    • HelloWorld.runtimeconfig.json

      È il file di configurazione di runtime dell'applicazione. Identifica la versione di .NET su cui è stata compilata l'applicazione. È anche possibile aggiungere opzioni di configurazione. Per altre informazioni, vedere Impostazioni di configurazione del runtime .NET.

Eseguire l'app pubblicata

  1. In Esplora risorse fare clic con il pulsante destro del mouse sulla cartella publish (Ctrl+clic su macOS) e scegliere Apri nel terminale.

    Context menu showing Open in Terminal

  2. In Windows o Linux eseguire l'app usando l'eseguibile.

    1. In Windows immettere .\HelloWorld.exe e premere Invio. In Windows, con il terminale Bash, immettere ./HelloWorld.exe.

    2. In Linux immettere ./HelloWorld e premere Invio.

    3. Immettere un nome in risposta al prompt e premere un tasto qualsiasi per uscire.

  3. In qualsiasi piattaforma eseguire l'app usando il comando dotnet:

    1. Immettere dotnet HelloWorld.dll e premere Invio.

    2. Immettere un nome in risposta al prompt e premere un tasto qualsiasi per uscire.

Risorse aggiuntive

Passaggi successivi

In questa esercitazione è stata pubblicata un'app console. Nell'esercitazione successiva viene creata una libreria di classi.

Questa esercitazione illustra come pubblicare un'app console in modo che altri utenti possano eseguirla. Con la pubblicazione viene creato il set di file necessari per eseguire un'applicazione. Per distribuire i file, copiarli nel computer di destinazione.

L'interfaccia della riga di comando .NET viene usata per pubblicare l'app, quindi puoi seguire questa esercitazione con un editor di codice diverso da Visual Studio Code, se preferisci.

Prerequisiti

Pubblicazione dell'app

  1. Avviare Visual Studio Code.

  2. Aprire la cartella del progetto HelloWorld creato in Creare un'applicazione console .NET con Visual Studio Code.

  3. Scegliere Visualizza>terminale dal menu principale.

    Il terminale viene aperto nella cartella HelloWorld.

  4. Esegui questo comando:

    dotnet publish --configuration Release
    

    La configurazione della build predefinita è Debug, quindi questo comando specifica la configurazione della build di release. L'output della configurazione della build di release contiene informazioni di debug simbolico minime ed è completamente ottimizzato.

    L'output del comando è simile a quello dell'esempio seguente:

    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\
    

Esaminare i file

Per impostazione predefinita, il processo di pubblicazione crea una distribuzione dipendente dal framework, ovvero un tipo di distribuzione in cui l'applicazione pubblicata viene eseguita in un computer in cui è installato il runtime .NET. Per eseguire l'app pubblicata, è possibile usare il file eseguibile o eseguire il comando dotnet HelloWorld.dll da un prompt dei comandi.

Nei passaggi seguenti verranno esaminati i file creati dal processo di pubblicazione.

  1. Selezionare Esplora risorse nella barra di spostamento a sinistra.

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

    Explorer showing published files

    Come illustrato nell'immagine, l'output pubblicato include i file seguenti:

    • HelloWorld.deps.json

      Questo è il file delle dipendenze di runtime dell'applicazione. Definisce i componenti .NET e le librerie (inclusa la libreria di collegamento dinamico che contiene l'applicazione) necessari per l'esecuzione dell'applicazione. Per altre informazioni, vedere File di configurazione del runtime.

    • HelloWorld.dll

      Questa è la versione di distribuzione dell'applicazione dipendente dal framework. Per eseguire questa libreria di collegamento dinamico, digitare dotnet HelloWorld.dll nel prompt dei comandi. Questo metodo di esecuzione dell'app funziona su qualsiasi piattaforma in cui sia installato il runtime .NET.

    • HelloWorld.exe (HelloWorld su Linux, non creato su macOS.)

      Si tratta della versione eseguibile dipendente dal framework dell'applicazione. Il file è specifico del sistema operativo.

    • HelloWorld.pdb (facoltativo per la distribuzione)

      Si tratta del file dei simboli di debug. Non è necessario distribuire tale file insieme all'applicazione, anche se è consigliabile salvarlo nel caso in cui sia necessario eseguire il debug della versione pubblicata dell'applicazione.

    • HelloWorld.runtimeconfig.json

      È il file di configurazione di runtime dell'applicazione. Identifica la versione di .NET su cui è stata compilata l'applicazione. È anche possibile aggiungere opzioni di configurazione. Per altre informazioni, vedere Impostazioni di configurazione del runtime .NET.

Eseguire l'app pubblicata

  1. In Esplora risorse fare clic con il pulsante destro del mouse sulla cartella publish (Ctrl+clic su macOS) e scegliere Apri nel terminale.

    Context menu showing Open in Terminal

  2. Eseguire l'app usando l'eseguibile.

    1. In Windows immettere .\HelloWorld.exe e premere Invio.

    2. In Linux o macOS immettere ./HelloWorld e premere Invio.

    3. Immettere un nome in risposta al prompt e premere un tasto qualsiasi per uscire.

  3. In qualsiasi piattaforma eseguire l'app usando il comando dotnet:

    1. Immettere dotnet HelloWorld.dll e premere Invio.

    2. Immettere un nome in risposta al prompt e premere un tasto qualsiasi per uscire.

Risorse aggiuntive

Passaggi successivi

In questa esercitazione è stata pubblicata un'app console. Nell'esercitazione successiva viene creata una libreria di classi.