Extensão para Java

Observação: para Java 9+, a extensão UiPath para Java funciona em edições Windows Enterprise e não Enterprise com aplicativos abertos com Java JDK. Para aplicativos abertos com o Java JRE, a Extensão UiPath para Java funciona apenas em edições do Windows não Enterprise. Leia mais no guia de Solução de Problemas da Extensão Java.

A partir do Studio e da Linha de Comando

A Extensão UiPath para Java é instalada fazendo o seguinte:

1. Primeiro, feche qualquer aplicativo Java em execução. Inicie o Studio e acesse a aba Ferramentas a partir da exibição Backstage do Studio. As extensões que você pode instalar se tornem visíveis. Clique no botão Extensões Java. Uma mensagem de confirmação aparece, informando que a extensão foi instalada.
2. Execute este comando C:\Program Files (x86)\UiPath\Studio\UiPath\SetupExtensions.exe /Java em uma janela de prompt de comando com direitos de administrador.

O Studio e o UI Explorer também pedem para instalar a Extensão UiPath para Java quando você tentar selecionar um controle dentro de um aplicativo Java e quando a ponte não é detectada. Observe que se você escolher instalar a Extensão UiPath para Java quando solicitado pelo UI Explorer, os arquivos do Java Bridge são implantados apenas no diretório JRE que lançou o aplicativo Java de destino em vez do diretório JDK.

Observação: para instalar esta extensão, você deve ter direitos de administrador.

Para verificar se a extensão não está funcionando corretamente, abra o UI Explorer e tente selecionar controles dentro de um aplicativo Java. Se a janela inteira estiver selecionada, significa que a extensão não está funcionando corretamente.

Você pode saber se a extensão está instalada corretamente pelos seletores gerados para controles Java.

• Seletor válido para controles Java: <wnd app=”...” /><java role=”...” />
• Seletor inválido para controles Java: <wnd app=”...” /><ctrl role=”client” />

Observação: a extensão UiPath para Java é compatível apenas com aplicativos AWT (por exemplo, Java Swing, Oracle Forms e Fujitsu JBK), enquanto que aplicativos SWT são automatizados com Active Accessibility. Para detectar o tipo de seu aplicativo Java, verifique o atributo cls (nome de classe de janela) no UI Explorer. O nome da classe deve ser semelhante a SunAwtFrame ou javax.swing.

Os processos podem interagir com aplicativos Java independentemente de sua escala de DPI.

A Extensão UiPath para Java também pode ser instalada usando a ferramenta ScreenScrapeJavaSupport.

Instalando a Extensão em uma Pasta Personalizada

Para Java 8 ou Anterior

Para que a Extensão UiPath para Java seja instalada em um local personalizado, as seguintes etapas precisam ser realizadas:

1. Crie uma nova pasta na sua máquina na qual você deseja instalar a Extensão UiPath para Java (como C:\UiPathJavaExt) e copie os seguintes arquivos para ela:
   1. UiPathBridge.jar - localizado no diretório %UserProfile%\.nuget\packages\uipath\20.xx.xxxx\build\UiPath\JavaSupport.
   2. UiPathJavaBridgeV8.dll e UiPathJavaBridgeV8_x64.dll localizados no diretório %UserProfile%\.nuget\packages\uipath\20.xx.xxxx\build\UiPath. Não é necessário copiar ambos os arquivos, mas pode evitar problemas que podem ocorrer devido à incompatibilidade de versões entre o JRE e o UiPathJavaBridge.
2. O mecanismo de Configuração de Extensão do Java usado pelo UiPath para instalar a extensão implanta os arquivos UiPathBridge.jar e accessibility.properties no diretório de instalação do Java (geralmente C:\Program Files (x86)\Java\jre1.8.0_xx). Para usar a Extensão UiPath para Java a partir de uma pasta personalizada, a dependência para esses arquivos deve ser atenuada da seguinte maneira:
   1. Para o arquivo UiPathBridge.jar, você precisa especificar a pasta na qual você copiou UiPathBridge.jar e UiPathJavaBridgev8.dll (como C:\UiPathJavaExt) quando você iniciar o aplicativo Java que usa a extensão. Isso é feito por meio do argumento -Djava.ext.dirs = C:\UiPathJavaExt.
   2. Para o arquivo accessibility.properties, há dois métodos:
      • Adicione o parâmetro assistive_technologies=UiPath.UiPathBridge ao arquivo de configuração global accessibility.properties localizado no diretório %userprofile%. Observe que esse arquivo é diferente daquele implantado pela Extensão UiPath para Java, e suas configurações têm precedência sobre as que estão definidas pela instalação Java.
      • Use o argumento -Djavax.accessibility.assistive_technologies=UiPath.UiPathBridge quando você executar o aplicativo Java de destino.

As propriedades do sistema precisam ser passadas corretamente para o aplicativo Java de destino. Isso pode ser feito por meio de vários métodos:

• Inclua a propriedade -Djava.ext.dirs=C:\UiPathJavaExt -Djavax.accessibility.assistive_technologies=UiPath.UiPathBridge do sistema na variável de ambiente _JAVA_OPTIONS. O JRE carrega as propriedades da variável de ambiente e da Extensão do UiPath para Java carregada no aplicativo de destino.
• Use o comando C:\Program Files (x86)\Java\jre1.8.0_xx\bin\java.exe -Djavax.ext.dirs=C:\UiPathJavaExt -Djavax.accessibility.assistive_technologies=UiPath.UiPathBridge -jar SwingSet2.jar dentro do prompt de comando. Uma mensagem de confirmação aparece indicando que a Extensão do UiPath para Java foi carregada com sucesso.
• Inclua a propriedade -Djava.ext.dirs=C:\UiPathJavaExt -Djavax.accessibility.assistive_technologies=UiPath.UiPathBridge do sistema na variável de ambiente JAVA_TOOL_OPTIONS. Observe que esse método funciona apenas com o Java 5 ou posterior.

A passagem de propriedades para um applet Java é feita com um dos seguintes métodos:

1. Usando a aplicação appletviewer.exe.
   Este método requer que você crie primeiro o arquivo .java.policy na pasta %userprofile% e deve conter o seguinte:

   grant { 
       permission java.net.URLPermission "url_of_the_Java_applet", "<em>:</em>"; 
   };

   Após essa conclusão, o applet de destino precisa ser iniciado por meio de appletviewer.exe com este comando:

   C:\Program Files (x86)\Java\jre1.8.0_xx\bin\appletviewer.exe -J-Djava.ext.dirs=C:\UiPathJavaExt -J-Djavax.accessibility.assistive_technologies=UiPath.UiPathBridge url_of_the_java_applet

2. Usando o Painel de controle do Java que é entregue com o JRE.

   O Painel de controle Java permite que você especifique os parâmetros de runtime para cada JRE. Dessa forma, é necessário que você especifique o

   -Djava.ext.dirs=C:\UiPathJavaExt -Djavax.accessibility.assistive_technologies=UiPath.UiPathBridge

   parâmetro do miniaplicativo de destino. Isso faz com que a Extensão UiPath para Java seja carregada sempre que o applet Java for iniciado.

A tabela abaixo apresenta a compatibilidade entre os métodos usados acima, versões Java e diferentes tipos de aplicativos Java:

Tipo de Aplicativo	_JAVA_OPTIONS	JAVA_TOOL_OPTIONS	Parâmetros de Linha de Comando	Painel de controle Java - Parâmetros de Runtime
Aplicativo para Computadores do Java	Java 3 para Java 8	Java 5 para Java 8	Java 3 para Java 8	Não Compatível
Aplicativo Contido do Java (.exe)	Java 3 para Java 8	Java 5 para Java 8	Java 3 para Java 8 (1)	Não Compatível
Applet Java	Java 3 para Java 8	Java 5 para Java 8	Não Compatível	Java 3 para Java 8
Formulários do Oracle Java	Não Compatível	Não Compatível	Não Compatível	Não Compatível

(1) - Dependendo da ferramenta de linha de comando que você usar, os parâmetros adicionais podem ser passados por meio das variáveis de ambiente.

Para Java 9 ou posterior

A partir do Java 9, o Mecanismo de Extensão Java é removido, o que significa que o argumento -Djava.ext.dirs não pode ser usado em aplicativos com Java 9 e superiores. Dessa forma, as seguintes etapas precisam ser realizadas:

1. Crie uma nova pasta na sua máquina na qual você deseja instalar a Extensão UiPath para Java (como C:\UiPathJavaExt) e copie os seguintes arquivos para ela:
   1. UiPathBridge.jar e UiPathJavaServiceProvider.jar- localizados no diretório %UserProfile%\.nuget\packages\uipath\20.xx.xxxx\build\UiPath\JavaSupport.
   2. UiPathJavaBridgeV8.dll e UiPathJavaBridgeV8_x64.dll localizados no diretório %UserProfile%\.nuget\packages\uipath\20.xx.xxxx\build\UiPath. Não é necessário copiar ambos os arquivos, mas pode evitar problemas que podem ocorrer devido à incompatibilidade de versões entre o JRE e o UiPathJavaBridge.
2. Adicione a pasta criada anteriormente ao caminho de classe do aplicativo Java de destino. Isso é feito com o comando -cp, -classpath. Por conta do nosso exemplo, consideramos o SwingSet2 como o aplicativo Java de destino:

   C:\Program Files (x86)\Java\jre1.9.0_xx \bin\java.exe -cp SwingSet2.jar;C:\UiPathJavaExt\* -Djavax.accessibility.assistive_technologies=UiPathJavaServiceProvider SwingSet2

Suporte a Dimensionamento no Aplicativo

O dimensionamento tem suporte total em aplicativos Java 9+ através de parâmetros. Considere adicionar os parâmetros a seguir ao aplicativo Java que deseja automatizar, a fim de habilitar o suporte ao dimensionamento:

• sun.java2d.uiScale.enabled ─ Quando não utilizado ou definido como o valor exato da string de "true", ele será considerado como verdadeiro e a seguinte configuração de dimensionamento será levada em consideração. Quando definido com qualquer outro valor, mas "true" (tais como True, false, False, abc), então ele será considerado como falso e não serão feitos ajustes de dimensionamento adicionais.
• sun.java2d.uiScale ─ Os valores podem ser passados de três maneiras:
  • Como um índice (0,5, 2,3, 1,5)
  • Como porcentagens (100%, 150%)
  • Como valores de dpi (96 dpi, 120 dpi). O valor será considerado se o dimensionamento estiver habilitado. Ele modifica o dimensionamento em ambos os eixos.
• sun.java2d.win.uiScaleX, sun.java2d.win.uiScaleY Os valores podem ser passados quando ao parâmetro sun.java2d.uiScale. Ambos são necessário para serem considerados pelo aplicativo Java. Eles são mais específicos do que a configuração geral do dimensionamento. Como tal, se todos os três parâmetros estiverem definidos, somente esses serão considerados.