Como gerenciar dependências

Gerencie as dependências do projeto no Studio, incluindo a adição, atualização e remoção de pacotes de atividades vinculados a um projeto de automação.

As dependências do projeto no Studio referem-se a pacotes vinculados a um projeto específico. Esses pacotes contêm atividades, padrão ou personalizadas.

As dependências são contextuais e contabilizam:

• Atividades que o projeto usa
• Variáveis do projeto
• Argumentos de entrada e saída

Uma dependência é definida apenas se tiver pelo menos uma referência na definição do projeto.

Dependências padrão e personalizadas

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

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 .

The Explorer panel displays the activities packages installed in the automation project, together with their sub dependencies, runtime rules, requested, and resolved versions. The project compatibility is displayed in the Dependencies node.

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. Você também pode instalar um pacote adicionando uma das atividades que ele contém a um projeto da categoria Disponível do painel de Atividades ou barra de pesquisa Adicionar atividade.

Sempre que novas versões estiverem disponíveis para as dependências do projeto atual, o botão botão Gerenciar Pacotes, da faixa de opções recebe um ícone de atualização .

1. To manage dependencies in a project, open the context menu for the Dependencies category in the Explorer panel, and then select 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, select 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ê selecionar Salvar. Ao mesmo tempo, as versões das dependências são atualizadas no project.json arquivo pertencente ao projeto.

Resultado

As dependências selecionadas são adicionadas ou atualizadas no projeto. As versões do pacote são atualizadas no arquivo project.json .

Como Remover Dependências

• To remove a project dependency, right-click the dependency in the Explorer panel, and then select Remove Dependency. The dependency is removed from the Explorer panel and project.json file. Alternatively, you can go to Manage Packages > Project Dependencies, select the dependency to remove, and then click Uninstall.
• To remove all unused dependencies in the project, select Remove Unused > Dependencies in the Studio ribbon, or use the Ctrl + Shift + R keyboard shortcut. All the installed packages that have no references in the current project are removed from the Explorer panel and project.json file.

Como Reparar Dependências

If a workflow opened in Studio has references to packages with versions that aren’t available in current Studio feeds, said dependencies are marked as broken in the Explorer panel and details are made available in the Output panel.

Como Reparar Dependências

Studio allows for all dependencies to be repaired in bulk or individually. To repair all broken dependencies, right-click on the Dependency node in the Explorer panel, and click on Repair Dependencies.

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.

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 Explorer 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 Explorer panel, under Dependencies by the sign next to the package version.

Execução com regras de dependência

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 leva em consideração as regras de runtime de dependência definidas anteriormente. No entanto, conflitos entre versões podem ocorrer ao automatizar projetos.

Tanto o projeto de automação quanto suas bibliotecas podem conter o mesmo pacote de atividades com diferentes versões e regras de runtime. No período de design, o NuGet resolve esses conflitos escolhendo a dependência do nível superior — aquela mais próxima do projeto na hierarquia.

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.

A resolução desse cenário é aplicável independentemente da regra de runtime (Estrita ou Versão Mais Antiga Aplicável ) definida anteriormente para os pacotes de atividades.

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

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

Dependências para projetos antigos

Os processos que contêm dependências e foram criados com versões do Studio anteriores à v2018.3 continuam a executar com o Robô v2018.3. A regra de runtime desses projetos é definida como a Versão mais baixa aplicável.

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 ;
• 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. Open the .xaml file with Studio v2018.3 or above for the migration to be performed. The deprecated activities packages are replaced with new ones, as illustrated in the Dependencies section of the Explorer panel.
   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.