dotnet workload install

Artículo
05/09/2023

Este artículo se aplica a: ✔️ SDK de .NET 6 y versiones posteriores

Name

dotnet workload install: instala cargas de trabajo opcionales.

Sinopsis

dotnet workload install <WORKLOAD_ID>...
    [--configfile <FILE>] [--disable-parallel]
    [--ignore-failed-sources] [--include-previews] [--interactive]
    [--no-cache] [--skip-manifest-update]
    [--source <SOURCE>] [--temp-dir <PATH>] [-v|--verbosity <LEVEL>]

dotnet workload install -?|-h|--help

Descripción

El comando dotnet workload install instala una o varias cargas de trabajo opcionales. Las cargas de trabajo opcionales se pueden instalar sobre el SDK de .NET para proporcionar compatibilidad con varios tipos de aplicaciones, como .NET MAUI y Blazor WebAssembly AOT.

Use dotnet workload search para saber qué cargas de trabajo hay disponibles para instalar.

Ejecución con privilegios elevados

En el caso de las instalaciones del SDK de macOS y Linux que están instaladas en un directorio protegido, el comando debe ejecutarse con privilegios elevados (use el comando sudo). En Windows, el comando no necesita ejecutarse con privilegios elevados aunque el SDK esté instalado en el directorio Archivos de programa. En Windows, el comando usa instaladores MSI en esa ubicación.

Variación de los resultados según la versión del SDK

Los comandos dotnet workload operan en el contexto de versiones específicas del SDK. Imagine que tiene instalado el SDK de .NET 6.0.100 y el de .NET 6.0.200. Los comandos dotnet workload van a generar resultados diferentes en función de la versión del SDK que se seleccione. Este comportamiento se aplica a las diferencias de versión principal y secundaria y de banda de características, no a las diferencias de versión de revisión. Por ejemplo, el SDK de .NET 6.0.101 y 6.0.102 genera los mismos resultados, mientras que 6.0.100 y 6.0.200 generan resultados diferentes. Puede especificar la versión del SDK mediante el archivo global.json o la opción --sdk-version de los comandos dotnet workload.

Manifiestos de publicidad

Los nombres y las versiones de los recursos que necesita una instalación de carga de trabajo se mantienen en manifiestos. De manera predeterminada, el comando dotnet workload install descarga los manifiestos disponibles más recientes antes de instalar una carga de trabajo. Luego, la copia local de un manifiesto proporciona la información necesaria para buscar y descargar los recursos de una carga de trabajo.

El comando dotnet workload list compara las versiones de las cargas de trabajo instaladas con las versiones disponibles en ese momento. Si descubre que hay una versión disponible más reciente que la instalada, publicita ese hecho en la salida del comando. Estas notificaciones de versión más reciente de dotnet workload list están disponibles a partir de .NET 6.

Para habilitar estas notificaciones, las versiones disponibles más recientes de los manifiestos se descargan y almacenan como manifiestos de publicidad. Estas descargas se producen de forma asincrónica en segundo plano cuando se ejecuta cualquiera de los siguientes comandos.

Si un comando finaliza antes de que lo haga la descarga del manifiesto, esta se detiene. La descarga se vuelve a intentar la siguiente vez que se ejecuta alguno de esos comandos. Puede establecer variables de entorno para deshabilitar estas descargas en segundo plano o controlar su frecuencia. De manera predeterminada, no se producen más de una vez al día.

Puede evitar que el comando dotnet workload install haga descargas de manifiestos con la opción --skip-manifest-update.

El comando dotnet workload update también descarga manifiestos de publicidad. Las descargas son necesarias para saber si hay alguna actualización disponible, por lo que no hay ninguna opción para evitar que se ejecuten. Sin embargo, puede usar la opción --advertising-manifests-only para omitir las actualizaciones de cargas de trabajo y hacer solo las descargas de manifiestos. Esta opción está disponible a partir de .NET 6.

Argumentos

WORKLOAD_ID...

Identificadores de cargas de trabajo que se van a instalar. Use dotnet workload search para saber qué cargas de trabajo hay disponibles.

Opciones

--configfile <FILE>

Archivo de configuración de NuGet (nuget.config) que se va a usar. Si se especifica, solo se usará la configuración de este archivo. Si no se especifica, se utilizará la jerarquía de archivos de configuración del directorio actual. Para más información, consulte Configuraciones comunes de NuGet.

--disable-parallel

Evita la restauración de varios proyectos en paralelo.

-?|-h|--help

Imprime una descripción de cómo usar el comando.

--ignore-failed-sources

Trata los errores de origen de paquete como advertencias.

--include-previews

Permite manifiestos de cargas de trabajo de versión preliminar.

--interactive

Permite que el comando se detenga y espere una entrada o una acción del usuario. Por ejemplo, para completar la autenticación.

--no-cache

Evita el almacenamiento en caché de paquetes y solicitudes HTTP.

--skip-manifest-update

Omite la actualización de los manifiestos de cargas de trabajo. Los manifiestos de cargas de trabajo definen qué recursos y versiones deben instalarse para cada carga de trabajo.

-s|--source <SOURCE>

Especifica el URI del origen del paquete NuGet que se va a usar. Este valor invalida todos los orígenes especificados en los archivos nuget.config. Al especificar esta opción varias veces, se pueden proporcionar varios orígenes.

--temp-dir <PATH>

Especifique el directorio temporal que se usa para descargar y extraer paquetes NuGet (debe ser seguro).

-v|--verbosity <LEVEL>

Establece el nivel de detalle del comando. Los valores permitidos son q[uiet], m[inimal], n[ormal], d[etailed] y diag[nostic]. De manera predeterminada, es minimal. Si especifica nivel de detalle detailed o diagnostic, el comando muestra información sobre los paquetes NuGet que descarga.

Ejemplos

Instale la carga de trabajo maui:
```
dotnet workload install maui
```
Instale las cargas de trabajo maui-android y maui-ios:
```
dotnet workload install maui-android maui-ios
```