Kurz: Publikování konzolové aplikace .NET

V tomto kurzu se dozvíte, jak publikovat konzolovou aplikaci, aby ji mohli spustit jiní uživatelé. Publikování vytvoří sadu souborů potřebných ke spuštění aplikace. Pokud chcete soubory nasadit, zkopírujte je do cílového počítače.

Předpoklady

• Tento kurz funguje s konzolovou aplikací, kterou vytvoříte v Vytvoření konzolové aplikace .NET.

Publikování aplikace

1. Spusťte Visual Studio.

2. Otevřete projekt HelloWorld, který jste vytvořili v Vytvoření konzolové aplikace .NET.

3. Ujistěte se, že Visual Studio používá konfiguraci sestavení Release. V případě potřeby změňte nastavení konfigurace sestavení na panelu nástrojů z ladění na Release.

   panel nástrojů

4. Pravým tlačítkem klikněte na projekt HelloWorld (nikoliv na řešení HelloWorld) a v nabídce vyberte Publikovat.

   

5. Na kartě Cíl na stránce Publikovat vyberte Složkaa poté vyberte Další.

   

6. Na kartě Konkrétní cíl na stránce Publikovat vyberte Složkaa poté vyberte Další.

   

7. Na kartě Umístění na stránce Publikovat vyberte Dokončit.

   

8. Na stránce Průběh vytváření profilu publikování vyberte Zavřít.

9. Na záložce Publikovat v okně Publikovat klikněte na Publikovat.

   

1. Spusťte Visual Studio Code.

2. Otevřete složku projektu HelloWorld, kterou jste vytvořili v Vytvoření konzolové aplikace .NET.

3. V hlavní nabídce zvolte Zobrazit>Terminál.

   Terminál se otevře ve složce HelloWorld.

4. Spusťte následující příkaz:

   dotnet publish
   

   Výchozí konfigurace sestavení je verze, která je vhodná pro nasazenou lokalitu spuštěnou v produkčním prostředí. Výstup konfigurace sestavení vydané verze obsahuje minimální symbolické informace o ladění a je plně optimalizovaný.

   Výstup příkazu je podobný následujícímu příkladu:

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

1. Otevřete GitHub Codespace, který jste vytvořili v Vytvoření konzolové aplikace .NET.

2. Na začátek HelloWorld.cs přidejte následující řádek kódu:

   #:property PublishAot=false
   

   Tato direktiva vlastností zakáže nativní předčasnou (AOT) kompilaci a aplikace použije standardní kompilátor za běhu (JIT). Publikovaný výstup bude závislý na rozhraní.

3. V terminálu se ujistěte, že jste ve složce tutorials .

4. Spusťte následující příkaz:

   dotnet publish HelloWorld.cs
   

   Příkaz vytvoří nezávislý spustitelný soubor.

   Výstup příkazu je podobný následujícímu příkladu:

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

Kontrola souborů

Ve výchozím nastavení proces publikování vytvoří nasazení závislé na rozhraní, což je typ nasazení, ve kterém publikovaná aplikace běží na počítači, na kterém je nainstalovaný modul runtime .NET. Uživatelé mohou publikovanou aplikaci spustit poklikáním na spustitelný soubor nebo vydáním příkazu dotnet HelloWorld.dll z příkazového řádku.

V následujících krocích se podíváte na soubory vytvořené procesem publikování.

1. V Solution Explorer vyberte Show All Files.

   

2. Ve složce projektu rozbalte bin/Release/{net}/publish. (Kde {net} je cílová složka frameworku, například net10.0.)

   

   Jak ukazuje obrázek, publikovaný výstup obsahuje následující soubory:

   • HelloWorld.deps.json

     Toto je soubor závislostí modulu runtime aplikace. Definuje .NET komponenty a knihovny (včetně knihovny dynamického propojení obsahující vaši aplikaci) potřebné ke spuštění aplikace. Další informace najdete v části Konfigurační soubory modulu runtime.

   • HelloWorld.dll

     Toto je verze aplikace pro nasazení závislé na rozhraní. Chcete-li spustit tuto dynamickou knihovnu propojení, zadejte dotnet HelloWorld.dll na příkazovém řádku. Tato metoda spuštění aplikace funguje na všech platformách s nainstalovaným modulem .NET runtime.

   • HelloWorld.exe

     Toto je verze aplikace jako spustitelný soubor závislý na frameworku. Pokud ho chcete spustit, zadejte HelloWorld.exe na příkazovém řádku. Soubor je specifický pro operační systém.

   • HelloWorld.pdb (volitelné pro nasazení)

     Toto je soubor ladicích symbolů. Tento soubor spolu s aplikací nemusíte nasazovat, i když byste ho měli uložit v případě, že potřebujete ladit publikovanou verzi aplikace.

   • HelloWorld.runtimeconfig.json

     Toto je konfigurační soubor modulu runtime aplikace. Identifikuje verzi .NET, ve které byla vaše aplikace vytvořená tak, aby běžela. Můžete do ní také přidat možnosti konfigurace. Další informace najdete v části konfigurační nastavení modulu .NET runtime.

Ve výchozím nastavení proces publikování vytvoří nasazení závislé na rozhraní, což je typ nasazení, ve kterém publikovaná aplikace běží na počítači, na kterém je nainstalovaný modul runtime .NET. Ke spuštění publikované aplikace můžete použít spustitelný soubor nebo spustit příkaz dotnet HelloWorld.dll z příkazového řádku.

V následujících krocích se podíváte na soubory vytvořené procesem publikování.

1. V levém navigačním panelu vyberte Průzkumníka.

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

   

   Jak ukazuje obrázek, publikovaný výstup obsahuje následující soubory:

   • HelloWorld.deps.json

     Toto je soubor závislostí modulu runtime aplikace. Definuje .NET komponenty a knihovny (včetně knihovny dynamického propojení obsahující vaši aplikaci) potřebné ke spuštění aplikace. Další informace najdete v části Konfigurační soubory modulu runtime.

   • HelloWorld.dll

     Toto je verze aplikace pro nasazení závislé na rozhraní. Chcete-li spustit tuto dynamickou knihovnu odkazů, zadejte dotnet HelloWorld.dll na příkazovém řádku. Tato metoda spuštění aplikace funguje na všech platformách s nainstalovaným modulem .NET runtime.

   • HelloWorld.exe ( HelloWorld v Linuxu nebo macOS.)

     Toto je verze aplikace jako spustitelný soubor závislý na frameworku. Soubor je specifický pro operační systém.

   • HelloWorld.pdb (volitelné pro nasazení)

     Toto je soubor ladicích symbolů. Tento soubor spolu s aplikací nemusíte nasazovat, i když byste ho měli uložit v případě, že potřebujete ladit publikovanou verzi aplikace.

   • HelloWorld.runtimeconfig.json

     Toto je konfigurační soubor modulu runtime aplikace. Identifikuje verzi .NET, ve které byla vaše aplikace vytvořená tak, aby běžela. Můžete do ní také přidat možnosti konfigurace. Další informace viz nastavení konfigurace modulu runtime .NET.

Pro jednosložkovou aplikaci proces publikování vytvoří adresář artefaktů s kompilovaným souborem sestavení. Publikovanou aplikaci je možné spustit pomocí dotnet příkazu.

V následujících krocích se podíváte na soubory vytvořené procesem publikování.

1. V levém navigačním panelu vyberte Průzkumníka.

2. Rozšiřte artefakty/HelloWorld.

   

   Jak ukazuje obrázek, publikovaný výstup obsahuje následující soubory:

   • Helloworld

     Toto je verze aplikace jako spustitelný soubor závislý na frameworku. Soubor je specifický pro operační systém. Codespaces běží v Linuxu, takže jde o spustitelný soubor Linuxu.

   • HelloWorld.deps.json

     Toto je soubor závislostí modulu runtime aplikace. Definuje .NET komponenty a knihovny (včetně knihovny dynamického propojení obsahující vaši aplikaci) potřebné ke spuštění aplikace. Další informace najdete v části Konfigurační soubory modulu runtime.

   • HelloWorld.dll

     Toto je verze aplikace pro nasazení závislé na rozhraní. Chcete-li spustit tuto dynamickou knihovnu odkazů, zadejte dotnet HelloWorld.dll na příkazovém řádku. Tato metoda spuštění aplikace funguje na všech platformách s nainstalovaným modulem .NET runtime.

   • HelloWorld.pdb (volitelné pro nasazení)

     Toto je soubor ladicích symbolů. Tento soubor spolu s aplikací nemusíte nasazovat, i když byste ho měli uložit v případě, že potřebujete ladit publikovanou verzi aplikace.

   • HelloWorld.runtimeconfig.json

     Toto je konfigurační soubor modulu runtime aplikace. Identifikuje verzi .NET, ve které byla vaše aplikace vytvořená tak, aby běžela. Můžete do ní také přidat možnosti konfigurace. Další informace najdete v tématu Konfigurace modulu runtime .NET.

   Klikněte pravým tlačítkem myši a vyberte Stáhnout... a stáhněte soubory z Codespaces do místního počítače.

Spuštění publikované aplikace

1. V Solution Explorer klikněte pravým tlačítkem na složku publish a vyberte Copy Full Path.

2. Otevřete příkazový řádek a přejděte do složky publikovat. Uděláte to tak, že zadáte cd a vložíte úplnou cestu. Například:

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

3. Spusťte aplikaci pomocí spustitelného souboru:

   1. Enter HelloWorld.exe a stiskněte Enter.

   2. Zadejte název v odpovědi na výzvu a stisknutím libovolné klávesy ji ukončete.

4. Spusťte aplikaci pomocí příkazu dotnet:

   1. Enter dotnet HelloWorld.dll a stiskněte Enter.

   2. Zadejte název v odpovědi na výzvu a stisknutím libovolné klávesy ji ukončete.

1. V Explorerklikněte pravým tlačítkem na složku publish (na macOS stiskněteCtrla klikněte) a vyberte Otevřít v integrovaném terminálu.

   místní nabídka

2. V Windows nebo Linuxu spusťte aplikaci pomocí spustitelného souboru.

   1. Na Windows zadejte .\HelloWorld.exe a stiskněte Enter.

   2. V Linuxu zadejte ./HelloWorld a stiskněte klávesu Enter.

   3. Zadejte název v odpovědi na výzvu a stisknutím klávesy Enter ukončete.

3. Na libovolné platformě spusťte aplikaci pomocí příkazu dotnet:

   1. Enter dotnet HelloWorld.dll a stiskněte Enter.

   2. Zadejte název v odpovědi na výzvu a stisknutím klávesy Enter ukončete.

1. V Průzkumníku klikněte pravým tlačítkem na artefakty nebo složku HelloWorld a vyberte Otevřít v integrovaném terminálu.

2. Spusťte aplikaci pomocí spustitelného souboru. Enter ./HelloWorld a pak stiskněte Enter.

3. Zadejte název v odpovědi na výzvu a stisknutím klávesy Enter ukončete.

Dodatečné zdroje

• .NET přehled publikování aplikací
• dotnet publish
• Použití sady .NET SDK v prostředích kontinuální integrace

Úklid zdrojů

GitHub automaticky odstraní váš Codespace po 30 dnech nečinnosti. Pokud plánujete prozkoumat další tutoriály z této série, můžete ponechat Codespace zřízený. Pokud jste připraveni navštívit web .NET ke stažení sady .NET SDK, můžete svůj Codespace odstranit. Pokud chcete odstranit Codespace, otevřete okno prohlížeče a přejděte do služby Codespaces. V okně se zobrazí seznam Codespaces. Vyberte tři tečky (...) v položce naučného výukového prostředí codespace. Pak vyberte Odstranit.

Další kroky

V tomto kurzu jste zveřejnili konzolovou aplikaci. V dalším kurzu vytvoříte knihovnu tříd.

Vytvoření knihovny tříd .NET