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.

Todos os modelos de projeto disponíveis no Studio vêm com seus próprios pacotes de dependências padrão.

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.

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. As dependências não resolvidas são marcadas em cinza na árvore; as dependências não encontradas são marcadas em vermelho. Por outro lado, as dependências revolvidas e as com correspondência exata são marcadas em azul claro e azul escuro, respectivamente.

Adicionar e Atualizar Dependências

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

1. Para gerenciar dependências em um projeto, clique com o botão direito do mouse na categoria Dependências, no painel Projeto e clique em Gerenciar. Isso abre a janela Gerenciar Pacotes, com a categoria Dependências do Projeto. O ícone mostra quais pacotes estão instalados atualmente.

   

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.

To add dependencies to a project, simply search and install them as you would any activity package. For more information, check the Manage Packages page.

Como Remover Dependências

1. Para remover uma dependência do projeto, basta clicar com o botão direito do mouse na dependência, no painel Projeto.
2. Selecione Remover Dependência e a dependência será removida do painel Projeto e do project.jsonarquivo .

Alternativamente, isso pode ser feito clicando-se no botão Desinstalar, disponível para cada dependência em Gerenciar Pacotes > categoria Dependências do Projeto.

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 resolve dependências quebradas, aplicando a regra de runtime Versão Mais Antiga Aplicável , o que significa que ele procura a primeira versão de pacote aplicável, superior àquela definida anteriormente.

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.

A regra de runtime Estrita é o estado padrão para dependências adicionadas na criação do processo e para os pacotes de atividades instalados a partir da janela Gerenciar Pacotes. Isso significa que apenas a versão especificada do pacote é usada no runtime para executar o processo pai.A regra Estrita é marcada no painel Projeto, em Dependências pelo sinal , ao lado da versão do pacote.

A regra de runtime Versão Mais Antiga Aplicável indica que se o pacote de destino não for encontrado, a próxima versão mais recente será pesquisada para resolver problemas de dependências.A regra Versão Mais Antiga Aplicável é marcada no painel Projeto, em Dependências pelo sinal , ao lado da versão do pacote.

When executing an automation project from Studio, the Robot downloads the specified or indicated package version it needs to execute the project, in accordance to the previously set runtime rules for each project. If the dependency used during execution has a Strict runtime rule and the exact package version was not found, an error is thrown. For more information on setting runtime rules for project dependencies check the Managing Dependencies page.

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.

  

O projeto contém um pacote de atividades com a versão 2.0. A biblioteca usa o mesmo pacote, mas com uma versão mais antiga e a regra de runtime Estrita .A dependência de nível superior usada neste caso será a v2.0 e um aviso será feito quando o pacote estiver instalado no projeto.

O projeto contém um pacote de atividades com a versão 2.0. A biblioteca usa o mesmo pacote, mas com uma versão inferior e a regra de runtime Versão Mais Antiga Aplicável .A dependência de nível superior usada neste caso será a v2.0 e um aviso será feito quando o pacote estiver instalado no projeto.

O projeto faz referência a uma biblioteca com um pacote de atividades versão 1.0 e a regra de runtime Estrita . O projeto faz referência a outra biblioteca, mas com um pacote de atividades versão versão 2.0. A dependência do nível superior neste caso é o pacote com v2.0, pois ele tem a versão mais alta. Um aviso será feito quando o pacote de atividades estiver instalado.

Neste conflito o projeto faz referências a duas bibliotecas, as quais, por sua vez, têm dependências Estritas mencionadas entre elas. Não há suporte para este cenário. Para obter informações detalhadas, confira a página Resolução de Dependências.

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 não tem suporte. Primeiro, abra esses projetos com o Studio v2018.4 e, depois, com o v2020.4.

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 ;

• Manually installing the missing package from the Manage Packages window, after setting up the required feed;

• Using the Project Dependencies Mass Update tool to add the missing dependency to a bulk of projects.

  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:

   In some cases, .xaml files containing the packages UiPath.Platform.Activities and UiPath.Framework.Activitiescannot be automatically migrated and the workaround isn't applicable. For these situations, it is recommended to open the projects in Studio v2018.2 or lower, and replace the activities belonging to the aforementioned packages with activities contained in the UiPath.Core.Activities package. The same can be done for workflows containing activities from UiPath.V7.Activities package.

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.