Plataforma de instalação UiPath

A tarefa UiPathInstallPlatform baixa e instala uma versão específica do UiPath CLI para o cache de ferramentas do agente do Jenkins. Essa tarefa se aplica tanto a projetos de automação independentes (processos, bibliotecas, testes) quanto a Soluções.

Quando usar esta tarefa

Use a tarefa UiPathInstallPlatform quando:

• Você deseja controlar explicitamente qual versão da CLI é usada em seu pipeline.
• Você precisa instalar uma versão específica da CLI com base em seus tipos de projeto (consulte Tipos de CLI abaixo).
• Seus agentes de compilação não têm acesso à Internet para o Feed Público da UiPath.
• Você deseja armazenar em cache o CLI no agente para acelerar compilações subsequentes.

Execute a tarefa UiPathInstallPlatform antes de quaisquer outras tarefas da UiPath em seu pipeline.

Observação:

Essa tarefa é opcional. Se não for especificado, o Jenkins usará automaticamente a versão da CLI agrupada com o plug-in. No entanto, usar essa tarefa oferece controle explícito e melhora o desempenho da compilação por meio do cache.

Tipos de CLI

O UiPath CLI é distribuído em pacotes específicos da plataforma:

Plataforma	Arquitetura	Pacote de CLI	Tipos de projeto compatíveis
Windows	x64	UiPath.CLI.Windows	Multiplataforma, Windows (não legado), Soluções
Linux	x64	UiPath.CLI.Linux	Multiplataforma, Soluções
Mac OS	ARM64 (Apple Silicon)	UiPath.CLI.macOS	Multiplataforma, Soluções
Windows	x64	UiPath.CLI.Windows.Legacy	Windows - Projetos legados apenas

Todos os pacotes de CLI requerem .NET 8 Runtime:

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

Gerenciamento de tipos de projetos mistos

Se seu repositório contiver vários tipos de projetos (por exemplo, projetos do Windows-Legacy e multiplataforma), você precisa instalar várias variantes de CLI e processar cada tipo de projeto com a CLI correta:

Abordagem recomendada:

1. Instale UiPath.CLI.Windows e processe todos os projetos multiplataforma e Windows (não legados).
2. Instale UiPath.CLI.Windows.Legacy e processe todos os projetos Windows - Legado separadamente.

Você pode conseguir isso no mesmo pipeline do Jenkins:

• Usando várias etapas do UiPathInstallPlatform com diferentes versões de CLI.
• Organizar seus estágios de compilação para processar cada tipo de projeto com a CLI apropriada.
• Uso de lógica condicional baseada na estrutura de pastas ou convenções de nomenclatura para identificar tipos de projetos.

Dica:

Não há uma maneira automática para o UiPath CLI detectar tipos de projeto. Você deve saber quais projetos em seu repositório são Windows-Legacy e organizar seu pipeline de acordo.

Seletor de versão do UiPath CLI

Selecione a versão do UiPath CLI que você deseja usar no menu suspenso Escolha uma versão da CLI .

As opções na lista suspensa incluem:

• Versões disponíveis do UiPath CLI 25.10 e posterior.
• A versão da CLI (Windows, Linux ou Windows.Legacy).
• Os requisitos de runtime .NET para cada versão.

Caminho para o nupkg do UiPath CLI (Cenário offline)

Se seus agentes do Jenkins não puderem acessar o Feed Público da UiPath, você pode fornecer manualmente o pacote de CLI:

1. Baixe a versão desejada do UiPath CLI no Feed Público do UiPath.

2. Coloque o arquivo .nupkg baixado em um local acessível dentro do diretório de espaço de trabalho do agente.

   Exemplos: ${WORKSPACE}/nupkg/UiPath.CLI.Windows.25.10.3.nupkg ${env.ProgramFiles}\\CLIVersions\\UiPath.CLI.Windows.Legacy.25.10.9424.14050.nupkg

3. Na configuração de tarefas UiPathInstallPlatform , defina a versão da CLI como 'CustomVersion' e forneça o caminho para o arquivo .nupkg no campo Caminho para a CLI nupkg .

Importante:

Certifique-se de que o nome do pacote de CLI da versão personalizada corresponda exatamente ao do feed oficial, como abaixo:

• UiPath.CLI.Windows.25.10.3.nupkg
• UiPath.CLI.Linux.25.10.3.nupkg

Exemplo de pipeline

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óximas Etapas

• Execução de trabalhos do Jenkins - Aprenda como configurar e executar pipelines do Jenkins.
• Tarefas do projeto Jenkins - Explore tarefas para projetos de automação independentes.
• Tarefas de soluções do Jenkins - Explore tarefas para soluções.