UseDotNet@2 — użyj zadania dotnet v2

Użyj tego zadania, aby uzyskać określoną wersję zestawu .NET Core SDK z Internetu lub lokalnej pamięci podręcznej i dodać ją do ścieżki. Użyj tego zadania, aby zmienić wersję platformy .NET Core, która jest używana 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.
    #requestTimeout: '300000' # string. Set timeout for package download request. Default: 300000.
  # 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.

Wejścia

pakiet packageType - 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 - Używanie globalnej json
boolean. Fakultatywny. Użyj polecenia , gdy packageType = sdk. Wartość domyślna: false.

Instaluje wszystkie zestawy SDK z plików global.json. Te pliki są przeszukiwane z 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 (przy użyciu .x jako symbol wieloznaczny) opisany w danych wejściowych UseDotNet@2.version służy do użycia w danych wejściowych version w zadaniu, a nie parametru sdk.version w global.json.

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.json, sprawdź sdk.version w global.json.

Aby uzyskać więcej informacji na temat global.json, zobacz Select the .NET version to use.

katalogu roboczego
string. Fakultatywny. Użyj polecenia , gdy useGlobalJson = true.

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

version - wersja
string. Fakultatywny. 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, 3 i 1.
• 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 pliku releases.json. Link do wersji głównej/pomocniczej znajduje się w pliku releases-index. Na przykład link do pliku releases.json dla wersji 3.1.

wersji zgodnej z programem 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 ciągu version, znajdują się w pliku releases.json. Link do 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. Fakultatywny. Użyj polecenia , gdy useGlobalJson = false || packageType = runtime. Wartość domyślna: false.

Jeśli ustawiono wartość true, obejmuje 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ę, taką jak 3.0.100-preview3-010431.

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

Określa, gdzie ma być zainstalowany 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 buforuje instalację agenta, 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 niej procesy.

Nuta

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

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

Konfiguruje zachowanie procesu hosta platformy .NET podczas wyszukiwania odpowiedniej platformy udostępnionej. Wartości to:

• false: proces hosta wyszukuje tylko wersje, które znajdują się w folderze określonym przez zadanie.
• true: proces hosta będzie wyszukiwać 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 o wieloeziomowych odnośników SharedFX.

Nuta

performMultiLevelLookup dotyczy tylko agentów opartych na systemie Windows.

requestTimeout - Ustawianie limitu czasu dla żądania pobierania pakietu
string. Wartość domyślna: 300000.

Podaj wartość limitu czasu dla żądań HTTP, które zadanie wykonuje w celu uzyskania pakietu .NET. Wartość jest wyrażona w milisekundach. Wartość domyślna to 300000 milisekund (5 minut). Nie może przekraczać 600000 milisekund (10 minut).

Opcje sterowania zadaniami

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

Zmienne wyjściowe

Żaden.

Uwagi

Zadanie Używanie platformy .NET Core uzyskuje określoną wersję .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). Użyj tego zadania, aby zmienić wersję platformy .NET Core używaną 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.

Podejście 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, klasyczna kompilacja, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Żaden
możliwości	Uruchomienie tego zadania spełnia następujące wymagania dla wszystkich kolejnych zadań w tym samym zadaniu: DotNetCore
ograniczenia poleceń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	2.144.0 lub nowsza
Kategoria zadań	Narzędzie