Extensão do Chrome no Mac

Instale a extensão UiPath para Chrome no Mac para automação de navegador, com opções para instalação no nível do usuário ou em toda a máquina.

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

Instalar

Você pode instalar a extensão do Chrome usando um dos seguintes métodos:

• Usuário atual
• Todos os usuários
• Política de grupo on-line
• Política de grupo off-line
• Usuário atual (apenas o host de mensagens nativas)
• Todos os usuários (apenas o host de mensagens nativas)

As instalações podem ser realizadas usando o UiPath Assistant ou a partir do Terminal (invocando UiPath.ExtensionControl.Portable.dll).

O UiPath Assistant e o UiPath.ExtensionControl.Portable.dll instalam a versão mais recente da extensão, da seguinte forma:

Tipo de instalação	Versão da extensão
Usuário atual	Extensão UiPath mais recente para Studio Web publicada na Chrome WebStore.
Todos os usuários	Extensão UiPath mais recente para Studio Web publicada na Chrome WebStore.
Política de grupo on-line	Extensão UiPath mais recente para Studio Web publicada na Chrome WebStore.
Política de grupo off-line	A extensão auto-hospedada mais recente agrupada com o UiPath Assistant.
Usuário atual (apenas o host de mensagens nativas)	Extensão UiPath mais recente para Studio Web publicada na Chrome WebStore.
Todos os usuários (apenas o host de mensagens nativas)	Extensão UiPath mais recente para Studio Web publicada na Chrome WebStore.

Você também pode usar UiPath.ExtensionControl.Portable.dll para instalar uma versão específica da extensão do navegador. Execute-o com o comando help para obter detalhes:

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

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 a ID da extensão, a URL de atualização e o caminho para o host de mensagens nativas.

A. Instalar etapas usando o UiPath Assistant

1. Acesse o UiPath Assistant.

2. Selecione o ícone da conta.

3. Selecione Preferências.

4. Vá para UiPath Extensions.

5. Use o menu suspenso para o Google Chrome para selecionar o tipo de instalação de Usuário atual .

   

6. Selecione Instalar.

7. Selecione Habilitar extensão no pop-up de confirmação do Google Chrome.

   

Resultado: a extensão está instalada e habilitada.

B. Instalar etapas usando UiPath.ExtensionControl.Portable.dll (a partir do Terminal)

Pré-requisitos:

• Sempre execute o comando usando o arquivo UiPath.ExtensionControl.Portable.dll do diretório /Applications, pois o macOS exige a execução de binários a partir de seus locais originais.
• Feche todas as janelas do Chrome antes de executar o comando.

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 no pop-up de confirmação do Google Chrome.

   

Resultado: a extensão está instalada e habilitada.

Observação:

Adicione a opção --ext-id={extensionId} para direcionar uma versão de extensão específica; se omitido, a versão mais recente publicada na loja virtual será instalada. Para IDs disponíveis, consulte Studio - Lista de extensões para Chrome.

Todos os usuários

Esse método instala a extensão para todos os usuários da máquina. Ele funciona de forma semelhante ao método Usuário atual ao criar ou atualizar 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 em todo o sistema, enquanto o método de Usuário atual os grava em um local específico do usuário.

A. Instalar etapas usando o UiPath Assistant

1. Acesse o UiPath Assistant.

2. Selecione o ícone da conta.

3. Selecione Preferências.

4. Vá para UiPath Extensions.

5. Use o menu suspenso para o Google Chrome para selecionar o tipo de instalação Todos os usuários .

   

6. Selecione Instalar.

7. Insira a senha de administrador no pop-up de confirmação do UiPath Assistant .

   

8. Selecione Habilitar extensão no pop-up de confirmação do Google Chrome.

   

Resultado: a extensão está instalada e habilitada.

B. Instalar etapas usando UiPath.ExtensionControl.Portable.dll (a partir do Terminal)

Pré-requisitos:

• Sempre execute o comando usando o arquivo UiPath.ExtensionControl.Portable.dll do diretório /Applications, pois o macOS exige a execução de binários a partir de seus locais originais.
• Feche todas as janelas do Chrome antes de executar o comando.

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 no pop-up de confirmação do Google Chrome.

   

Resultado: a extensão está instalada e habilitada.

Observação:

• sudo é necessário para executar esse comando, pois atualiza os arquivos de configuração do sistema.
• Adicione a opção --ext-id={extensionId} para direcionar uma versão de extensão específica; se omitido, a versão mais recente publicada na loja virtual será instalada. Para IDs disponíveis, consulte Studio - Lista de extensões para Chrome.

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 depende de perfis de configuração implantados pelas ferramentas de MDM (gerenciamento de dispositivos móveis).

O Perfil de configuração define a política ExtensionInstallForcelist. Essa política garante que a extensão esteja habilitada e que ela não possa ser desabilitada manualmente.

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

Requisitos do MDM

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
• Kandji
• MicroMDM (código aberto)

Se o dispositivo estiver inscrito em uma solução de 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, faça a implantação do perfil de configuração diretamente por meio do MDM. O perfil precisa ter 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>
			<!-- These policies specifically enable the Developer mode for {extensionId} -->
			<key>DeveloperToolsAvailabilityAllowlist</key>
			<array>
				<string>chrome-extension://{extensionId}</string>
			</array>
			<key>DeveloperToolsAvailabilityBlocklist</key>
			<array>
				<string>https://uipath-devtools-blocklist-placeholder.invalid</string>
			</array>
			<!-- Alternatively, this policy globally enables the Developer mode in chrome://extensions.
			Can be used in place of DeveloperToolsAvailabilityAllowlist / DeveloperToolsAvailabilityBlocklist -->
			<key>DeveloperToolsAvailability</key>
			<integer>1</integer>

			<!-- The policies below are not mandatory, but they are useful in some systems, 
			depending on the already present configuration -->
			<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, os arquivos de configuração necessários serão escritos localmente, sem serem substituídos por políticas aplicadas pelo 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.

A. Instalar etapas usando o UiPath Assistant

1. Acesse o UiPath Assistant.

2. Selecione o ícone da conta.

3. Selecione Preferências.

4. Vá para UiPath Extensions.

5. Use o menu suspenso para o Google Chrome para selecionar o tipo de instalação Por política .

   

6. Selecione Instalar.

7. Insira a senha de administrador no pop-up de confirmação do UiPath Assistant .

   

Resultado: a extensão está instalada e habilitada.

B. Instalar etapas usando UiPath.ExtensionControl.Portable.dll (a partir do Terminal)

Pré-requisitos:

• Sempre execute o comando usando o arquivo UiPath.ExtensionControl.Portable.dll do diretório /Applications, pois o macOS exige a execução de binários a partir de seus locais originais.
• Feche todas as janelas do Chrome antes de executar o comando.
• Para instalar apenas para o usuário atual em vez de todos os usuários, substitua --scope=machine por --scope=user no comando abaixo; outros usuários não terão a extensão instalada.

AVISO:

Se a máquina estiver inscrita no MDM, você precisa garantir que as políticas não sejam substituídas. Consulte os Requisitos do MDM para obter mais detalhes.

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
   

Resultado: a extensão está instalada e habilitada.

Observação:

• sudo é necessário para executar esse comando, pois atualiza os arquivos de configuração do sistema, e a opção bypolicy define automaticamente o escopo como máquina.
• Adicione a opção --ext-id={extensionId} para direcionar uma versão de extensão específica; se omitido, a versão mais recente publicada na loja virtual será instalada. Consulte Studio - Lista de extensões para Chrome para IDs disponíveis.

Política de grupo off-line

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

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. Também configura as políticas DeveloperToolsAvailabilityAllowlist / DeveloperToolsAvailabilityBlocklist para permitir especificamente que as Ferramentas do desenvolvedor acessem a extensão da UiPath.

Este método:

• Permite que você instale qualquer extensão, seja publicada no WebStore ou não publicada.
• É útil em ambientes com acesso restrito à internet (onde https://clients2.google.com/service/update2/crx não pode ser acessado).

AVISO:

• Esse método só funciona em máquinas que são inscritas no MDM. Consulte os Requisitos do MDM para obter mais detalhes.

A. Instalar etapas usando o UiPath Assistant

1. Acesse o UiPath Assistant.

2. Selecione o ícone da conta.

3. Selecione Preferências.

4. Vá para UiPath Extensions.

5. Use o menu suspenso para o Google Chrome para selecionar o tipo de instalação Por política (offline) .

   

6. Selecione Instalar.

7. Insira a senha de administrador no pop-up de confirmação do UiPath Assistant .

   

Resultado: a extensão está instalada e habilitada.

B. Instalar etapas usando UiPath.ExtensionControl.Portable.dll (a partir do Terminal)

Pré-requisitos:

• Sempre execute o comando usando o arquivo UiPath.ExtensionControl.Portable.dll do diretório /Applications, pois o macOS exige a execução de binários a partir de seus locais originais.
• Feche todas as janelas do Chrome antes de executar o comando.
• Para instalar apenas para o usuário atual em vez de todos os usuários, adicione --scope=user ao comando abaixo; por padrão, a bypolicy opção define o escopo como máquina.

1. Abra um Terminal e execute o seguinte comando:

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

2. Inicie o Chrome.

3. Projetar e executar automações.

Resultado: a extensão está instalada e habilitada.

Observação:

sudo é necessário para executar esse comando, pois atualiza os arquivos de configuração do sistema. O uso da opção bypolicy define automaticamente o escopo para a máquina.

Usuário atual (apenas o host de mensagens nativas)

Esse método instala apenas o componente Host de mensagens nativas da extensão para o usuário atual. Ele cria ou atualiza os arquivos de configuração JSON usados pelo Chrome para permitir a comunicação com um host nativo.

AVISO:

A extensão precisa ser instalada manualmente a partir da WebStore ou por meio de uma configuração do MDM. Consulte os Requisitos do MDM para obter mais detalhes.

A. Instalar etapas usando o UiPath Assistant

1. Acesse o UiPath Assistant.

2. Selecione o ícone da conta.

3. Selecione Preferências.

4. Vá para UiPath Extensions.

5. Use o menu suspenso para o Google Chrome para selecionar o tipo de instalação de Usuário atual (Apenas para o host de mensagens nativas) .

   

6. Selecione Instalar.

Resultado: o componente de host de mensagens nativo da extensão é instalado.

B. Instalar etapas usando UiPath.ExtensionControl.Portable.dll (a partir do Terminal)

Pré-requisitos:

• Sempre execute o comando usando o arquivo UiPath.ExtensionControl.Portable.dll do diretório /Applications, pois o macOS exige a execução de binários a partir de seus locais originais.
• Feche todas as janelas do Chrome antes de executar o comando.

1. Abra um Terminal e execute o seguinte comando:

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

Resultado: o componente de host de mensagens nativo da extensão é instalado.

Observação:

Adicione a opção --ext-id={extensionId} para direcionar uma versão de extensão específica; se omitido, a versão mais recente publicada na loja virtual será instalada. Para IDs disponíveis, consulte Studio - Lista de extensões para Chrome.

Todos os usuários (apenas o host de mensagens nativas)

Esse método instala apenas o componente Host de mensagens nativas da extensão para todos os usuários. Ele cria ou atualiza os arquivos de configuração JSON usados pelo Chrome para permitir a comunicação com um host nativo.

AVISO:

A extensão precisa ser instalada manualmente a partir da WebStore ou por meio de uma configuração do MDM. Consulte os Requisitos do MDM para obter mais detalhes.

A. Instalar etapas usando o UiPath Assistant

1. Acesse o UiPath Assistant.

2. Selecione o ícone da conta.

3. Selecione Preferências.

4. Vá para UiPath Extensions.

5. Use o menu suspenso para o Google Chrome para selecionar o tipo de instalação Todos os Usuários (Apenas para o Host de Mensagens Nativas) .

   

6. Selecione Instalar.

7. Insira a senha de administrador no pop-up de confirmação do UiPath Assistant .

   

Resultado: o componente de host de mensagens nativo da extensão é instalado.

B. Instalar etapas usando UiPath.ExtensionControl.Portable.dll (a partir do Terminal)

Pré-requisitos:

• Sempre execute o comando usando o arquivo UiPath.ExtensionControl.Portable.dll do diretório /Applications, pois o macOS exige a execução de binários a partir de seus locais originais.
• Feche todas as janelas do Chrome antes de executar o comando.

1. Abra um Terminal e execute o seguinte comando:

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

Resultado: o componente de host de mensagens nativo da extensão é instalado.

Observação:

Adicione a opção --ext-id={extensionId} para direcionar uma versão de extensão específica; se omitido, a versão mais recente publicada na loja virtual será instalada. Para IDs disponíveis, consulte Studio - Lista de extensões para Chrome.

Desinstalar

Desinstalar a partir do UiPath Assistant

1. Acesse o UiPath Assistant.

2. Vá para UiPath Extensions.

3. Selecione Desinstalar para Google Chrome.

   

Resultado: a extensão é desinstalada.

Desinstalar a partir do Terminal

Você pode desinstalar a extensão da 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 do 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 bypolicy --offline --scope=machine
  

• Usuário atual (apenas o host de mensagens nativas)

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

• Todos os usuários (apenas o host de mensagens nativas)

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