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

W tym samouczku pokazano, 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ą.

Interfejs wiersza polecenia platformy .NET służy do publikowania aplikacji, więc możesz wykonać czynności opisane w tym samouczku za pomocą edytora kodu innego niż Program Visual Studio Code, jeśli wolisz.

Wymagania wstępne

Opublikuj aplikację

  1. Uruchom program Visual Studio Code.

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

  3. Wybierz pozycję Wyświetl>terminal z menu głównego.

    Terminal zostanie otwarty w folderze HelloWorld .

  4. Uruchom następujące polecenie:

    dotnet publish --configuration Release
    

    Domyślna konfiguracja kompilacji to Debuguj, więc to polecenie określa konfigurację kompilacji wydania . Dane wyjściowe z konfiguracji kompilacji wydania zawierają minimalne informacje o debugowaniu symbolicznym i są w pełni zoptymalizowane.

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

    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\
    

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ć dotnet HelloWorld.dll polecenie w wierszu polecenia.

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

  1. Wybierz Eksploratora na lewym pasku nawigacyjnym.

  2. Rozwiń węzeł bin/Release/net7.0/publish.

    Explorer showing published files

    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 wersja wdrożenia zależna od struktury aplikacji. Aby uruchomić tę dynamiczną bibliotekę linków, 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 wersja pliku wykonywalnego zależna od struktury 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 platformy .NET.

Uruchamianie opublikowanej aplikacji

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

    Context menu showing Open in Terminal

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

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

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

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

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

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

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

Dodatkowe zasoby

Następne kroki

W tym samouczku opublikowano aplikację konsolową. W następnym samouczku utworzysz bibliotekę klas.

W tym samouczku pokazano, 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ą.

Interfejs wiersza polecenia platformy .NET służy do publikowania aplikacji, więc możesz wykonać czynności opisane w tym samouczku za pomocą edytora kodu innego niż Program Visual Studio Code, jeśli wolisz.

Wymagania wstępne

Opublikuj aplikację

  1. Uruchom program Visual Studio Code.

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

  3. Wybierz pozycję Wyświetl>terminal z menu głównego.

    Terminal zostanie otwarty w folderze HelloWorld .

  4. Uruchom następujące polecenie:

    dotnet publish --configuration Release
    

    Domyślna konfiguracja kompilacji to Debuguj, więc to polecenie określa konfigurację kompilacji wydania . Dane wyjściowe z konfiguracji kompilacji wydania zawierają minimalne informacje o debugowaniu symbolicznym i są w pełni zoptymalizowane.

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

    Microsoft (R) Build Engine version 16.7.4+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\net7.0\HelloWorld.dll
      HelloWorld -> C:\Projects\HelloWorld\bin\Release\net7.0\publish\
    

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ć dotnet HelloWorld.dll polecenie w wierszu polecenia.

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

  1. Wybierz Eksploratora na lewym pasku nawigacyjnym.

  2. Rozwiń węzeł bin/Release/net7.0/publish.

    Explorer showing published files

    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 wersja wdrożenia zależna od struktury aplikacji. Aby uruchomić tę dynamiczną bibliotekę linków, 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, a nie w systemie macOS).

      Jest to wersja pliku wykonywalnego zależna od struktury 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 platformy .NET.

Uruchamianie opublikowanej aplikacji

  1. W Eksploratorze kliknij prawym przyciskiem myszy folder publikowania (kliknij klawisze Ctrl w systemie macOS), a następnie wybierz polecenie Otwórz w terminalu.

    Context menu showing Open in Terminal

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

    1. W systemie Windows wprowadź .\HelloWorld.exe i naciśnij klawisz Enter. W systemie Windows przy użyciu terminalu powłoki Bash wprowadź ../HelloWorld.exe

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

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

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

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

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

Dodatkowe zasoby

Następne kroki

W tym samouczku opublikowano aplikację konsolową. W następnym samouczku utworzysz bibliotekę klas.

W tym samouczku pokazano, 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ą.

Interfejs wiersza polecenia platformy .NET służy do publikowania aplikacji, więc możesz wykonać czynności opisane w tym samouczku za pomocą edytora kodu innego niż Program Visual Studio Code, jeśli wolisz.

Wymagania wstępne

Opublikuj aplikację

  1. Uruchom program Visual Studio Code.

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

  3. Wybierz pozycję Wyświetl>terminal z menu głównego.

    Terminal zostanie otwarty w folderze HelloWorld .

  4. Uruchom następujące polecenie:

    dotnet publish --configuration Release
    

    Domyślna konfiguracja kompilacji to Debuguj, więc to polecenie określa konfigurację kompilacji wydania . Dane wyjściowe z konfiguracji kompilacji wydania zawierają minimalne informacje o debugowaniu symbolicznym i są w pełni zoptymalizowane.

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

    Microsoft (R) Build Engine version 16.7.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\net6.0\HelloWorld.dll
      HelloWorld -> C:\Projects\HelloWorld\bin\Release\net6.0\publish\
    

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ć dotnet HelloWorld.dll polecenie w wierszu polecenia.

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

  1. Wybierz Eksploratora na lewym pasku nawigacyjnym.

  2. Rozwiń węzeł bin/Release/net6.0/publish.

    Explorer showing published files

    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 wersja wdrożenia zależna od struktury aplikacji. Aby uruchomić tę dynamiczną bibliotekę linków, 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, a nie w systemie macOS).

      Jest to wersja pliku wykonywalnego zależna od struktury 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 platformy .NET.

Uruchamianie opublikowanej aplikacji

  1. W Eksploratorze kliknij prawym przyciskiem myszy folder publikowania (kliknij klawisze Ctrl w systemie macOS), a następnie wybierz polecenie Otwórz w terminalu.

    Context menu showing Open in Terminal

  2. Uruchom aplikację przy użyciu pliku wykonywalnego.

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

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

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

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

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

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

Dodatkowe zasoby

Następne kroki

W tym samouczku opublikowano aplikację konsolową. W następnym samouczku utworzysz bibliotekę klas.