25.10.16

Data de lançamento: 18 de maio de 2026

Novidades

Substitua a categoria raiz das atividades ao empacotar uma biblioteca

Quando você empacota um projeto de biblioteca, cada atividade exposta pelo pacote resultante recebe um prefixo de categoria raiz. Por padrão, esse prefixo é o nome do projeto da biblioteca. O novo parâmetro --activitiesRootCategory permite substituí-lo sem renomear o projeto.

uipcli package pack "C:\projects\MyLibrary\project.json" -o "C:\Output" --activitiesRootCategory "MyCompany.Finance.Invoicing"

As atividades no .nupkg resultante aparecerão em MyCompany.Finance.Invoicing no painel Atividades do Studio de qualquer projeto que instale a biblioteca.

O parâmetro tem efeito apenas ao empacotar um projeto de biblioteca . Isso é ignorado para tipos de saída Process, Tests e Objects . Quando omitido, o comportamento fica inalterado: a categoria raiz retorna ao nome do projeto da biblioteca, correspondendo ao que a caixa de diálogo Publicação da biblioteca no Studio produz.

Ignorar analisador e validação durante o pacote

O Analisador de Fluxo de Trabalho e a validação do projeto são executados automaticamente como parte do package pack. Dois novos sinalizadores permitem que você opte por não participar de qualquer uma das etapas:

• --skipAnalyze pule a execução do Analisador de fluxo de trabalho durante a etapa de empacotamento.
• --skipValidate pule a etapa de validação do projeto durante a etapa de pacote.

uipcli package pack "C:\projects\MyProject\project.json" -o "C:\Output" --skipAnalyze --skipValidate

Use esses sinalizadores quando:

• Seu pipeline já package analyze ou valida o projeto em um estágio anterior (por exemplo, em uma verificação pré-mescla), e você não quer pagar o mesmo custo novamente em pack.
• Você está produzindo um pacote rápido para depuração local e só precisa do artefato.

Para pipelines de lançamento, a recomendação ainda é deixar ambas as etapas habilitadas.

Resolver dependências apenas de --nugetConfigFilePath

O novo sinalizador --excludeConfiguredSources exclui os feeds integrados da UiPath e a configuração do NuGet no nível do usuário e no nível da máquina no host que executa a CLI (normalmente %AppData%\NuGet\NuGet.Config e %ProgramFiles(x86)%\NuGet\Config). A CLI resolve pacotes apenas dos feeds definidos no arquivo nuget.config que você passa por --nugetConfigFilePath.

uipcli package pack "C:\projects\MyProject\project.json" -o "C:\Output" \
  --nugetConfigFilePath "C:\ci\nuget.config" \
  --excludeConfiguredSources

Use esta sinalização quando:

• Você quer compilações herméticas e reprodutíveis onde apenas os feeds que você declara no controle de versão são consultados.
• Um agente de compilação compartilhada tem feeds no nível da máquina que você não deseja drenar para pipelines específicos.
• Você está depurando problemas "funciona no agente A, falha no agente B" causados por configuração conflitante do NuGet no nível do host.

Quando você executar uipcli com um arquivo de configuração, defina "excludeConfiguredSources": true.

Certifique-se de que seu nuget.config declare todos os feeds de que o projeto precisa, incluindo quaisquer equivalentes de feeds da UiPath, porque nenhuma outra origem será consultada quando esse sinalizador for definido.

Desempenho aprimorado no Linux e macOS para projetos com muito analisador

Ao empacotar um projeto que produz um alto volume de avisos do Analisador de Fluxo de Trabalho no Linux ou macOS, a CLI anteriormente levava vários minutos para drenar as mensagens do analisador após a conclusão da compilação real. O canal de comunicação interna entre a CLI e o SolutionPackager foi alterado para um transporte de socket de pipe/domínio Unix, removendo esse gargalo.

Nenhuma ação do usuário é necessária — pacotes que levavam mais de 15 minutos no Linux para saída do analisador Verbose agora são concluídos em segundos após o término da compilação. O comportamento do Windows não foi alterado.

Restauração mais rápida, sem mais downloads duplicados do NuGet em uma única execução

Quando uma única invocação de CLI acionava várias etapas de restauração (por exemplo, um pack que valida e, em seguida, empacota, ou um solution pack que restaura cada projeto), os mesmos pacotes NuGet podiam ser baixados mais de uma vez porque a janela do cache HTTP já havia sido expirou entre etapas. A CLI agora mantém pacotes já baixados em cache por 15 minutos dentro de uma única execução, então as etapas de restauração subsequentes reutilizam as cópias locais em vez de buscar novamente no feed.

Nenhuma ação do usuário é necessária — projetos com muitas dependências veem uma aceleração perceptível em comandos que realizam uma restauração do NuGet.

Versão e runtime impressos na inicialização

Cada invocação de CLI agora imprime um banner como sua primeira linha de saída:

uipcli: version 25.10.16, running on .NET 8.0.x

Isso torna os logs de suporte autodescritivos — não há ambiguidade sobre qual compilação de CLI ou qual runtime produziu um determinado arquivo de log.

Documentação atualizada

• Empacotando projetos em um pacote
• Restaurando dependências de automação
• Análise de um projeto
• Teste de um pacote ou execução de um conjunto de testes
• Gerenciando feeds do NuGet