Como restaurar e analisar soluções

Antes de empacotar uma solução, você normalmente restaura suas dependências e a valida em relação a regras de governança. Essas operações são executadas localmente e não exigem autenticação do Orchestrator.

Como restaurar dependências

O comando restore baixa todos os pacotes de atividades e dependências do projeto necessários para uma pasta local.

Sintaxe de comando

uipcli solution restore <solution-path> [options]

Parâmetros:

Parâmetro	Description	Required
<solution-path>	Caminho para a pasta Solution ou o arquivo .uipx	Sim
--restoreFolder	Caminho local em que as dependências são restauradas	Não
--traceLevel	Nível de registro em log: Verbose, Information, Warning	Não

Exemplo

uipcli solution restore C:\Solutions\MySolution \
  --restoreFolder C:\Work\Output \
  --traceLevel Verbose

Uso de feeds personalizados do NuGet

Se sua solução depende de atividades de feeds personalizados ( incluindo feeds do Orchestrator), você pode fornecer um arquivo nuget.config no diretório de solução ou especificar feeds usando os parâmetros do Orchestrator da biblioteca:

uipcli solution restore C:\Solutions\MySolution \
  -A myorg \
  -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
  -S **** \
  --libraryOrchestratorApplicationScope "OR.Folders OR.Settings.Read" \
  --libraryOrchestratorTenant DefaultTenant \
  --libraryOrchestratorUrl https://cloud.uipath.com/ \
  --libraryOrchestratorFolder MyFolder \
  --traceLevel Verbose

Consulte Gerenciar feeds do NuGet para obter mais detalhes sobre como configurar origens de atividades.

Considerações de desempenho

A restauração do NuGet costuma ser a etapa mais lenta no empacotamento de uma solução. Cada operação de restauração deve resolver as dependências diretas e transitivas.

Para melhorar o desempenho da restauração:

1. Armazene em cache a pasta do pacote global NuGet entre as execuções do pipeline:
   • Windows: %UserProfile%\.nuget\packages
   • Linux/macOS: ~/.nuget/packages
2. Use um nuget.config cortado apenas com feeds acessíveis:
   • Remova feeds lentos ou inacessíveis da configuração.
   • Ordene feeds por confiabilidade e velocidade.
3. Use agentes auto-hospedados se o cache persistente for necessário.

Consulte a documentação de Gerenciamento de feeds do NuGet para obter exemplos de cache no Azure DevOps e outras plataformas de CI/CD.

Analisando uma solução

O comando analyze valida a solução em relação às regras e políticas de governança do Analisador de Fluxo de Trabalho.

Sintaxe de comando

uipcli solution analyze <solution-path> [options]

Parâmetros:

Parâmetro	Description	Required
<solution-path>	Caminho para a pasta Solution ou o arquivo .uipx	Sim
--governanceFilePath	Caminho para o arquivo JSON da política de governança	Não
--resultPath	Caminho em que os resultados JSON dos resultados da análise serão salvos	Não
--analyzerTraceLevel	Nível de registro em log do analisador: Warning, Information, Verbose	Não
--traceLevel	Nível de log da CLI	Não

Exemplo

uipcli solution analyze C:\Solutions\MySolution \
  --governanceFilePath C:\Policies\uipath.policy.Production.json \
  --resultPath C:\Output\analyze.json \
  --analyzerTraceLevel Warning \
  --traceLevel Information

Políticas de governança

As políticas de governança definem regras que devem ser atendidas antes que uma solução possa ser empacotada e implantada. Elas normalmente incluem:

• Padrões de qualidade do código
• Convenções de Nomes
• Verificações de segurança
• Limites de desempenho

Arquivos de políticas são documentos JSON que configuram regras do Analisador de Fluxo de Trabalho. Você pode:

• Criar políticas no Studio
• Exporte-as do Orchestrator
• Controle-os de versão junto com o código da solução

Usando resultados de análise no CI/CD

Os resultados da análise JSON podem ser analisados pelo seu pipeline para:

• A compilação falhará se violações críticas forem encontradas
• Gerar relatórios de conformidade
• Implantações de gateway para ambientes de produção

Fluxo de trabalho típico

Um padrão de CI/CD comum combina restauração e análise antes do empacotamento:

# 1. Restore dependencies
uipcli solution restore C:\Solutions\MySolution \
  --restoreFolder C:\Output\Dependencies \
  --traceLevel Information

# 2. Analyze against governance rules
uipcli solution analyze C:\Solutions\MySolution \
  --governanceFilePath C:\Policies\production.json \
  --resultPath C:\Output\analysis.json \
  --analyzerTraceLevel Warning

# 3. Check analysis results

# 4. Continue to packaging...

Isso garante que apenas soluções validadas e compatíveis prossigam para o empacotamento e a implantação.