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 Jenkins. 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, Jenkins utilizará automáticamente la versión CLI incluida con el complemento. 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 lograr esto en el mismo proceso de Jenkins de la siguiente manera:

• Utilizar varios pasos de UiPathInstallPlatform con diferentes versiones de CLI.
• Organiza tus etapas de construcción 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 la CLI de UiPath

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

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).
• Los requisitos de runtime de .NET para cada versión.

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

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

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

2. Coloca el archivo .nupkg descargado en una ubicación accesible dentro del directorio del espacio de trabajo del agente.

   Ejemplos: ${WORKSPACE}/nupkg/UiPath.CLI.Windows.25.10.3.nupkg ${env.ProgramFiles}\\CLIVersions\\UiPath.CLI.Windows.Legacy.25.10.9424.14050.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 a CLI nupkg .

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.3.nupkg
• UiPath.CLI.Linux.25.10.3.nupkg

Ejemplo de proceso

pipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('Build') {
      steps {
         UiPathInstallPlatform(
            cliVersion: 'Windows.25.10.0-20251104-11',
            traceLevel: 'Information',
         )
      }
    }
  }
}

pipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('Build') {
      steps {
        UiPathInstallPlatform(
            cliVersion: 'CustomVersion',
            cliNupkgPath: 'C:\Tools\UiPath.CLI.Windows.25.10.3.nupkg',
            traceLevel: 'Information',
         )
      }
    }
  }
}

Próximos pasos

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