Condividi tramite


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. La pubblicazione crea il set di file necessari per eseguire un'applicazione. Per distribuire i file, copiarli nel computer di destinazione.

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

Prerequisiti

Pubblicazione dell'app

  1. Avviare Visual Studio Code.

  2. Aprire la cartella del progetto HelloWorld creata 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
    

    La configurazione di compilazione predefinita è Release, appropriata per un sito distribuito in esecuzione nell'ambiente di produzione. L'output della configurazione della build di rilascio ha informazioni di debug simbolico minime ed è completamente ottimizzato.

    L'output del comando è simile all'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 dotnet HelloWorld.dll comando 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/net8.0/publish.

    Esplora risorse che mostra i file pubblicati

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

    • HelloWorld.deps.json

      Si tratta del file di dipendenze di runtime dell'applicazione. Definisce i componenti .NET e le librerie (inclusa la libreria di collegamento dinamico che contiene l'applicazione) necessarie per eseguire l'app. Per altre informazioni, vedere File di configurazione di runtime.

    • HelloWorld.dll

      Si tratta della versione di distribuzione dipendente dal framework dell'applicazione. Per eseguire questa libreria di collegamenti dinamici, immettere dotnet HelloWorld.dll al prompt dei comandi. Questo metodo di esecuzione dell'app funziona su qualsiasi piattaforma in cui è installato il runtime .NET.

    • HelloWorld.exe (HelloWorld in 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 questo file insieme all'applicazione, anche se è necessario salvarlo nel caso in cui sia necessario eseguire il debug della versione pubblicata dell'applicazione.

    • HelloWorld.runtimeconfig.json

      Si tratta del file di configurazione di runtime dell'applicazione. Identifica la versione di .NET in cui è stata compilata l'applicazione per l'esecuzione. È 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.

    Menu di scelta rapida che mostra Apri nel terminale

  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 INVIO per uscire.

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

    1. Immettere dotnet HelloWorld.dll e premere INVIO.

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

Risorse aggiuntive

Passaggi successivi

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