Como gerenciar dependências

As dependências do projeto no Studio se referem aos pacotes vinculados a um projeto específico, contendo atividades, seja padrão, seja personalizadas. As dependências são contextuais e consideram a definição de cada projeto, incluindo as atividades que ele usa, as variáveis e os argumentos de entrada/saída. Portanto, uma dependência será definida apenas se tiver pelo menos uma referência na definição do projeto.

No Studio, as dependências padrão para um projeto diferem dependendo do tipo de projeto, da compatibilidade ou do modelo usado para criar o projeto.

No StudioX, todos os projetos vêm com os seguintes pacotes padrão: UiPath.System.ActivitiesUiPath.ComplexScenarios.Activities, UiPath.Excel.Activities, UiPath.Mail.Activities, UiPath.Presentations.Activities, UiPath.UIAutomation.Activities, e UiPath.Word.Activities.

Se precisar adicionar mais, clique no botão Gerenciar Pacotes e instale-os. Dependências instaladas ficam disponíveis apenas para o projeto atual e a lista de dependências por projeto fica visível no project.jsonarquivo .

O painel Projeto exibe os pacotes de atividades instalados no projeto de automação, junto com suas subdependências, regras de runtime, versões solicitadas e resolvidas. A compatibilidade do projeto é exibida no nó Dependências.

Passe o mouse sobre uma dependência para visualizar as versões solicitadas e resolvidas. Ações contextuais como Gerenciar, Reparar ou Remover Dependência estão disponíveis apenas para dependências e não seus subpacotes.

O status das dependências na árvore é codificado por cores da seguinte forma:

• Vermelho - A dependência não foi encontrada.
• Laranja - Um subpacote não foi encontrado.
• Cinza - A dependência não está resolvida.
• Azul desbotado - A versão resolvida é maior do que a versão solicitada.
• Azul intenso - Há uma correspondência exata entre a versão solicitada e a versão resolvida.

Adicionar e Atualizar Dependências

Para adicionar dependências a um projeto, instale-as a partir da janela Gerenciar Pacotes. Observe que os pacotes disponíveis diferem com base na compatibilidade do projeto.

Whenever new versions are available for the current project dependencies, the Manage Packages button from the ribbon gets an update icon .

1. To manage dependencies in a project, simply right-click on the Dependencies category in the Project panel, and then click on Manage. This opens the Manage Packages window, with the Project Dependencies category. The icon shows which packages are currently installed.

   

2. Default dependencies are displayed, together with the versions that are currently linked to the project. To update a package, simply click on the update icon , next to the available version number. The icon is shown next to the package, meaning that dependencies are ready to be installed.

3. As dependências são instaladas no projeto somente depois que você clicar em Salvar. Ao mesmo tempo, as versões das dependências são atualizadas no project.jsonarquivo pertencente ao projeto.

Como Remover Dependências

• Para remover uma dependência do projeto, clique com o botão direito do mouse na dependência no painel do Projeto e depois em Remover dependência. A dependência é excluída do painel Projeto e do arquivo project.json. Alternativamente, vá em Gerenciar pacotes > Dependências do projeto, selecione a dependência a remover e então clique em Desinstalar.
• Para remover todas as dependências não usadas no projeto, selecione Remover não usadas > Dependências na faixa de opções do Studio ou use o atalho Ctrl + Shift + R. Todos os pacotes instalados que não possuem referências no projeto atual são removidos do painel Projeto e do arquivo project.json.

Como Reparar Dependências

Se um fluxo de trabalho aberto no Studio tiver referências aos pacotes com versões que não estão disponíveis nos feeds do Studio atual, tais dependências serão marcadas como quebradas no painel Projeto e os detalhes serão disponibilidados no painel Saída.

O Studio permite que todas as dependências sejam reparadas em massa ou individualmente. Para reparar todas as dependências quebradas, clique com o botão direito do mouse no nó da Dependência, no painel Projeto e clique em Reparar Dependências.

Clique com o botão direito do mouse em uma dependência quebrada e selecione Resolver Dependência para repará-la individualmente. Alternativamente, é possível selecionar a opção Gerenciar para abrir a janela Gerenciar Pacotes e atualizá-los.

NuGet resolves broken dependencies by applying the Lowest Applicable Version runtime rule, meaning that it searches for the first applicable package version, higher than the one previously set.

Se a versão de destino não puder ser encontrada, a função de reparo usará automaticamente a próxima versão superior disponível. Observe que esse comportamento depende da configuração do feed.

Observação:

As atividades ausentes ou inválidas são marcadas no painel Designer, ao passo que um banner de erro fornece informações adicionais sobre o fluxo de trabalho e seus conflitos de dependência não resolvidos.

Como Configurar Regras de Dependência

Pacotes de atividades ficam disponíveis em várias versões e, por isso, ao instalá-los ou atualizá-los usando a janela Gerenciar pacotes, é possível definir regras de runtime de dependência para cada um deles.

A Regra de Runtime especifica qual versão do pacote a instalar no runtime. Ele apresenta duas opções disponíveis.

The Strict runtime rule is the default state for dependencies added upon process creation, and for activities packages installed from the Manage Packages window. It means that only the specified version of the package is used at runtime to execute the parent process. The Strict rule is marked in the Project panel, under Dependencies by the sign next to the package version.

The Lowest Applicable Version runtime rule means that if the target package isn’t found, the next higher version is searched in order to resolve dependencies. The Lowest Applicable Version rule is marked in the Project panel, under Dependencies by the sign next to the package version.

Ao executar um projeto de automação a partir do Studio, o robô faz o download da versão do pacote específica ou indicada da qual ele precisa para executar o projeto de acordo com as regras do ambiente de execução para cada projeto. Se a dependência usada durante a execução tiver uma regra de ambiente de execução Estrita e a versão de pacote exata não tiver sido encontrada, ocorrerá um erro. Para mais informações sobre a definição de regras do runtime para dependências do projeto, veja a página Gerenciando dependências.

Como Resolver Conflitos de Dependência

A instalação de pacotes de atividades considera as regras de runtime de dependência definidas anteriormente para tais pacotes. Porém, alguns conflitos entre versões podem ocorrer durante a automatização dos projetos. Tanto o projeto de automação quanto a biblioteca que ele contém podem ter o mesmo pacote de atividades, mas com versões diferentes e regras de runtime. No momento do design, o NuGet resolve esses conflitos, escolhendo a dependência do nível superior, que é a mais próximo do projeto na hierarchy.

Explicamos abaixo a resolução dos conflitos que podem ocorrer:

O projeto contém um pacote de atividades com a versão 1.0. A biblioteca é referenciada ao projeto e usa o mesmo pacote, mas com uma versão mais recente. A dependência de nível superior v1.0 é usada no runtime. Um aviso será fornecido, mencionando a detecção de um downgrade.

The resolution of this scenario is applicable regardless of the runtime rule (Strict or Lowest Applicable Version ) previously set for the activities packages.

• Se você escolher Sim, o pacote de atividades referenciado no projeto será atualizado para a versão usada na biblioteca.

• Se você escolher Não, a janela Gerenciar Pacotes será aberta com a janela Dependências do Projeto.

  

The project contains an activities package with the version 2.0. The library uses the same pack, but with a lower version and the Strict runtime rule. The top level dependency used in this case is v2.0 and a warning is given when the package is installed in the project.

The project contains an activities package with the version 2.0. The library uses the same pack, but with a lower version and the Lowest Applicable Version runtime rule. The top level dependency used in this case is v2.0 and a warning is given when the package is installed in the project.

The project references a library with an activities package version 1.0 and Strict runtime rule. The project references another library, but with an activities package version 2.0. The top level dependency in this case is the pack with v2.0, since it has the highest version. A warning is given when the activities package is installed.

In this conflict the project references two libraries, which in turn have Strict dependencies referenced among them. This scenario isn't supported. For detailed information, check the Dependency Resolution page.

Ciclos de dependência são tipos de conflitos que ocorrem quando um pacote referencia a si mesmo. Se você nomear seu projeto UiPath, o Studio detectará um conflito de dependência. Isso acontece porque o pacote UiPath já existe e é uma dependência do UiPath.UIAutomation.Activities. É recomendável evitar nomear seu projeto com o nome de um pacote já existente que você pretenda adicionar como uma dependência.

O mesmo ciclo de dependência ocorre se você abrir um .xamlarquivo de uma pasta chamada UiPath ou qualquer nome de um pacote existente que você pretenda adicionar como uma dependência, e não houver nenhum project.jsonnaquela pasta. project.jsonAo abrir um arquivo que não tem um .xamlarquivo associado, o Studio cria um e a "name"tag é preenchida com o nome da pasta parent.

Como Abrir Projetos Criados com Versões Anteriores

Importante:

Como abrir projetos com o Studio v2016.2 diretamente no v2020.4 ou versões posteriores. Primeiro, abra os projetos com o Studio v2018.4 e depois com a versão 2020.4 ou posterior.

Ao abrir um projeto com ou sem dependências, desenvolvido com uma versão anterior à v2018.3 (exceto para a v2016.2), o Studio solicitará a execução de uma migração automática, para que tente recuperar as dependências não encontradas e adicionar dependências padrão.

Upon confirmation, Studio attempts to retrieve missing dependencies and sets the Strict runtime rule for the packages that it finds. When using the Repair Dependency option in the Project panel, Studio attempts to install the next best package version. If the package version is not found, alerts are shown in the Output panel and you should check the configured feeds in the Manage Packages window.

Processes containing dependencies and that were built with Studio versions prior to v2018.3 continue to execute with Robot v2018.3. The runtime rule for such projects is set to Lowest Applicable Version.

Projects created with versions prior to v2018.3 that were never published don't have dependencies listed in the project.json file. When opening such projects, an alert in the Output panel notifies you of missing dependencies. UiPath packages delivered locally with Studio are added as dependencies with the Strict runtime rule. The latest version of such packages is automatically set.

Se tais projetos contêm pacotes diferentes dos fornecidos localmente com o Studio, recomendamos:

• Publicar o projeto usando a versão do Studio na qual ele foi criado, auxiliando, assim, o processo de migração por meio da adição de dependências no project.jsonarquivo ;
• Instalar manualmente o pacote ausente na janela Gerenciar Pacotes, após configurar o feed necessário;
• Usando a ferramenta Atualização em Massa de Dependências do Projeto para adicionar a dependência ausente a um grande número de projetos.
  Observação:

  Fluxos de trabalho contendo atividades inválidas não podem ser salvos. Instale a dependência necessária e, em seguida, salve o projeto.

  UiPath.Platform.ActivitiesOs pacotes de atividades UiPath.V7.Activities, e UiPath.Framework.Activitiesforam descontinuados. Ao abrir projetos com UiPath.Framework.Activitiespacotes UiPath.Platform.Activitiese , o Studio v2018.3 ou superior tenta realizar uma migração automática para substituir as versões antigas das atividades pelas novas.

Observação:

Fluxos de trabalho que contêm atividades que fazem parte do UiPath.V7.Activitiespacote não podem ser migrados.

Existe uma solução alternativa, disponível para alguns casos nos quais a migração é é feita automaticamente.

1. Abra o project.jsonarquivo com o Notepad++.
2. Remova o "schemaVersion": "3.2"parâmetro.
3. Substitua "studioVersion"por "toolVersion".
4. Altere o "toolVersion"valor de "18.3.xxx"para uma versão anterior. Por exemplo, altere o valor de "18.3.0.958"para "18.2.958". Salve o arquivo.
5. Abra o .xamlarquivo com o Studio v2018.3 ou posterior para que a migração seja executada. Os pacotes de atividades descontinuados são substituídos por novos, conforme ilustrado na seção Dependências do painel Projeto.
   Observação:

   Em alguns casos, os .xaml arquivos que contêm os pacotes UiPath.Platform.Activities e UiPath.Framework.Activities não podem ser migrados automaticamente e a solução alternativa não é aplicável. Em situações como essas, o recomendado é abrir os projetos no Studio v2018.2 ou inferior, substituindo as atividades que pertencem aos pacotes mencionados acima pelas atividades contidas no UiPath.Core.Activities pacote. O mesmo pode ser feito em relação aos fluxos de trabalho que contêm atividades do UiPath.V7.Activities pacote.

   A partir do Studio v2018.4.1, Microsoft.Activities v.1.0.1 e Microsoft.Activities.Extensions v2.0.6.9 não mais são incluídos no UiPathStudio.msiinstalador .

Caso seja necessário reparar durante a migração de projetos contento tais pacotes como dependências, instale os dois pacotes a partir do feed Oficial ou de um feed local. Antes de executar tais projetos criados com versões anteriores à v2018.4.1, verifique se os pacotes acima estão disponíveis em um feed que o Robô possa acessar.

Se você fizer o upgrade de uma versão anterior à v2018.4.1, os dois pacotes de atividades permanecerão no feed Local.