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 Azure DevOps. 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 Azure DevOps usará automaticamente a versão da CLI agrupada com a extensão. 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 três pacotes específicos da plataforma:

Pacote de CLI	SO	Tipos de projeto compatíveis
UiPath.CLI.Windows	Windows	Multiplataforma, Windows (não legado), Soluções
UiPath.CLI.Linux	Linux	Multiplataforma, Soluções
UiPath.CLI.Windows.Legacy	Windows	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 Azure DevOps da seguinte maneira:

• Usando várias tarefas UiPathInstallPlatform com diferentes versões de CLI.
• Organizar seus estágios do pipeline 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 CLI

Selecione a versão da CLI que você deseja usar no menu suspenso Escolha uma versão da CLI (obrigatória).

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).

Caminho para o nupkg de CLIs (Cenário Offline)

Se seus agentes do Azure DevOps não puderem acessar o Feed público da UiPath, você poderá fornecer manualmente o pacote de CLI:

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

2. Coloque o arquivo .nupkg baixado dentro do diretório Agent.Tools do seu agente de compilação.

   Exemplo: $(Agent.ToolsDirectory)\nupkg\UiPath.CLI.Windows.25.10.1-20251105-9.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 o nupkg do CLI .

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.1-20251105-9.nupkg
• UiPath.CLI.Linux.25.10.1-20251105-9.nupkg

Pipeline YAML

Você pode configurar a tarefa UiPath Install Platform no 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 repositórios com tipos de projeto mistos, instale as duas variantes 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 a versão personalizada do CLI:

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

Próximas Etapas

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