Condividi tramite

Esercitazione: Pubblicare un'applicazione console .NET

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.

Prerequisiti

Pubblicazione dell'app

  1. Avviare Visual Studio.

  2. Aprire il progetto HelloWorld creato in Creare un'applicazione console .NET.

  3. Assicurarsi che Visual Studio stia usando la configurazione della build di rilascio. Se necessario, modificare l'impostazione di configurazione della compilazione sulla barra degli strumenti da Debug a Release.

    Barra degli strumenti di Visual Studio con compilazione di rilascio selezionata.

  4. Fare clic con il pulsante destro del mouse sul progetto HelloWorld (non sulla soluzione HelloWorld) e scegliere Pubblica dal menu.

    Visual Studio Menu di scelta rapida Pubblica.

  5. Nella scheda Destinazione della pagina Pubblica selezionare Cartellae quindi selezionare Avanti.

    Pick una destinazione di pubblicazione in Visual Studio.

  6. Nella scheda Destinazione specifica della pagina Pubblica, selezionare Cartellae quindi selezionare Avanti.

    Pick la destinazione di pubblicazione specifica in Visual Studio.

  7. Nella scheda Percorso della pagina Pubblica selezionare Fine.

    Scheda Percorso nella pagina di pubblicazione di Visual Studio.

  8. Nella pagina stato di creazione del profilo di pubblicazione, selezionare Chiudi.

  9. Nella scheda Pubblica della finestra Pubblica, selezionare Pubblica.

    Visual Studio Publish window.

  1. Avvia Visual Studio Code.

  2. Aprire la cartella di progetto HelloWorld creata in Creare un'applicazione console .NET.

  3. Scegliere Visualizzaterminale 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:

    Restore complete (1.1s)
  HelloWorld net10.0 succeeded (7.8s) → bin\Release\net10.0\publish\

Build succeeded in 10.3s

  1. Aprire il GitHub Codespace creato in Creare un'applicazione console .NET.

  2. Aggiungere la riga di codice seguente all'inizio di HelloWorld.cs:

    #:property PublishAot=false

    Questa direttiva di proprietà disabilita la compilazione AOT (Ahead-of-Time) nativa e l'app userà il compilatore JIT (Just-In-Time) standard in fase di esecuzione. L'output pubblicato sarà dipendente dal framework.

  3. Nel terminale assicurarsi di essere nella cartella tutorials .

  4. Esegui questo comando:

    dotnet publish HelloWorld.cs

    Il comando crea un eseguibile indipendente.

    L'output del comando è simile all'esempio seguente:

    Restore complete (0.5s)
  HelloWorld net10.0 succeeded (4.0s) → artifacts\HelloWorld\

Build succeeded in 5.1s

Esamina 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. Gli utenti possono eseguire l'app pubblicata facendo doppio clic sul file eseguibile o eseguendo il comando da un prompt dei comandi.

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

  1. In Esplora soluzioni selezionare Show All Files.

    Esplora soluzioni opzione mostra tutti i file.

  2. Nella cartella del progetto espandere bin/Release/{net}/publish. Dove {net} è la cartella del framework di destinazione, ad esempio net10.0.

    Esplora soluzioni 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 ulteriori informazioni, consultare File di configurazione di esecuzione.

    • HelloWorld.dll

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

    • HelloWorld.exe

      Si tratta della versione dell'applicazione eseguibile dipendente dal framework . Per eseguirlo, inserire al prompt dei comandi. 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 .NET impostazioni di configurazione del runtime.

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 da un prompt dei comandi.

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

  1. Selezionare l'Esploratore nella barra di navigazione a sinistra.

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

    Esplora file 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 ulteriori informazioni, consultare File di configurazione di esecuzione.

    • HelloWorld.dll

      Questa è la versione dell'applicazione dipendente dal framework. Per eseguire questa libreria di collegamenti dinamici, inserire un comando al prompt dei comandi. Questo metodo di esecuzione dell'app funziona su qualsiasi piattaforma in cui sia installato il runtime .NET.

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

      Si tratta della versione dell'applicazione eseguibile dipendente dal framework . 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 .NET impostazioni di configurazione del runtime.

Per un'applicazione a file singolo, il processo di pubblicazione crea una cartella artifacts con un file assembly compilato. L'applicazione pubblicata può essere eseguita usando il comando .

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

  1. Selezionare Esplora nella barra di navigazione a sinistra.

  2. Espandi artifacts/HelloWorld.

    Esplora risorse che mostra i file pubblicati

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

    • Helloworld

      Si tratta della versione dell'applicazione eseguibile dipendente dal framework . Il file è specifico del sistema operativo. Codespaces gira su Linux, quindi è un eseguibile Linux.

    • 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 ulteriori informazioni, consultare File di configurazione di esecuzione.

    • HelloWorld.dll

      Questa è la versione dell'applicazione dipendente dal framework. Per eseguire questa libreria di collegamenti dinamici, immettere al prompt dei comandi. Questo metodo di esecuzione dell'app funziona su qualsiasi piattaforma in cui sia installato il runtime .NET.

    • 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 .NET impostazioni di configurazione del runtime.

    Fare clic con il pulsante destro del mouse e scegliere Scarica per scaricare i file da Codespaces nel computer locale.

Eseguire l'app pubblicata

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sulla cartella publish e selezionare Copy Full Path.

  2. Aprire un prompt dei comandi e navigare alla cartella publish. Per fare ciò, immettere e quindi incollare il percorso completo. Per esempio:

    cd C:\Projects\HelloWorld\bin\Release\net10.0\publish\

  3. Avvia l'app utilizzando il file eseguibile:

    1. Immettere e premere INVIO.

    2. Inserisci un nome in risposta al prompt e premi un tasto qualsiasi per uscire.

  4. Eseguire l'app usando il comando :

    1. Immettere e premere INVIO.

    2. Inserisci un nome in risposta al prompt e premi un tasto qualsiasi per uscire.

  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 contestuale 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 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 comando :

    1. Immettere e premere INVIO.

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

  1. In Esplora risorse fare clic con il pulsante destro del mouse sulla cartella artefatti/HelloWorld e scegliere Apri nel terminale integrato.

  2. Eseguire l'app usando l'eseguibile. Immettere e quindi premere INVIO.

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

Risorse aggiuntive

Risorse di pulizia

GitHub elimina automaticamente codespace dopo 30 giorni di inattività. Se hai intenzione di esplorare altre esercitazioni in questa serie, puoi mantenere attivo il tuo Codespace. Se si è pronti per visitare il sito .NET per scaricare .NET SDK, è possibile eliminare codespace. Per eliminare Codespace, aprire una finestra del browser e passare a Codespaces. Nella finestra viene visualizzato un elenco degli spazi di codice. Selezionare i tre puntini () nella voce dello spazio di codice del tutorial Learn. Selezionare quindi "Elimina".

Passaggi successivi

In questa esercitazione, hai pubblicato un'app console. Nella prossima esercitazione, creerai una libreria di classi.

Creare una libreria di classi .NET

  • Last updated on