Aspire instalacja i narzędzia

Visual StudioWersja 2022 17.9 lub nowsza zawiera domyślnie najnowszy zestawAspire SDK podczas instalowania obciążenia Sieci Web i chmury.

Aby zainstalować szablony Aspire w Visual Studio, należy zainstalować je ręcznie, chyba że używasz Visual Studio 17.12 lub nowszej. W przypadku Visual Studio 17.9 do 17.11 wykonaj następujące kroki:

1. Otwórz Visual Studio.
2. Przejdź do Narzędzia>Menedżer pakietów NuGet>Konsola menedżera pakietów.
3. Uruchom następujące polecenie, aby zainstalować szablony:

dotnet new install Aspire.ProjectTemplates

W przypadku Visual Studio 17.12 lub nowszego szablony Aspire są instalowane automatycznie.

Aby zainstalować te szablony, użyj polecenia dotnet new install, przekazując identyfikator Aspire.ProjectTemplates NuGet.

dotnet new install Aspire.ProjectTemplates

Aby zainstalować określoną wersję, dołącz numer wersji do nazwy pakietu:

dotnet new install Aspire.ProjectTemplates::9.4.0

Szablony Aspire są instalowane automatycznie podczas instalowania Visual Studio wersji 17.9 lub nowszej. Aby zobaczyć, jakie Aspire szablony są dostępne, wybierz pozycję Plik>nowy>projekt w elemecie Visual Studioi wyszukaj ciąg "Aspire" na pasku wyszukiwania (Alt+S). Zostanie wyświetlona lista dostępnych Aspire szablonów projektów:

Aby wyświetlić dostępne szablony w programie Visual Studio Code z zainstalowanym zestawem deweloperskim języka C#, wybierz przycisk Utwórz .NET Project, gdy w widoku Eksploratora nie jest otwarty żaden folder:

Następnie wyszukaj ciąg "Aspire" na pasku wyszukiwania, aby wyświetlić dostępne szablony projektów Aspire:

Aby sprawdzić, czy Aspire szablony są zainstalowane, użyj polecenia dotnet new list , przekazując nazwę szablonu aspire :

dotnet new list aspire

Dane wyjściowe konsoli powinny wyglądać następująco:

dotnet new list aspire
These templates matched your input: 'aspire'

Template Name                      Short Name              Language  Tags
---------------------------------  ----------------------  --------  -------------------------------------------------------
Aspire AppHost               aspire-apphost          [C#]      Common/Aspire/Cloud
Aspire Empty App              aspire                  [C#]      Common/Aspire/Cloud/Web/Web API/API/Service
Aspire Service Defaults       aspire-servicedefaults  [C#]      Common/Aspire/Cloud/Web/Web API/API/Service
Aspire Starter App            aspire-starter          [C#]      Common/Aspire/Blazor/Web/Web API/API/Service/Cloud
Aspire Test Project (MSTest)  aspire-mstest           [C#]      Common/Aspire/Cloud/Web/Web API/API/Service/Test
Aspire Test Project (NUnit)   aspire-nunit            [C#]      Common/Aspire/Cloud/Web/Web API/API/Service/Test
Aspire Test Project (xUnit)   aspire-xunit            [C#]      Common/Aspire/Cloud/Web/Web API/API/Service/Test

narzędzia Visual Studio

Visual Studio Udostępnia dodatkowe funkcje do pracy z integracjami Aspire i projektem orkiestratora AppHost. Nie wszystkie te funkcje są obecnie dostępne w Visual Studio Code lub za pośrednictwem interfejsu wiersza polecenia.

Dodawanie pakietu integracyjnego

Do swojej aplikacji dodajesz integracje Aspire, tak jak każdy inny pakiet NuGet, używając Visual Studio. Jednak Visual Studio również udostępnia opcje interfejsu użytkownika umożliwiające bezpośrednie dodawanie integracji Aspire.

1. W Visual Studioobszarze wybierz prawym przyciskiem myszy projekt, do którego chcesz dodać Aspire integrację, a następnie wybierz pozycję Dodaj>Aspire pakiet....

   

2. Menedżer pakietów zostanie otwarty ze wstępnie skonfigurowanymi wynikami wyszukiwania (wypełnianiem kryteriów filtrowania) dla Aspire integracji, co umożliwia łatwe przeglądanie i wybieranie odpowiedniej integracji.

   

Aby uzyskać więcej informacji na Aspire temat integracji, zobacz Aspire omówienie integracji.

Dodawanie pakietów hostingu

Aspire Pakiety hostingowe służą do konfigurowania różnych zasobów i zależności, od których aplikacja może zależeć lub z którego korzysta. Pakiety hostingowe różnią się od innych pakietów integracyjnych tym, że są dodawane do projektu *.AppHost. Aby dodać pakiet hostingowy do aplikacji, wykonaj następujące kroki:

1. W Visual Studio kliknij prawym przyciskiem myszy na projekt *.AppHost i wybierz pozycję Dodaj>Aspire pakiet....

   

2. Menedżer pakietów zostanie otwarty ze wstępnie skonfigurowanymi wynikami wyszukiwania (wypełnianiem kryteriów filtru) dla Aspire pakietów hostingowych, co umożliwia łatwe przeglądanie i wybieranie odpowiedniego pakietu.

   

Dodaj projekty orkiestracji

Projekty orkiestracji Aspire można dodać do istniejącej aplikacji, wykonując poniższe kroki:

1. W Visual Studio, prawym przyciskiem myszy kliknij istniejący projekt i wybierz Dodaj>Aspire obsługę Orchestrator...

   

2. Zostanie otwarte okno dialogowe z podsumowaniem *.AppHost i *.ServiceDefaults projektów dodawanych do rozwiązania.

   

3. Wybierz ok i zostaną zastosowane następujące zmiany:

   • *.AppHost i *.ServiceDefaults projekty orkiestracji są dodawane do rozwiązania.
   • Do pliku builder.AddServiceDefaults oryginalnego projektu zostanie dodane wywołanie Program.cs.
   • Odwołanie do oryginalnego projektu zostanie dodane do pliku AppHost.cs projektu *.AppHost.

Aby uzyskać więcej informacji na Aspire temat orkiestracji, zobacz Aspire omówienie aranżacji.

Zapisz się do orkiestracji

Visual Studio oferuje możliwość dołączenia do Aspire orkiestracji podczas nowego przepływu pracy projektu. Wybierz tę opcję, aby Visual Studio utworzyć projekty *.AppHost i *.ServiceDefaults wraz z wybranym szablonem projektu.

Tworzenie projektu testowego

W przypadku korzystania z elementu Visual Studioi wybrania szablonu Aspire Uruchom aplikację masz możliwość dołączenia projektu testowego. Ten projekt testowy to projekt xUnit zawierający przykładowy test, którego można użyć jako punktu wyjścia dla testów.

Aby uzyskać więcej informacji, zobacz Pisanie pierwszego Aspire testu.

narzędzia Visual Studio Code

W celu tworzenia i opracowywania projektów , można użyć z rozszerzeniem . Aby utworzyć nowy Aspire projekt w programie Visual Studio Code, wybierz przycisk Utwórz .NET projekt w widoku Eksplorator , a następnie wybierz jeden z Aspire szablonów:

Po utworzeniu nowego projektu Aspire uruchamiasz i debugujesz aplikację, przechodzisz przez punkty przerwania i sprawdzasz zmienne przy użyciu debugera Visual Studio Code:

RozszerzenieAspireVisual Studio Code udostępnia dodatkowe polecenia i narzędzia usprawniające pracę z projektamiAspire, w tym polecenia służące do dodawania integracji, konfigurowania ustawień uruchamiania, publikowania artefaktów wdrażania i wdrażania aplikacji.