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

Observação:

O suporte ao macOS está atualmente disponível apenas para processadores ARM64 (Apple Silicon). Macs baseados em Intel não são suportados.

Todos os pacotes de CLI requerem .NET 8 Runtime:

• Agentes do Windows: .NET Desktop Runtime 8
• Agentes do Linux: .NET Runtime 8
• Agentes do macOS: .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, macOS 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.3.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.3.nupkg
• UiPath.CLI.Linux.25.10.3.nupkg

Pipeline YAML

Você pode configurar a tarefa UiPath Install Platform no formato YAML:

Exemplos básicos

# Windows
- task: UiPathInstallPlatform@6
  displayName: 'Install UiPath CLI for Windows'
  inputs:
    cliVersion: 'Windows.25.10.3'

# Linux
- task: UiPathInstallPlatform@6
  displayName: 'Install UiPath CLI for Linux'
  inputs:
    cliVersion: 'Linux.25.10.3'

# macOS (Apple Silicon)
- task: UiPathInstallPlatform@6
  displayName: 'Install UiPath CLI for macOS'
  inputs:
    cliVersion: 'macOS.25.10.3'

# Windows Legacy
- task: UiPathInstallPlatform@6
  displayName: 'Install UiPath CLI for Windows Legacy'
  inputs:
    cliVersion: 'Windows.Legacy.25.10.9424.14050'

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.3'

# 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.3.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.