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

You can install the Chrome extension using one of the following methods:

• Usuário atual
• Todos os usuários
• Política de grupo on-line
• Política de grupo off-line
• Current User (Native Messaging Host only)
• All Users (Native Messaging Host only)

Installs can be performed using UiPath Assistant or from Terminal (invoking UiPath.ExtensionControl.Portable.dll).

UiPath Assistant and UiPath.ExtensionControl.Portable.dll install the latest extension version, as follows:

Tipo de instalação	Extension version
Usuário atual	Latest UiPath extension for Studio Web published on the Chrome WebStore.
Todos os usuários	Latest UiPath extension for Studio Web published on the Chrome WebStore.
Política de grupo on-line	Latest UiPath extension for Studio Web published on the Chrome WebStore.
Política de grupo off-line	Latest self-hosted extension bundled with UiPath Assistant.
Current User (Native Messaging Host only)	Latest UiPath extension for Studio Web published on the Chrome WebStore.
All Users (Native Messaging Host only)	Latest UiPath extension for Studio Web published on the Chrome WebStore.

You can also use UiPath.ExtensionControl.Portable.dll to install a specific browser extension version. Run it with the help command for details:

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. Install Steps using UiPath Assistant

1. Acesse o UiPath Assistant.

2. Selecione o ícone da conta.

3. Selecione Preferências.

4. Vá para UiPath Extensions.

5. Use the dropdown for Google Chrome to select the Current User install type.

   

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. Install Steps using UiPath.ExtensionControl.Portable.dll (from the 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:

Add the --ext-id={extensionId} option to target a specific extension version; if omitted, the latest version published to the Web Store is installed. For available IDs, see Studio - List of extensions for Chrome.

Todos os usuários

This method installs the extension for all users on the machine. It works similarly to the Current User method by creating or updating the JSON configuration files that Chrome uses to detect extensions. The difference lies in the file location: this method writes the configuration files to a system-wide location, whereas the Current User method writes them to a user-specific location.

A. Install Steps using UiPath Assistant

1. Acesse o UiPath Assistant.

2. Selecione o ícone da conta.

3. Selecione Preferências.

4. Vá para UiPath Extensions.

5. Use the dropdown for Google Chrome to select the All Users install type.

   

6. Selecione Instalar.

7. Enter the admin password in the UiPath Assistant confirmation pop-up.

   

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

   

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

B. Install Steps using UiPath.ExtensionControl.Portable.dll (from the 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.
• Add the --ext-id={extensionId} option to target a specific extension version; if omitted, the latest version published to the Web Store is installed. For available IDs, see Studio - List of extensions for 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>

If the device is not enrolled in an MDM solution, the required configuration files are written locally, without them being overridden by MDM-applied policies. This allows Chrome to apply the policy and ensures that the extension is enabled without requiring user interaction.

A. Install Steps using UiPath Assistant

1. Acesse o UiPath Assistant.

2. Selecione o ícone da conta.

3. Selecione Preferências.

4. Vá para UiPath Extensions.

5. Use the dropdown for Google Chrome to select the By Policy install type.

   

6. Selecione Instalar.

7. Enter the admin password in the UiPath Assistant confirmation pop-up.

   

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

B. Install Steps using UiPath.ExtensionControl.Portable.dll (from the 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.
• To install for the current user only instead of all users, replace --scope=machine with --scope=user in the command below; other users won't get the extension installed.

AVISO:

If the machine is MDM-enrolled you need to make sure that the policies are not overwritten. See the MDM Requirements for more details.

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 is needed to run this command, as it updates system configuration files, and the bypolicy option automatically sets the scope to machine.
• Add the --ext-id={extensionId} option to target a specific extension version; if omitted, the latest version published to the Web Store is installed. See Studio - List of extensions for Chrome for available IDs.

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:

• This method only works on machines that are MDM enrolled. See the MDM Requirements for more details.

A. Install Steps using UiPath Assistant

1. Acesse o UiPath Assistant.

2. Selecione o ícone da conta.

3. Selecione Preferências.

4. Vá para UiPath Extensions.

5. Use the dropdown for Google Chrome to select the By Policy (Offline) install type.

   

6. Selecione Instalar.

7. Enter the admin password in the UiPath Assistant confirmation pop-up.

   

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

B. Install Steps using UiPath.ExtensionControl.Portable.dll (from the 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.
• To install for the current user only instead of all users, add --scope=user to the command below; by default, the bypolicy option sets the scope to machine.

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 is needed to run this command, as it updates system configuration files. Using the bypolicy option automatically sets the scope to machine.

Current User (Native Messaging Host only)

This method installs only the extension's Native Messaging Host component for the current user. It creates or updates the JSON configuration files used by Chrome to allow communication with a native host.

AVISO:

The extension needs to be installed manually from the WebStore or via a MDM configuration. See the MDM Requirements for more details.

A. Install Steps using UiPath Assistant

1. Acesse o UiPath Assistant.

2. Selecione o ícone da conta.

3. Selecione Preferências.

4. Vá para UiPath Extensions.

5. Use the dropdown for Google Chrome to select the Current User (Native Messaging Host only) install type.

   

6. Selecione Instalar.

Result: The extension's native messaging host component is installed.

B. Install Steps using UiPath.ExtensionControl.Portable.dll (from the 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
   

Result: The extension's native messaging host component is installed.

Observação:

Add the --ext-id={extensionId} option to target a specific extension version; if omitted, the latest version published to the Web Store is installed. For available IDs, see Studio - List of extensions for Chrome.

All Users (Native Messaging Host only)

This method installs only the extension's Native Messaging Host component for all users. It creates or updates the JSON configuration files used by Chrome to allow communication with a native host.

AVISO:

The extension needs to be installed manually from the WebStore or via a MDM configuration. See the MDM Requirements for more details.

A. Install Steps using UiPath Assistant

1. Acesse o UiPath Assistant.

2. Selecione o ícone da conta.

3. Selecione Preferências.

4. Vá para UiPath Extensions.

5. Use the dropdown for Google Chrome to select the All Users (Native Messaging Host only) install type.

   

6. Selecione Instalar.

7. Enter the admin password in the UiPath Assistant confirmation pop-up.

   

Result: The extension's native messaging host component is installed.

B. Install Steps using UiPath.ExtensionControl.Portable.dll (from the 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
   

Result: The extension's native messaging host component is installed.

Observação:

Add the --ext-id={extensionId} option to target a specific extension version; if omitted, the latest version published to the Web Store is installed. For available IDs, see Studio - List of extensions for 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
  

• Current User (Native Messaging Host only)

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

• All Users (Native Messaging Host only)

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