Kurz: Publikování konzolové aplikace .NET pomocí editoru Visual Studio Code

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.

Rozhraní příkazového řádku .NET slouží k publikování aplikace.

Požadavky

• Tento kurz funguje s konzolovou aplikací, kterou vytvoříte v Vytvoření konzolové aplikace .NET pomocí nástroje Visual Studio Code.

Publikování aplikace

1. Spusťte Visual Studio Code.

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

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 prostředí GitHub Codespace, které jste vytvořili v nástroji Vytvoření konzolové aplikace .NET pomocí editoru Visual Studio Code.

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 s nainstalovaným modulem 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 komponenty .NET 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 libovolné platformě s nainstalovaným modulem runtime .NET.

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

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

   • HelloWorld.pdb (volitelné pro nasazení)

     Toto je soubor symbolů ladění. 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 rozhraní .NET, na které byla vaše aplikace vytvořená, aby běžela. Můžete do ní také přidat možnosti konfigurace. Pro více informací viz nastavení konfigurace prostředí .NET runtime.

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 spustitelný soubor závislý na rozhraní verze aplikace. 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 komponenty .NET 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 libovolné platformě s nainstalovaným modulem runtime .NET.

   • HelloWorld.pdb (volitelné pro nasazení)

     Toto je soubor symbolů ladění. 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 rozhraní .NET, na které byla vaše aplikace vytvořená, aby běžela. Můžete do ní také přidat možnosti konfigurace. Pro více informací viz nastavení konfigurace prostředí .NET runtime.

   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 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. Ve Windows nebo Linuxu spusťte aplikaci pomocí spustitelného souboru.

   1. Ve 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. Zadejte 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.

Další zdroje informací

• Přehled publikování aplikací .NET
• dotnet publish
• použití sady .NET SDK v prostředích kontinuální integrace (CI)

Ú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 odstranit svůj Codespace. 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 publikovali konzolovou aplikaci. V dalším kurzu vytvoříte knihovnu tříd.

Vytvoření knihovny tříd .NET pomocí editoru Visual Studio Code