Plataforma de instalación de Uipath

La tarea UiPathInstallPlatform descarga e instala una versión específica de UiPath CLI en la caché de herramientas del agente de Azure DevOps. Esta tarea se aplica tanto a los proyectos de automatización independientes (procesos, bibliotecas, pruebas) como a las soluciones.

Cuándo utilizar esta tarea

Utiliza la tarea UiPathInstallPlatform cuando:

• Deseas controlar explícitamente qué versión de CLI se utiliza en tu proceso.
• Debes instalar un tipo de CLI específico en función de tus tipos de proyecto (consulta Tipos de CLI a continuación).
• Sus agentes de compilación no tienen acceso a Internet a la fuente pública de UiPath.
• Deseas almacenar en caché el CLI en el agente para acelerar las compilaciones posteriores.

Ejecuta la tarea UiPathInstallPlatform antes de cualquier otra tarea de UiPath en tu proceso.

Nota:

Esta tarea es opcional. Si no se especifica, Azure DevOps utilizará automáticamente la versión CLI incluida con la extensión. Sin embargo, el uso de esta tarea te da un control explícito y mejora el rendimiento de la compilación a través del almacenamiento en caché.

Tipos de CLI

UiPath CLI se distribuye en tres paquetes específicos de la plataforma:

Paquete CLI	SO	Tipos de proyectos compatibles
UiPath.CLI.Windows	Ventanas	Multiplataforma, Windows (no heredado), Soluciones
UiPath.CLI.Linux	Linux	Multiplataforma, Soluciones
UiPath.CLI.Windows.Legacy	Ventanas	Windows: solo proyectos heredados

Todos los paquetes CLI requieren .NET 8 Runtime:

• Agentes de Windows: .NET Desktop Runtime 8
• Agentes Linux: .NET Runtime 8

Gestionar tipos de proyectos mixtos

Si tu repositorio contiene varios tipos de proyectos (por ejemplo, tanto proyectos de Windows heredados como multiplataforma), debes instalar varias versiones de CLI y procesar cada tipo de proyecto con la CLI correcta:

Enfoque recomendado:

1. Instala UiPath.CLI.Windows y procesa todos los proyectos multiplataforma y Windows (no heredados).
2. Instala UiPath.CLI.Windows.Legacy y procesa todos los proyectos de Windows: heredado por separado.

Puedes lograrlo en el mismo proceso de Azure DevOps:

• Utilizar varias tareas de UiPathInstallPlatform con diferentes versiones de CLI.
• Organizar las etapas de tu proceso para procesar cada tipo de proyecto con la CLI adecuada.
• Utilizar la lógica condicional basada en la estructura de carpetas o las convenciones de nomenclatura para identificar los tipos de proyectos.

Consejo:

No hay una forma automática de que UiPath CLI detecte los tipos de proyecto. Debes saber qué proyectos de tu repositorio son Windows-Legacy y organizar tu proceso en consecuencia.

Selector de versión de CLI

Selecciona la versión de CLI que deseas utilizar en el menú desplegable Elegir una versión de CLI (obligatorio).

Las opciones de la lista desplegable incluyen:

• Versiones disponibles de UiPath CLI 25.10 y posteriores.
• El tipo de CLI (Windows, Linux o Windows.Legacy).

Ruta a nupkg de CLI (escenario sin conexión)

Si tus agentes de Azure DevOps no pueden acceder a la fuente pública de UiPath, puedes proporcionar manualmente el paquete CLI:

1. Descarga la versión de CLI deseada desde la fuente pública de UiPath.

2. Coloca el archivo .nupkg descargado dentro del directorio Agent.Tools de tu agente de compilación.

   Ejemplo: $(Agent.ToolsDirectory)\nupkg\UiPath.CLI.Windows.25.10.1-20251105-9.nupkg

3. En la configuración de la tarea UiPathInstallPlatform , establece la versión cli en 'CustomVersion' y proporciona la ruta al archivo .nupkg en el campo Ruta al campo nupkg de CLI .

Importante:

Asegúrate de que el nombre del paquete CLI de la versión personalizada coincide exactamente con el de la fuente oficial, como se muestra a continuación:

• UiPath.CLI.Windows.25.10.1-20251105-9.nupkg
• UiPath.CLI.Linux.25.10.1-20251105-9.nupkg

Proceso de YAML

Puedes configurar la tarea Plataforma de instalación de UiPath en formato YAML:

- task: UiPathInstallPlatform@6  displayName: 'UiPath Install Platform'  inputs:    cliVersion: 'Windows.25.10.1-20251105-9'  # For UiPath.CLI.Windows    # or 'Linux.25.10.1-20251105-9'         # For UiPath.CLI.Linux    # or 'Windows.Legacy.25.10.9424.14050'  # For UiPath.CLI.Windows.Legacy

Para repositorios con tipos de proyectos mixtos, instala ambas versiones de CLI:

# Install CLI for Cross-platform and Windows (non-legacy) projects- task: UiPathInstallPlatform@6  displayName: 'Install UiPath CLI Windows'  inputs:    cliVersion: 'Windows.25.10.1-20251105-9'# Install CLI for Windows-Legacy projects- task: UiPathInstallPlatform@6  displayName: 'Install UiPath CLI Windows Legacy'  inputs:    cliVersion: 'Windows.Legacy.25.10.9424.14050'

Para instalar la versión personalizada de CLI:

- task: UiPathInstallPlatform@6  displayName: 'UiPath Install Platform'  inputs:    cliVersion: 'CustomVersion'    cliNupkgPath: 'C:\Tools\UiPath.CLI.Windows.25.10.1-20251105-9.nupkg'

Próximos pasos

• Ejecutar tareas de Azure DevOps : aprende a configurar y ejecutar procesos de Azure DevOps.
• Tareas de proyecto de Azure DevOps : explora tareas para proyectos de automatización independientes.
• Tareas de solución de Azure DevOps : tareas de exploración para soluciones.