Extensão para Safari

Instale e configure a extensão UiPath para Safari para habilitar a automação de interface gráfica no Safari no macOS com o Studio Web e o macOS Robot local.

A partir do UiPath.UIAutomation.Activities versão 24.10.0, A compatibilidade com a Automação de Interface Gráfica do Safari está disponível em pré-visualização. A extensão para Safari permite que você:

• Projete automações de interface gráfica no Studio Web dentro do navegador Safari no macOS.
• Execute automações de navegador no Safari usando um macOS Robot local, instalado anteriormente e conectado ao Orchestrator.
• Inicie automações de navegadores Attended no Safari por meio do macOS Assistant.

Para criar e executar essas automações, você deve instalar a extensão UiPath Browser Automation para Safari.

Você pode começar do Studio Web adicionando quaisquer atividades UI Automation. Ao acessar o Studio Web a partir do Safari, você é solicitado a instalar a extensão UiPath para Safari na App Store. Siga o guia de configuração para configurar a extensão e, em seguida, comece a projetar seus fluxos de trabalho para automação de navegadores no Safari.

Observação:

Para criar automações de navegadores no Safari em máquinas que executam o macOS, a versão mínima compatível é o macOS 12.

Instalar

A instalação da extensão Safari também instala o componente Host Nativo. Isso significa que você pode executar automações do UiPath Assistant sem a necessidade de instalação adicional.

Instalar a partir da App Store

Etapas de instalação

1. Acesse a extensão UiPath para Safari diretamente na App Store

2. Selecione Obter para instalar a extensão e, em seguida, Abrir.

   

3. Depois de selecionar Abrir, aparece uma janela de configuração.

   

4. Selecione Abrir configurações do Safari para acessar a janela Extensões, onde você pode definir as permissões corretas para a extensão recém-instalada.

   1. Habilite a extensão UiPath Browser Automation no painel do lado esquerdo.

   2. Selecione Sempre permitir em cada site e confirme essa escolha.

   3. Se você pretende usar a navegação privada, habilite a configuração Permitir navegação privada .

Resultado: uma mensagem informa que a extensão agora está disponível.

Instalar do UiPath Studio Web

Etapas de instalação

1. No UiPath Automation Cloud™, acesse o Studio Web.

2. Adicione uma atividade Use Browser ao seu projeto. Você é solicitado a instalar a extensão UiPath para Safari.

   

3. Selecione o botão Instalar extensão.

4. A App Store abre com a extensão UiPath Browser Automation.

5. Continue o processo de instalação a partir da etapa 2 da seção Instalar a partir da App Store .

Resultado: uma mensagem informa que a extensão agora está disponível.

Instalar a partir do UiPath Assistant

A instalação usando o UiPath Assistant não requer nenhuma configuração adicional, desde que o UiPath Assistant já esteja instalado. Esse método instala a versão da extensão mais recente publicada na loja virtual apenas para o usuário atual .

Etapas de instalação

1. Acesse o UiPath Assistant.

2. Selecione o ícone da conta.

3. Selecione Preferências.

4. Vá para UiPath Extensions.

5. Selecione Instalar para Safari.

   

Observação:

Alternativamente, selecione Visualizar na App Store para obter a extensão da App Store e continue a partir da etapa 2 da seção Instalar da App Store .

Resultado: a extensão é instalada e habilitada no Safari.

Instalar a partir do Terminal

A instalação a partir do Terminal ocorre via UiPath.ExtensionControl.Portable.dll.

A UiPath fornece uma ferramenta para gerenciar a instalação da extensão: UiPath.ExtensionControl.Portable.dll. Essa ferramenta é distribuída com o UiPath Assistant, que também inclui o aplicativo de extensão mais recente empacotado como um arquivo.

Este método atualiza a configuração do Safari para que a extensão seja reconhecida como instalada. A extensão é instalada apenas para o usuário atual.

AVISO:

Esse método não se destina a ambientes de produção, pois depende de um mecanismo que a Apple pode alterar em atualizações futuras. Use-o apenas se não houver nenhuma outra alternativa disponível.

Pré-requisitos

• Todas as instâncias do Safari são fechadas.

Etapas de instalação

1. Abra um Terminal e execute o seguinte comando:

    dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll install safari
   

2. Inicie o Safari para projetar e executar automações.

Resultado: a extensão é instalada e habilitada no Safari.

Instalar usando um MDM

Para instalar por meio de um aplicativo MDM (gerenciamento de dispositivos móveis), você deve registrar a máquina para gerenciamento.Mais detalhes sobre como o gerenciamento de dispositivos funciona em máquinas da Apple podem ser encontrados nesta página: Gerenciamento de dispositivos | Documentação para desenvolvedores da Apple.

Exemplos de MDMs incluem:

• Jamf
• Microsoft Intune
• Kandji
• MicroMDM (código aberto)

Esse método depende do novo modelo de gerenciamento declarativo para enviar alterações de configuração para a(s) máquina(s) gerenciada(s). A configuração para extensões do Safari está detalhada aqui: SafariExtensionSettings | Documentação para desenvolvedor da Apple.

Desinstalar

Desinstalar a partir do UiPath Assistant

Etapas de desinstalação

1. Acesse o UiPath Assistant.

2. Selecione o ícone da conta.

3. Selecione Preferências.

4. Vá para UiPath Extensions.

5. Selecione Desinstalar para Safari.

   

Resultado: a extensão é desinstalada e removida da pasta Aplicativos .

Desinstalar a partir do Terminal

A desinstalação do Terminal é realizada via UiPath.ExtensionControl.Portable.dll.

A UiPath fornece uma ferramenta para gerenciar a instalação da extensão: UiPath.ExtensionControl.Portable.dll. Essa ferramenta é distribuída com o UiPath Assistant.

Esse método atualiza a configuração do Safari para que a extensão seja desinstalada. A extensão é desinstalada apenas para o usuário atual.

AVISO:

Esse método não se destina a ambientes de produção, pois depende de um mecanismo que a Apple pode alterar em atualizações futuras. Use-o apenas se não houver nenhuma outra alternativa disponível.

Pré-requisitos

• Todas as instâncias do Safari são fechadas.

Etapas de desinstalação

1. Abra um Terminal e execute o seguinte comando:

    dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll uninstall safari
   

Resultado: a extensão é desinstalada e removida da pasta Aplicativos .

Desinstalar das configurações do Safari

Etapas de desinstalação

1. Acesse configurações do Safari.

2. Navegue até a guia Extensões.

3. Selecione o botão Desinstalar.

   

4. Selecione o botão Mostrar no Finder. Isso abre o Finder com o aplicativo selecionado.

   

5. Abra o menu de contexto do aplicativo UiPath para Safari e selecione Mover para a lixeira.

   

   Se uma mensagem pop-up indicar que o aplicativo não pode ser excluído porque está em uso:

   

   1. Abra o Monitor de atividade e pesquise UiPath Native Host para Safari.

      

   2. Selecione o aplicativo, escolha Parar e, em seguida, selecione Sair.

   3. Retorne ao Finder e selecione Mover para a lixeira novamente.

      

6. Insira suas credenciais do Mac e, em seguida, selecione OK para autorizar essa exclusão.

   

Resultado: a extensão é desinstalada. Ela é removida da barra de extensão do Safari e da guia Extensões de configurações do Safari.

Configuração de acessibilidade

Para usar o modo de entrada Eventos de hardware, você deve conceder especificamente acesso ao UiPath Assistant ao seu Mac usando as configurações Privacidade e segurança.

Para fazer isso, siga as etapas abaixo:

1. Selecione o menu Apple.

2. Selecione Configurações do sistema.

3. Selecione Privacidade e segurança na barra lateral à esquerda.

4. Acesse Acessibilidade selecionando a seta no lado direito.

5. Habilitar o UiPath Assistant na lista. Se você não vir o aplicativo, selecione + na parte inferior da lista, pesquise UiPath Assistant, selecione o aplicativo e escolha Abrir. As credenciais do Mac são solicitadas para essa alteração.

   

Resultado: o UiPath Assistant agora está autorizado a usar o modo de entrada de eventos de hardware em automações do Safari.

Configuração completa do acesso ao disco

Para instalar a extensão Safari usando o UiPath Assistant, você deve conceder especificamente ao UiPath Assistant acesso aos arquivos do Mac usando as configurações Privacidade e segurança .

Para fazer isso, siga as etapas abaixo:

1. Selecione o menu Apple.
2. Selecione Configurações do sistema.
3. Selecione Privacidade e segurança na barra lateral à esquerda.
4. Acesse Acesso total ao disco selecionando a seta no lado direito.
5. Habilite o Acesso total ao disco na lista:
   • Se o UiPath Assistant estiver listado, habilite-o.
   • Se o UiPath Assistant não estiver listado, selecione + na parte inferior da lista, pesquise UiPath Assistant, selecione o aplicativo e escolha Abrir.

Observação:

As credenciais do Mac são solicitadas para essa alteração.

Resultado: o UiPath Assistant agora está autorizado a editar os arquivos no seu Mac.

Restrições conhecidas

Considere as seguintes limitações ao criar automações de navegadores para Safari:

• A extensão não pode acessar URLs de arquivos. Esta é uma limitação do Safari, conforme explicado neste tópico do fórum do Apple Developer (Permitir acesso às URLs de arquivos para extensões da Web).
• A extensão não é compatível com vários perfis.