Extensão do Chrome no Mac

Essa extensão ajuda você a criar automações de navegador no Google Chrome no Mac.

Métodos de instalação

A extensão UiPath para Chrome pode ser instalada de várias maneiras, dependendo de quanto a interação do usuário é permitida.

As extensões podem ser instaladas para um usuário específico ou por máquina (para todos os usuários). A única diferença entre esses dois tipos de instalação é a localização dos arquivos de configuração.

Tipo de instalação	Locais dos arquivos de configuração
Por usuário	~{userId}/Library/Application Support/Google/Chrome/External Extensions/ ~{userId}/Library/Application Support/Google/Chrome/NativeMessagingHosts/ Substitua {userId} pelo nome de usuário do usuário.
Por máquina	/Library/Application Support/Google/Chrome/External Extensions/ /Library/Google/Chrome/NativeMessagingHosts/

Instalar a partir do UiPath Assistant

A instalação usando o UiPath Assistant requer apenas alguns cliques, sem 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 .

1. Acesse o UiPath Assistant.

2. Selecione o ícone da conta.

3. Selecione Preferências.

4. Vá para UiPath Extensions.

5. Selecione Instalar para o Google Chrome.

   

6. Selecione Habilitar extensão na janela pop-up de confirmação do Google Chrome.

   

Resultado: a extensão é instalada e habilitada.

Instalar a partir do Terminal (por meio do 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, juntamente com os arquivos adicionais necessários para executar a extensão.

Pré-requisitos:

• Sempre execute o comando usando o arquivo UiPath.ExtensionControl.Portable.dll do diretório /Applications , pois o macOS é sensível quando se trata de executar binários de outros locais.
• Feche todas as janelas do Chrome antes de executar o comando.

Você pode usar um dos seguintes métodos de instalação:

• Usuário atual
• Todos os usuários
• Política de grupo on-line
• Política de grupo off-line

Usuário atual

Esse método instala a extensão apenas para o usuário atual. Ele cria ou atualiza os arquivos de configuração JSON usados pelo Chrome para detectar extensões. Esses arquivos definem o ID da extensão, o URL de atualização e o caminho para o host de mensagens nativo.

Observação:

• Adicione a --ext-id={extensionId} para direcionar uma versão de extensão específica. Substitua {extensionId} pelo ID da extensão desejada. Para obter uma lista de IDs disponíveis, consulte Studio - Lista de extensões para Chrome.
• A parte --ext-id={extensionId} do comando é opcional. Se omitido, a versão mais recente da extensão publicada na Web Store é instalada.

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 chrome
   

2. Selecione Habilitar extensão na janela pop-up de confirmação do Google Chrome.

   

Resultado: a extensão é instalada e habilitada.

Todos os usuários

Esse método instala a extensão para todos os usuários na máquina. Funciona de forma semelhante ao método Usuário atual criando ou atualizando os arquivos de configuração JSON que o Chrome usa para detectar extensões. A diferença está no local do arquivo: esse método grava os arquivos de configuração em um local de todo o sistema, enquanto o método Usuário atual os grava em um local específico do usuário.

Observação:

• sudo é necessário para executar esse comando, pois atualiza os arquivos de configuração do sistema.
• Adicione a --ext-id={extensionId} para direcionar uma versão de extensão específica. Substitua {extensionId} pelo ID da extensão desejada. Para obter uma lista de IDs disponíveis, consulte Studio - Lista de extensões para Chrome.
• A parte --ext-id={extensionId} do comando é opcional. Se omitido, a versão mais recente da extensão publicada na Web Store é instalada.

Etapas de instalação

1. Abra um Terminal e execute o seguinte comando:

   sudo dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll install chrome --scope=machine
   

2. Selecione Habilitar extensão na janela pop-up de confirmação do Google Chrome.

   

Resultado: a extensão é instalada e habilitada.

Política de grupo on-line

Esse método não requer a etapa manual para habilitar a extensão após o Chrome ser iniciado pela primeira vez. Isso ocorre porque ele depende de perfis de Configuração implantados por ferramentas MDM (Mobile Device Management).

O perfil Configuração define a política ExtensionInstallForcelist . Essa política garante que a extensão esteja habilitada e que não pode ser desabilitada manualmente.

Esse procedimento é semelhante ao método de instalação da Política de Grupo Online do Windows descrito aqui: Studio - Extensão para Chrome.

Para instalar um perfil de configuração (um arquivo .mobileconfig ), um aplicativo MDM deve estar presente na máquina, e a máquina deve estar inscrita para ser gerenciada.

Exemplos de MDMs incluem:

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

Se o dispositivo estiver inscrito em uma solução MDM, certifique-se de que a configuração não seja substituída pelas atualizações de configuração enviadas por meio do MDM. Para evitar isso, implante o perfil de Configuração diretamente via MDM. O perfil deve conter configurações semelhantes ao exemplo abaixo:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>PayloadContent</key>
	<array>
		<dict>
			<!-- This policy ensures that the {extensionId} is enabled -->
			<key>ExtensionInstallForcelist</key>
			<array>
				<string>{extensionId};https://clients2.google.com/service/update2/crx</string>
			</array>

			<!-- The policies below are not mandatory, but they are useful in some systems, 
         depending on the already present configuration -->
         <!-- This policy enables the Developer mode in chrome://extensions -->
			<key>DeveloperToolsAvailability</key>
			<integer>1</integer>
			
			<key>BlockExternalExtensions</key>
			<false/>
			
			<key>ExtensionAllowedTypes</key>
			<array>
				<string>extension</string>
			</array>
			
			<key>NativeMessagingUserLevelHosts</key>
			<true/>
			
			<key>NativeMessagingAllowlist</key>
			<array>
				<string>com.uipath.portable_host</string>
			</array>
			
			<key>PayloadDisplayName</key>
			<string>Google Chrome</string>
			<key>PayloadIdentifier</key>
			<string>com.google.Chrome.2C2280F4-2955-49E9-8161-A599B9BB6685</string>
			<key>PayloadType</key>
			<string>com.google.Chrome</string>
			<key>PayloadUUID</key>
			<string>2C2280F4-2955-49E9-8161-A599B9BB6685</string>
			<key>PayloadVersion</key>
			<integer>1</integer>
		</dict>
	</array>
	<key>PayloadDisplayName</key>
	<string>UiPath Studio Web Automation Chrome Extension Installation</string>
	<key>PayloadIdentifier</key>
	<string>com.uipath.chrome.extension.A64BC628-4ECF-4A71-91D5-20D7C7475C38</string>
	<key>PayloadOrganization</key>
	<string>com.uipath</string>
	<key>PayloadScope</key>
	<string>System</string>
	<key>PayloadType</key>
	<string>Configuration</string>
	<key>PayloadUUID</key>
	<string>A64BC628-4ECF-4A71-91D5-20D7C7475C38</string>
	<key>PayloadVersion</key>
	<integer>1</integer>
	<key>TargetDeviceType</key>
	<integer>5</integer>
</dict>
</plist>

Se o dispositivo não estiver inscrito em uma solução MDM, a UiPath.ExtensionControl.Portable.dll grava a configuração necessária localmente, sem ser substituída por políticas aplicadas ao MDM. Isso permite que o Chrome aplique a política e garante que a extensão esteja habilitada sem requerer interação do usuário.

Observação:

• sudo é necessário para executar esse comando, pois atualiza os arquivos de configuração do sistema.
• Usar a opção define bypolicy o escopo para a máquina.
• O comando pode ser emitido com --scope=user em vez de --scope=machine, com o efeito de que apenas o usuário atual tenha a extensão instalada e habilitada automaticamente. Qualquer outro usuário não terá a extensão instalada.
• Adicione a --ext-id={extensionId} para direcionar uma versão de extensão específica. Substitua {extensionId} pelo ID da extensão desejada. Para obter uma lista de IDs disponíveis, consulte Studio - Lista de extensões para Chrome.
• A parte --ext-id={extensionId} do comando é opcional. Se omitido, a versão mais recente da extensão publicada na Web Store é instalada.

Etapas de instalação

A. Máquina inscrita no MDM:

1. Abra um Terminal e execute o seguinte comando. O bypolicy pode ser removido se a configuração enviada por meio do MDM estiver definida para substituir os valores existentes.

   sudo dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll install chrome bypolicy --scope=machine
   

2. Crie um novo arquivo .mobileconfig para configurar as políticas necessárias. O arquivo .mobileconfig deve ter aproximadamente o conteúdo descrito acima.

3. Instale o perfil de configuração usando o provedor de MDM.

4. Inicie o Chrome.

5. Projete e execute automações.

Resultado: a extensão é instalada e habilitada.

B. Máquina não inscrita no MDM:

1. Abra um Terminal e execute o seguinte comando:

   sudo dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll install chrome bypolicy --scope=machine
   

2. Projete e execute automações.

Resultado: a extensão é instalada e habilitada.

Política de grupo off-line

UiPath.ExtensionControl.Portable.dll não pode ser usado para realizar totalmente esse tipo de instalação, pois requer intervenção (na máquina local ou de uma máquina de administrador).

UiPath.ExtensionControl.Portable.dll suporte para atualizar os arquivos de configuração necessários pela extensão para sua comunicação com o host nativo. Portanto, ela pode ser usada para instalar a extensão por usuário ou por máquina, conforme mostrado anteriormente, mas são necessárias etapas adicionais para garantir que a extensão esteja instalada e habilitada.

O perfil Configuração define a política ExtensionInstallForcelist . Essa política garante que a extensão esteja habilitada e que não pode ser desabilitada manualmente.

Esse método:

• Permite instalar qualquer extensão, seja publicada na WebStore ou não publicada.
• É útil em ambientes com acesso restrito à Internet (onde https://clients2.google.com/service/update2/crx é possível acessar).

O perfil de Configuração deve ter aproximadamente o seguinte conteúdo:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>PayloadContent</key>
	<array>
		<dict>
			<!-- This policy ensures that the {extensionId} is enabled -->
			<key>ExtensionInstallForcelist</key>
			<array>
				<string>{extensionId}</string>
			</array>

			<!-- The policies below are not mandatory, but they are useful in some systems, 
         depending on the already present configuration -->
			<!-- This policy enables the Developer mode in chrome://extensions -->
			<key>DeveloperToolsAvailability</key>
			<integer>1</integer>
			
			<key>BlockExternalExtensions</key>
			<false/>
			
			<key>ExtensionAllowedTypes</key>
			<array>
				<string>extension</string>
			</array>
			
			<key>NativeMessagingUserLevelHosts</key>
			<true/>
			
			<key>NativeMessagingAllowlist</key>
			<array>
				<string>com.uipath.portable_host</string>
			</array>
			
			<key>PayloadDisplayName</key>
			<string>Google Chrome</string>
			<key>PayloadIdentifier</key>
			<string>com.google.Chrome.2C2280F4-2955-49E9-8161-A599B9BB6685</string>
			<key>PayloadType</key>
			<string>com.google.Chrome</string>
			<key>PayloadUUID</key>
			<string>2C2280F4-2955-49E9-8161-A599B9BB6685</string>
			<key>PayloadVersion</key>
			<integer>1</integer>
		</dict>
	</array>
	<key>PayloadDisplayName</key>
	<string>UiPath Studio Web Automation Chrome Extension Installation</string>
	<key>PayloadIdentifier</key>
	<string>com.uipath.chrome.extension.A64BC628-4ECF-4A71-91D5-20D7C7475C38</string>
	<key>PayloadOrganization</key>
	<string>com.uipath</string>
	<key>PayloadScope</key>
	<string>System</string>
	<key>PayloadType</key>
	<string>Configuration</string>
	<key>PayloadUUID</key>
	<string>A64BC628-4ECF-4A71-91D5-20D7C7475C38</string>
	<key>PayloadVersion</key>
	<integer>1</integer>
	<key>TargetDeviceType</key>
	<integer>5</integer>
</dict>
</plist>

A string ExtensionInstallForcelist tem os seguintes formatos:

• {extensionId}
• {extensionId};{urlWithThePathToTheUpdateManifestXmlFile}

O valor {urlWithThePathToTheUpdateManifestXmlFile} deve ser substituído por um URL (https:// ou file://) para o arquivo XML de manifesto de atualização. Esse arquivo tem o seguinte conteúdo:

<?xml version='1.0' encoding='UTF-8'?>
<gupdate xmlns='http://www.google.com/update2/response' protocol='2.0'>
	<app appid='{extensionId}'>
	<updatecheck
		codebase='{crxUrl}'
		version='{extensionVersion}' />
	</app>
</gupdate>

Observação:

• Substitua {extensionId} pelo ID da extensão.
• O {crxUrl} deve ser substituído pelo URL do CRX (https:// - se o CRX estiver hospedado em um servidor ou file:// - se o arquivo for colocado na máquina local).
• O {extensionVersion} deve ser substituído pela versão da extensão (algo como 24.10.3).

Etapas de instalação

Observação:

As etapas 1 e 2 são realizadas na máquina do administrador.

1. Crie o perfil de Configuração conforme descrito acima.

2. Envie o perfil usando um provedor MDM.

3. Instale o host de mensagens nativo abrindo um Terminal e executando o seguinte comando:

   dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll install chrome native-messaging-host-only --scope=machine
   

4. Inicie o Chrome.

5. Projete e execute automações.

Resultado: a extensão é instalada e habilitada.

Esse método depende de perfis de Configuração implantados por ferramentas MDM (Mobile Device Management). O perfil Configuração aplica a política ExtensionInstallForcelist , que garante que a extensão seja habilitada automaticamente e não possa ser desabilitada pelos usuários.

Esse procedimento é semelhante ao método de instalação da Política de grupo Offline do Windows descrito aqui: Studio - Extensão para Chrome.

Desinstalar

Desinstalar a partir do UiPath Assistant

1. Acesse o UiPath Assistant.

2. Vá para UiPath Extensions.

3. Selecione Desinstalar para o Google Chrome.

   

Resultado: a extensão é desinstalada.

Desinstalar a partir do Terminal

Você pode desinstalar a extensão UiPath para Chrome, independentemente do método de instalação, executando o seguinte comando:

dotnet UiPath.ExtensionControl.Portable.dll cleanup chrome

Resultado: a extensão é desinstalada.

Verificar o status

Para verificar o status da extensão do Chrome, execute o comando Terminal correspondente com base em seu método de instalação:

• Usuário atual

  dotnet UiPath.ExtensionControl.Portable.dll status chrome
  

• Todos os usuários

  dotnet UiPath.ExtensionControl.Portable.dll status chrome --scope=machine
  

• Política de grupo on-line

  dotnet UiPath.ExtensionControl.Portable.dll status chrome bypolicy --scope=machine
  

• Política de grupo off-line

  dotnet UiPath.ExtensionControl.Portable.dll status chrome native-messaging-host-only --scope=machine