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

To add dependencies to a project, install them from the Manage Packages window. Please note that the available packages differ based on the project compatibility.

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.

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 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.

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.

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 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.

Após a confirmação, o Studio tenta recuperar dependências ausentes e define as dependências estritas para os pacotes que encontrar. Ao usar a opção Reparar Dependência, no painel Projeto , o Studio tenta instalar a próxima versão mais nova do projeto. Se a versão do pacote não for encontrada, serão exibidos alertas no painel Saída . Você deverá verificar os feeds configurados na janela Gerenciar Pacotes .

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 .

Os projetos criados com versões anteriores à v2018.3 que nunca foram publicados não têm dependências listadas no project.json arquivo. Ao abrir tais projetos, um alerta no painel Saída notificará você sobre dependências ausentes. Os pacotes da UiPath entregues localmente com o Studio são adicionados como dependências com o Strict regra de tempo de execução. A versão mais recente desses pacotes é definida automaticamente.

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.