Samouczek: publikowanie aplikacji konsolowej .NET przy użyciu programu Visual Studio Code

Ten samouczek pokazuje, jak opublikować aplikację konsolową, aby inni użytkownicy mogli ją uruchomić. Publikowanie tworzy zestaw plików potrzebnych do uruchomienia aplikacji. Aby wdrożyć pliki, skopiuj je na maszynę docelową.

.NET CLI jest używane do publikowania aplikacji.

Warunki wstępne

• Ten samouczek współpracuje z aplikacją konsolową utworzoną w Tworzenie aplikacji konsolowej platformy .NET przy użyciu programu Visual Studio Code.

Publikowanie aplikacji

1. Uruchom program Visual Studio Code.

2. Otwórz folder projektu HelloWorld utworzony w Tworzenie aplikacji konsolowej platformy .NET przy użyciu programu Visual Studio Code.

3. Wybierz pozycję View>Terminal z menu głównego.

   Terminal zostanie otwarty w folderze HelloWorld.

4. Uruchom następujące polecenie:

   dotnet publish
   

   Domyślna konfiguracja kompilacji to Release, która jest odpowiednia dla wdrożonej witryny działającej na produkcji. Dane wyjściowe z konfiguracji kompilacji 'Release' zawierają minimalne informacje symboliczne do debugowania i są w pełni zoptymalizowane.

   Dane wyjściowe polecenia są podobne do następującego przykładu:

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

1. Otwórz swoją usługę GitHub Codespace utworzoną w sekcji Tworzenie aplikacji konsolowej platformy .NET przy użyciu programu Visual Studio Code.

2. Dodaj następujący wiersz kodu na początku HelloWorld.cs:

   #:property PublishAot=false
   

   Ta dyrektywa właściwości wyłącza natywną kompilację ahead-of-time (AOT), a aplikacja będzie używać standardowego kompilatora just-in-time (JIT) w czasie wykonywania. Opublikowane dane wyjściowe będą zależne od struktury.

3. W terminalu upewnij się, że jesteś w folderze tutorials .

4. Uruchom następujące polecenie:

   dotnet publish HelloWorld.cs
   

   Polecenie tworzy niezależny plik wykonywalny.

   Dane wyjściowe polecenia są podobne do następującego przykładu:

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

Sprawdzanie plików

Domyślnie proces publikowania tworzy wdrożenie zależne od platformy, które jest typem wdrożenia, w którym opublikowana aplikacja jest uruchamiana na maszynie z zainstalowanym środowiskiem uruchomieniowym platformy .NET. Aby uruchomić opublikowaną aplikację, możesz użyć pliku wykonywalnego lub uruchomić polecenie dotnet HelloWorld.dll w wierszu polecenia.

W poniższych krokach przyjrzysz się plikom utworzonym przez proces publikowania.

1. Wybierz Explorer na lewym pasku nawigacyjnym.

2. Rozwiń bin/Release/net10.0/publish.

   Eksplorator

   Jak pokazano na obrazie, opublikowane dane wyjściowe zawierają następujące pliki:

   • HelloWorld.deps.json

     Jest to plik zależności środowiska uruchomieniowego aplikacji. Definiuje składniki platformy .NET i biblioteki (w tym dynamiczną bibliotekę linków zawierającą aplikację) wymagane do uruchomienia aplikacji. Aby uzyskać więcej informacji, zobacz pliki konfiguracji środowiska uruchomieniowego .

   • HelloWorld.dll

     Jest to wdrożenie zależne od platformy wersji aplikacji. Aby uruchomić tę bibliotekę linków dynamicznych, wprowadź dotnet HelloWorld.dll w wierszu polecenia. Ta metoda uruchamiania aplikacji działa na dowolnej platformie z zainstalowanym środowiskiem uruchomieniowym platformy .NET.

   • HelloWorld.exe (HelloWorld w systemie Linux lub macOS).

     Jest to plik wykonywalny zależny od platformy wersji aplikacji. Plik jest specyficzny dla systemu operacyjnego.

   • HelloWorld.pdb (opcjonalnie do wdrożenia)

     Jest to plik symboli debugowania. Nie musisz wdrażać tego pliku wraz z aplikacją, chociaż należy zapisać go w przypadku konieczności debugowania opublikowanej wersji aplikacji.

   • HelloWorld.runtimeconfig.json

     Jest to plik konfiguracji środowiska uruchomieniowego aplikacji. Identyfikuje wersję platformy .NET utworzoną do uruchomienia aplikacji. Możesz również dodać do niej opcje konfiguracji. Aby uzyskać więcej informacji, zobacz ustawienia konfiguracji środowiska uruchomieniowego .NET.

W przypadku aplikacji z jednym plikiem proces publikowania tworzy katalog artefaktów z skompilowanym plikiem zestawu. Opublikowana aplikacja może być uruchamiana przy użyciu dotnet polecenia .

W poniższych krokach przyjrzysz się plikom utworzonym przez proces publikowania.

1. Wybierz Explorer na lewym pasku nawigacyjnym.

2. Rozwiń artifacts/HelloWorld.

   Eksplorator

   Jak pokazano na obrazie, opublikowane dane wyjściowe zawierają następujące pliki:

   • Helloworld

     Jest to plik wykonywalny zależny od platformy wersji aplikacji. Plik jest specyficzny dla systemu operacyjnego. Usługa Codespaces działa w systemie Linux, więc jest to plik wykonywalny systemu Linux.

   • HelloWorld.deps.json

     Jest to plik zależności środowiska uruchomieniowego aplikacji. Definiuje składniki platformy .NET i biblioteki (w tym dynamiczną bibliotekę linków zawierającą aplikację) wymagane do uruchomienia aplikacji. Aby uzyskać więcej informacji, zobacz pliki konfiguracji środowiska uruchomieniowego .

   • HelloWorld.dll

     Jest to wdrożenie zależne od platformy wersji aplikacji. Aby uruchomić tę bibliotekę linków dynamicznych, wprowadź dotnet HelloWorld.dll w wierszu polecenia. Ta metoda uruchamiania aplikacji działa na dowolnej platformie z zainstalowanym środowiskiem uruchomieniowym platformy .NET.

   • HelloWorld.pdb (opcjonalnie do wdrożenia)

     Jest to plik symboli debugowania. Nie musisz wdrażać tego pliku wraz z aplikacją, chociaż należy zapisać go w przypadku konieczności debugowania opublikowanej wersji aplikacji.

   • HelloWorld.runtimeconfig.json

     Jest to plik konfiguracji środowiska uruchomieniowego aplikacji. Identyfikuje wersję platformy .NET utworzoną do uruchomienia aplikacji. Możesz również dodać do niej opcje konfiguracji. Aby uzyskać więcej informacji, zobacz ustawienia konfiguracji środowiska uruchomieniowego .NET.

   Kliknij prawym przyciskiem myszy i wybierz polecenie Pobierz, aby pobrać pliki z usługi Codespaces na komputer lokalny.

Uruchamianie opublikowanej aplikacji

1. W Explorerkliknij prawym przyciskiem myszy folder publikowania (Ctrl-kliknij w systemie macOS), a następnie wybierz pozycję Otwórz w zintegrowanym terminalu.

   menu kontekstowe

2. W systemie Windows lub Linux uruchom aplikację przy użyciu pliku wykonywalnego.

   1. W systemie Windows wprowadź .\HelloWorld.exe i naciśnij Enter.

   2. W systemie Linux wprowadź ./HelloWorld i naciśnij Enter.

   3. Wprowadź nazwę w odpowiedzi na monit i naciśnij Enter, aby zakończyć.

3. Na dowolnej platformie uruchom aplikację przy użyciu polecenia dotnet:

   1. Wprowadź dotnet HelloWorld.dll i naciśnij Enter.

   2. Wprowadź nazwę w odpowiedzi na monit i naciśnij Enter, aby zakończyć.

1. W Eksploratorze kliknij prawym przyciskiem myszy folder artifacts/HelloWorld i wybierz polecenie Otwórz w zintegrowanym terminalu.

2. Uruchom aplikację przy użyciu pliku wykonywalnego. Wprowadź, ./HelloWorld a następnie naciśnij Enter.

3. Wprowadź nazwę w odpowiedzi na monit i naciśnij Enter, aby zakończyć.

Dodatkowe zasoby

• Omówienie publikowania aplikacji platformy .NET
• dotnet publish
• Użycie .NET SDK w środowiskach ciągłej integracji (CI)

Oczyszczanie zasobów

Usługa GitHub automatycznie usuwa środowisko Codespace po upływie 30 dni braku aktywności. Jeśli planujesz zapoznać się z więcej samouczków w tej serii, możesz pozostawić aprowizowaną usługę Codespace. Jeśli jesteś gotowy do odwiedzenia witryny .NET w celu pobrania zestawu .NET SDK, możesz usunąć Codespace. Aby usunąć swój Codespace, otwórz okno przeglądarki i przejdź do Twoich Codespaces. W oknie wyświetlana jest lista twoich codespaces. Wybierz trzy kropki (...) we wpisie dotyczącym codespace samouczka learn. Następnie wybierz pozycję "Usuń".

Następne kroki

W tym samouczku opublikowałeś aplikację konsolową. W następnym samouczku utworzysz bibliotekę klas.

Tworzenie biblioteki klas platformy .NET przy użyciu programu Visual Studio Code