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
- Ten samouczek współpracuje z aplikacją konsolową utworzoną w sekcji Tworzenie aplikacji konsolowej platformy .NET przy użyciu programu Visual Studio Code.
Opublikuj aplikację
Uruchom program Visual Studio Code.
Otwórz folder projektu HelloWorld utworzony w sekcji Tworzenie aplikacji konsolowej platformy .NET przy użyciu programu Visual Studio Code.
Wybierz pozycję Wyświetl>terminal z menu głównego.
Terminal zostanie otwarty w folderze HelloWorld .
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.
Wybierz Eksploratora na lewym pasku nawigacyjnym.
Rozwiń węzeł bin/Release/net7.0/publish.
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
W Eksploratorze kliknij prawym przyciskiem myszy folder publikowania (kliknij klawisze Ctrl w systemie macOS), a następnie wybierz polecenie Otwórz w zintegrowanym terminalu.
W systemie Windows lub Linux uruchom aplikację przy użyciu pliku wykonywalnego.
W systemie Windows wprowadź
.\HelloWorld.exe
i naciśnij klawisz Enter.W systemie Linux wprowadź
./HelloWorld
i naciśnij klawisz Enter.Wprowadź nazwę w odpowiedzi na monit i naciśnij dowolny klawisz, aby zakończyć.
Na dowolnej platformie uruchom aplikację przy użyciu
dotnet
polecenia :Wprowadź
dotnet HelloWorld.dll
i naciśnij klawisz Enter.Wprowadź nazwę w odpowiedzi na monit i naciśnij dowolny klawisz, aby zakończyć.
Dodatkowe zasoby
- Wdrażanie aplikacji platformy .NET
- Publikowanie aplikacji platformy .NET za pomocą interfejsu wiersza polecenia platformy .NET
dotnet publish
- Korzystanie z zestawu .NET SDK w środowiskach ciągłej integracji
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
- Ten samouczek współpracuje z aplikacją konsolową utworzoną w sekcji Tworzenie aplikacji konsolowej platformy .NET przy użyciu programu Visual Studio Code.
Opublikuj aplikację
Uruchom program Visual Studio Code.
Otwórz folder projektu HelloWorld utworzony w sekcji Tworzenie aplikacji konsolowej platformy .NET przy użyciu programu Visual Studio Code.
Wybierz pozycję Wyświetl>terminal z menu głównego.
Terminal zostanie otwarty w folderze HelloWorld .
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.
Wybierz Eksploratora na lewym pasku nawigacyjnym.
Rozwiń węzeł bin/Release/net7.0/publish.
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
W Eksploratorze kliknij prawym przyciskiem myszy folder publikowania (kliknij klawisze Ctrl w systemie macOS), a następnie wybierz polecenie Otwórz w terminalu.
W systemie Windows lub Linux uruchom aplikację przy użyciu pliku wykonywalnego.
W systemie Windows wprowadź
.\HelloWorld.exe
i naciśnij klawisz Enter. W systemie Windows przy użyciu terminalu powłoki Bash wprowadź ../HelloWorld.exe
W systemie Linux wprowadź
./HelloWorld
i naciśnij klawisz Enter.Wprowadź nazwę w odpowiedzi na monit i naciśnij dowolny klawisz, aby zakończyć.
Na dowolnej platformie uruchom aplikację przy użyciu
dotnet
polecenia :Wprowadź
dotnet HelloWorld.dll
i naciśnij klawisz Enter.Wprowadź nazwę w odpowiedzi na monit i naciśnij dowolny klawisz, aby zakończyć.
Dodatkowe zasoby
- Wdrażanie aplikacji platformy .NET
- Publikowanie aplikacji platformy .NET za pomocą interfejsu wiersza polecenia platformy .NET
dotnet publish
- Korzystanie z zestawu .NET SDK w środowiskach ciągłej integracji
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
- Ten samouczek współpracuje z aplikacją konsolową utworzoną w sekcji Tworzenie aplikacji konsolowej platformy .NET przy użyciu programu Visual Studio Code.
Opublikuj aplikację
Uruchom program Visual Studio Code.
Otwórz folder projektu HelloWorld utworzony w sekcji Tworzenie aplikacji konsolowej platformy .NET przy użyciu programu Visual Studio Code.
Wybierz pozycję Wyświetl>terminal z menu głównego.
Terminal zostanie otwarty w folderze HelloWorld .
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.
Wybierz Eksploratora na lewym pasku nawigacyjnym.
Rozwiń węzeł bin/Release/net6.0/publish.
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
W Eksploratorze kliknij prawym przyciskiem myszy folder publikowania (kliknij klawisze Ctrl w systemie macOS), a następnie wybierz polecenie Otwórz w terminalu.
Uruchom aplikację przy użyciu pliku wykonywalnego.
W systemie Windows wprowadź
.\HelloWorld.exe
i naciśnij klawisz Enter.W systemie Linux lub macOS wprowadź
./HelloWorld
i naciśnij klawisz Enter.Wprowadź nazwę w odpowiedzi na monit i naciśnij dowolny klawisz, aby zakończyć.
Na dowolnej platformie uruchom aplikację przy użyciu
dotnet
polecenia :Wprowadź
dotnet HelloWorld.dll
i naciśnij klawisz Enter.Wprowadź nazwę w odpowiedzi na monit i naciśnij dowolny klawisz, aby zakończyć.
Dodatkowe zasoby
- Wdrażanie aplikacji platformy .NET
- Publikowanie aplikacji platformy .NET za pomocą interfejsu wiersza polecenia platformy .NET
dotnet publish
- Korzystanie z zestawu .NET SDK w środowiskach ciągłej integracji
Następne kroki
W tym samouczku opublikowano aplikację konsolową. W następnym samouczku utworzysz bibliotekę klas.