Sobre o UiPath CLI

O UiPath® oferece uma interface de linha de comando (CLI) que permite executar determinadas tarefas pré-definidas para gerenciamento e teste de pacotes RPA. O objetivo do UiPath CLI é integrar facilmente esses recursos com ferramentas de terceiros, como GitLab, Jenkins e muitas outras, sem um plug-in.

Observação:

A CLI da UiPath pode ser usada com o Orchestrator implantado via Automation Cloud™ , Automation Suite ou independente.

Casos de uso comuns para o UiPath CLI envolvem:

• Empacotando projetos do Studio em pacotes NuGet.
• Implantando pacotes NuGet no Orchestrator.
• Executando trabalhos no Orchestrator.
• Executando conjuntos de testes no Orchestrator.

O UiPath CLI consiste em dois tipos:

1. UiPath.CLI.Windows

   • Funciona apenas em dispositivos Windows.
   • Constrói projetos Windows - legados,Windowse multiplataforma .

2. UiPath.CLI

   • É executado apenas em dispositivos Linux.
   • Constrói apenas projetos de plataforma cruzada .

Observação:

• A UiPath CLI não é compatível com conexão SSO.

• A UiPath CLI não pode ser usada para criar projetos que usam Gatilhos locais.

• O UiPath CLI não tem a funcionalidade para assinar um pacote, um recurso que está disponível ao publicar o pacote do Studio. Nesse caso, a única opção é assinar o pacote após ele ser criado usando o UiPath CLI. Para obter detalhes, consulte o comando assinar. Essa opção de assinatura também funciona para o Azure DevOps e Jenkins.

Pré-requisitos

Aqui você pode verificar a compatibilidade entre a versão da CLI, a versão do .NET necessária e a versão do Robot de destino.

Versão da CLI	Versão do .NET necessária	Versão do Robot de destino para as automações criadas
24.10	.NET 8	24.10+
23.10	.NET 6	23.10+
23.4	.NET 6	23.4+

Para o UiPath.CLI.Windows, você também deve instalar o .NET Desktop Runtime, que também vem com o .NET SDK.

Baixando o UiPath CLI

Você pode baixar qualquer versão do UiPath CLI no Feed Público Oficial da UiPath.

1. Acesse o feed público oficial da UiPath.
2. Na barra de pesquisa Filtrar por palavras-chave , digite uipath.cli.
3. Selecione uma das opções abaixo:
   • UiPath.CLI - UiPath CLI projetado para dispositivos Linux
   • UiPath.CLI.Windows - UiPath CLI projetado para dispositivos Windows
4. Vá para a guia Versões e selecione uma versão da CLI que deseja baixar.
5. Selecione Baixar.
6. Abra a pasta onde o arquivo NUPKG foi baixado, clique com o botão direito do mouse e extraia o arquivo em uma pasta.

Resultados: Uma pasta com o mesmo nome do arquivo NUPKG é criada. Esta pasta contém o conteúdo do UiPath CLI. O ponto de entrada para todas as operações é uipcli.exe (para UiPath.CLI.Windows) ou uipcli.dll (para UiPath.CLI), localizado na pasta tools .

Matriz de Compatibilidade UiPath.CLI.Windows

A versão do UiPath Studio que você está usando para criar seus projetos precisa corresponder à versão do UiPath.CLI.Windows.

Legenda: - compatível; - não compatível.

Orchestrator	Tipo de Projeto	UiPath.CLI.Windows 23.10	UiPath.CLI.Windows 23.6	UiPath.CLI.Windows 22.10
2023.10.x PaaS	Windows - Legacy
2023.10.x PaaS	Windows
2023.10.x PaaS	Multiplataforma
2021.10.x On-Premises	Windows - Legacy
2021.10.x On-Premises	Windows
2021.10.x On-Premises	Multiplataforma
2021.10.x PaaS	Windows - Legacy
2021.10.x PaaS	Windows
2021.10.x PaaS	Multiplataforma
2022.4.x	Windows - Legacy
2022.4.x	Windows
2022.4.x	Multiplataforma
2022.10.x	Windows - Legacy
2022.10.x	Windows
2022.10.x	Multiplataforma
2023.4.x	Windows-legacy
2023.4.x	Windows
2023.4.x	Multiplataforma
Cloud	Windows - Legacy
Cloud	Windows
Cloud	Multiplataforma

Matriz de Compatibilidade UiPath.CLI

A versão do UiPath Studio que você está usando para criar seus projetos precisa corresponder à versão do UiPath.CLI. Por exemplo, se você criar projetos usando o UiPath Studio 2021.10, você precisa usar a versão 21.10 do UiPath.CLI.

Legenda: - compatível; - não compatível.

Orchestrator	Tipo de Projeto	UiPath.CLI 23.10	UiPath.CLI 23.6	UiPath.CLI 22.10	UiPath.CLI 22.4	UiPath.CLI 21.10
2023.10.x PaaS	Windows - Legacy
2023.10.x PaaS	Windows
2023.10.x PaaS	Multiplataforma
2021.10.x On-Premises	Windows - Legacy
2021.10.x On-Premises	Windows
2021.10.x On-Premises	Multiplataforma
2021.10.x PaaS	Windows - Legacy
2021.10.x PaaS	Windows
2021.10.x PaaS	Multiplataforma
2022.4.x	Windows - Legacy
2022.4.x	Windows
2022.4.x	Multiplataforma
2022.10.x	Windows - Legacy
2022.10.x	Windows
2022.10.x	Multiplataforma
2023.4.x	Windows-legacy
2023.4.x	Windows
2023.4.x	Multiplataforma
Cloud	Windows - Legacy
Cloud	Windows
Cloud	Multiplataforma

Gerenciando feeds do NuGet

Esta seção descreve como você pode gerenciar os feeds integrados do NuGet. Além disso, ele fornece informações sobre como você pode usar feeds personalizados do NuGet de acordo com seus requisitos específicos do projeto.

Desabilitando os feeds integrados do NuGet

Por padrão, o uipcli pesquisa dependências nos seguintes feeds integrados:

• https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json

• https://gallery.uipath.com/api/v2

• https://api.nuget.org/v3/index.json

• C:\Program Files\Microsoft SDKs\NuGetPackages(se este caminho estiver no agente atual)
• C:\Program Files (x86)\Microsoft SDKs\NuGetPackages (se este caminho estiver no agente atual)

Você pode especificar uipcli para não usar os feeds integrados definindo o parâmetro --disableBuiltInNugetFeeds . Esse parâmetro pode ser usado para as seguintes tarefas: analyze, pack e test run.Ao executar uipcli com um arquivo de configuração, defina "disableBuiltInNugetFeeds": true.

Uso de feeds personalizados do NuGet

Você pode usar feeds personalizados ao empacotar uma automação.

Usando o nuget.config personalizado no UiPath CLI

Para usar o feed personalizado, siga as seguintes etapas:

1. Crie um arquivo nuget.config personalizado com o seguinte formato:

   <?xml version="1.0" encoding="utf-8"?>
   <configuration>
     <packageSources>
       <add key="test custom feed" value="custom_feed_url" />
     </packageSources>
   </configuration>

2. Coloque o arquivo nuget.config personalizado na pasta em que uipcli está em cache:

   

Uso do nuget.config personalizado no Azure DevOps

Você precisa atualizar a configuração e copiar nuget.config para $(Agent.ToolsDirectory)/uipcli, após a etapa InstallPlatform , conforme mostrado no exemplo a seguir:

trigger:
- main

pool:
  vmImage: ubuntu-latest

stages:
- stage: Demo
  jobs:
    - job: Demo
      steps:
        - task: UiPathInstallPlatform@4
          inputs:
            cliVersion: 'X_23.6.8581.19168'
        
        - task: CopyFiles@2
          inputs:
            SourceFolder: '$(Build.SourcesDirectory)'
            Contents: 'nuget.config'
            TargetFolder: '$(Agent.ToolsDirectory)/uipcli'

        - task: UiPathPack@4
          inputs:
            versionType: 'AutoVersion'
            projectJsonPath: '$(Build.SourcesDirectory)/AutomationProjects/CrossPlatform/VB/ProjectWithCustomLibraryFromOrchestrator_CrossPlatform_VB/project.json'
            outputPath: '$(Build.ArtifactStagingDirectory)/Output'
            traceLevel: 'Information'

Usando o nuget.config personalizado no Jenkins

Você precisa atualizar a configuração e copiar nuget.config para ${WORKSPACE}/CLI, após a etapa InstallPlatform , conforme mostrado no exemplo a seguir:

pipeline {
    agent {
        label 'plugins-jenkins-lts-agent-01'
    }

    stages {
        stage('Clone') {
            steps {
                git (
                    branch: 'main',
                    url: 'https://github.com/al3xandru-uipath-qa/CI-Plugins-Customer-Support.git'
                )
            }
        }
        
        stage('Install Platform') {
            steps {
                UiPathInstallPlatform (
                    traceLevel: 'Information'
                )
            }
        }
        
        stage('Copy nuget.config') {
            steps {
                bat 'copy nuget.config CLI\\nuget.config'
            }
        }
        
        stage('Pack') {
            steps {
                UiPathPack (
                    outputPath: '${WORKSPACE}/Output',
                    projectJsonPath: '${WORKSPACE}/AutomationProjects/CrossPlatform/VB/ProjectWithCustomLibraryFromOrchestrator_CrossPlatform_VB/project.json',
                    traceLevel: 'Information',
                    version: AutoVersion()
                )
            }
        }
    }
}