UseDotNet@2 — użyj zadania dotnet v2

To zadanie służy do uzyskiwania określonej wersji zestawu .NET Core SDK z Internetu lub lokalnej pamięci podręcznej i dodawania jej do ścieżki . To zadanie służy do zmiany wersji platformy .NET Core używanej w kolejnych zadaniach. To zadanie zapewnia również obsługę serwera proxy.

Składnia

# Use .NET Core v2
# Acquires a specific version of the .NET Core SDK from the internet or the local cache and adds it to the PATH. Use this task to change the version of .NET Core used in subsequent tasks. Additionally provides proxy support.
- task: UseDotNet@2
  inputs:
    #packageType: 'sdk' # 'runtime' | 'sdk'. Package to install. Default: sdk.
    #useGlobalJson: false # boolean. Optional. Use when packageType = sdk. Use global json. Default: false.
    #workingDirectory: # string. Optional. Use when useGlobalJson = true. Working Directory. 
    #version: # string. Optional. Use when useGlobalJson = false || packageType = runtime. Version. 
    #includePreviewVersions: false # boolean. Optional. Use when useGlobalJson = false  || packageType = runtime. Include Preview Versions. Default: false.
  # Advanced
    #vsVersion: # string. Compatible Visual Studio version. 
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.

Dane wejściowe

packageType - Pakiet do zainstalowania
string. Dozwolone wartości: runtime, sdk (zestaw SDK (zawiera środowisko uruchomieniowe)). Wartość domyślna: sdk.

Określa, czy należy zainstalować tylko środowisko uruchomieniowe platformy .NET, czy zestaw SDK.

useGlobalJson - Korzystanie z globalnego kodu JSON
boolean. Opcjonalny. Użyj polecenia , gdy packageType = sdk. Wartość domyślna: false.

Instaluje wszystkie zestawy SDK z global.json plików. Te pliki są przeszukiwane z pliku system.DefaultWorkingDirectory. Ścieżkę katalogu głównego wyszukiwania można zmienić, ustawiając dane wejściowe katalogu roboczego.

Format 6.x i 6.1.x (używany .x jako symbol wieloznaczny) opisany w UseDotNet@2.version danych wejściowych służy do użycia w version danych wejściowych w zadaniu, a nie parametru sdk.version w global.jsonpliku .

Jeśli zostanie wyświetlony komunikat o błędzie, taki jak ##[error]Version 6.0.x is not allowed. Allowed version types are: majorVersion.x, majorVersion.minorVersion.x, majorVersion.minorVersion.patchVersion. More details: Only explicit versions and accepted, such as: 2.2.301. Version: 6.0.x is not valid. i używasz global.jsonpolecenia , zaewidencjonuj sdk.version element w pliku global.json.

Aby uzyskać więcej informacji na global.jsontemat programu , zobacz Wybieranie wersji platformy .NET do użycia.

workingDirectory - Katalog roboczy
string. Opcjonalny. Użyj polecenia , gdy useGlobalJson = true.

Określa ścieżkę, z której global.json mają być przeszukiwane pliki podczas korzystania z programu useGlobalJson. Jeśli wartość jest pusta, system.DefaultWorkingDirectory zostanie uznana za ścieżkę główną.

version - Wersja
string. Opcjonalny. Użyj polecenia , gdy useGlobalJson = false || packageType = runtime.

Określa wersję zestawu .NET Core SDK lub środowiska uruchomieniowego do zainstalowania. Formaty wartości wersji są wyświetlane z przykładami:

• 2.x: instaluje najnowszy zestaw SDK lub środowisko uruchomieniowe z określoną wersją główną, 2.
• 3.1.x: instaluje najnowszy zestaw SDK lub środowisko uruchomieniowe z określonymi wersjami głównymi i pomocniczymi oraz 31.
• 3.1.402: instaluje określony zestaw SDK lub wersję środowiska uruchomieniowego, 3.1.402.

Wartości wersji dla instalacji zestawu SDK lub środowiska uruchomieniowego znajdują się w releases.json pliku . Link do releases.json wersji głównej/pomocniczej znajduje się w pliku releases-index . Na przykład link do pliku releases.json dla wersji 3.1.

vsVersion - Zgodna wersja programu Visual Studio
string.

Określa zgodną wersję programu Visual Studio dla odpowiedniej instalacji zestawu .NET Core SDK. Wartość musi być pełnym numerem wersji, takim jak 16.6.4, który zawiera wersję główną, wersję pomocniczą i numer poprawki.

Wartości wersji dla instalacji zestawu SDK lub środowiska uruchomieniowego, które są używane dla version ciągu, znajdują się w releases.json pliku . Link do releases.json wersji głównej/pomocniczej znajduje się w pliku releases-index . Na przykład link do pliku releases.json dla wersji 3.1.

includePreviewVersions - Uwzględnij wersje zapoznawcza
boolean. Opcjonalny. Użyj polecenia , gdy useGlobalJson = false || packageType = runtime. Wartość domyślna: false.

Jeśli jest ustawiona wartość true, program zawiera wersje zapoznawcza, gdy zadanie wyszukuje najnowsze wersje środowiska uruchomieniowego/zestawu SDK, takie jak wyszukiwanie 2.2.x lub 3.1.x. To ustawienie jest ignorowane, jeśli określisz dokładną wersję, na przykład 3.0.100-preview3-010431.

installationPath - Ścieżka do zainstalowania .Net Core
string. Wartość domyślna: $(Agent.ToolsDirectory)/dotnet.

Określa, gdzie należy zainstalować zestaw .NET Core SDK/środowisko uruchomieniowe. Różne ścieżki mogą mieć następujący wpływ na element . Zachowanie platformy NET.

• $(Agent.ToolsDirectory): Użycie tej ścieżki powoduje buforowanie instalacji na agencie, ponieważ ten katalog nie jest czyszczony w potokach. Wszystkie potoki uruchomione na agencie mają dostęp do poprzednio zainstalowanych wersji.
• $(Agent.TempDirectory): Użycie tej ścieżki gwarantuje, że potok nie używa buforowanej wersji platformy .NET Core, ponieważ ten folder jest czyszczony po każdym potoku.
• Inna ścieżka: możesz użyć dowolnej ścieżki, jeśli proces agenta ma dostęp do ścieżki. Spowoduje to zmianę stanu maszyny i wpłynie na wszystkie uruchomione na nim procesy.

Uwaga

Możesz użyć ustawienia Wyszukiwania wielowarstwowego , performMultiLevelLookupaby skonfigurować sposób wyszukiwania wersji przez hosta platformy .NET.

performMultiLevelLookup - Wyszukiwanie na wielu poziomach
boolean. Wartość domyślna: false.

Konfiguruje zachowanie procesu hosta platformy .NET podczas wyszukiwania odpowiedniej struktury udostępnionej. Potrzebne wartości:

• false: Proces hosta wyszukuje tylko wersje, które znajdują się w folderze określonym przez zadanie.
• true: Proces hosta będzie wyszukiwany w wstępnie zdefiniowanych lokalizacjach globalnych przy użyciu wyszukiwania wieloeziomowego. Domyślne lokalizacje globalne to:
  • C:\Program Files\dotnet (procesy 64-bitowe)
  • C:\Program Files (x86)\dotnet (procesy 32-bitowe)

Dowiedz się więcej na temat wieloeziomowego wyszukiwania SharedFX.

Uwaga

performMultiLevelLookup dotyczy tylko agentów z systemem Windows.

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

Uwagi

Zadanie Używanie platformy .NET Core uzyskuje określoną wersję platformy .NET Core z Internetu lub pamięci podręcznej narzędzi i dodaje ją do ścieżki agenta usługi Azure Pipelines (hostowanego lub prywatnego). To zadanie służy do zmiany wersji platformy .NET Core używanej w kolejnych zadaniach, takich jak DotNetCoreCLI@2. Dodanie tego zadania przed DotNetCoreCLI@2 w definicji kompilacji gwarantuje, że wersja będzie dostępna w czasie kompilowania, testowania i publikowania aplikacji.

Metoda instalatora narzędzi umożliwia również oddzielenie od cykli aktualizacji agenta. Jeśli w szukanej wersji platformy .NET Core brakuje agenta usługi Azure Pipelines (hostowanego lub prywatnego), możesz użyć tego zadania, aby uzyskać odpowiednią wersję zainstalowaną na agencie.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, kompilacja klasyczna, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Brak
Możliwości	Uruchomienie tego zadania spełnia następujące wymagania dotyczące wszystkich kolejnych zadań w tym samym zadaniu: DotNetCore
Ograniczenia poleceń	Dowolne
Zmienne w formie tabeli settable	Dowolne
Wersja agenta	2.144.0 lub nowsza
Kategoria zadania	Narzędzie