dotnet workload install

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>] [--version <VERSION>]

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.

Cuando el comando está en workload-set modo de actualización, las versiones de carga de trabajo instaladas:

• Proceden del conjunto de cargas de trabajo más reciente o de una versión de conjunto de cargas de trabajo especificada en una opción o --version global.json.
• Es posible que no sea la versión más reciente disponible de cada carga de trabajo individual. Por ejemplo, el install comando no instalará un conjunto de cargas de trabajo más reciente si usó anteriormente la --version marca .

Para más información, consulte Conjuntos de cargas de trabajo del SDK de .NET. workload-set el modo de actualización está disponible desde el SDK 8.0.400.

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.

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.

• dotnet build
• dotnet pack
• dotnet publish
• dotnet restore
• dotnet run
• dotnet test

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.

• --version

  Versión del conjunto de cargas de trabajo en la que se va a instalar o actualizar. Si especifica la versión del conjunto de cargas de trabajo en global.json, no puede usar la --version opción para especificar la versión del conjunto de cargas de trabajo. Para que sea posible usar la --version opción en ese caso, ejecute el comando fuera de la ruta de acceso que contiene el archivo global.json. Disponible desde el SDK 8.0.400. Para más información, consulte Conjuntos de cargas de trabajo del SDK de .NET.

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