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 para o usuário atual ou para todos os usuários, 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 é o local 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/ Substituir {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 mais recente da extensão publicada na Web Store 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 Google Chrome.

   

6. Selecione Habilitar extensão no 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, junto 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 exige a execução de binários a partir de seus locais originais.
• 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 a ID da extensão, a URL de atualização e o caminho para o host de mensagens nativas.

Observação:

• Adicione a opção --ext-id={extensionId} para direcionar uma versão da extensão específica.Substituir {extensionId} pela 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 omitida, a versão mais recente da extensão publicada na Web Store será 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 no pop-up de confirmação do Google Chrome.

   

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

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.

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 da extensão específica.Substituir {extensionId} pela 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 omitida, a versão mais recente da extensão publicada na Web Store será 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 no pop-up de confirmação do Google Chrome.

   

Resultado: a extensão será 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 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.

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, a ferramenta UiPath.ExtensionControl.Portable.dll grava a configuração necessária localmente, sem que ela seja substituída 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.

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.
• O comando pode ser emitido com --scope=user em vez de --scope=machine, com o efeito de que apenas o usuário atual recebe a extensão instalada e habilitada automaticamente. Qualquer outro usuário não terá a extensão instalada.
• Adicione a opção --ext-id={extensionId} para direcionar uma versão da extensão específica.Substituir {extensionId} pela 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 omitida, a versão mais recente da extensão publicada na Web Store será instalada.

A. Instalar etapas na máquina inscrita no MDM

1. Abra um terminal e execute o seguinte comando. O argumento bypolicy pode ser removido se a configuração enviada por meio do MDM estiver definida para substituir 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. Projetar e executar automações.

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

B. Instalar etapas em máquinas não inscritas 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. Projetar e executar automações.

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

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).

UiPath.ExtensionControl.Portable.dll não consegue realizar totalmente esse tipo de instalação, pois requer intervenção (na máquina local ou a partir de uma máquina administradora).

UiPath.ExtensionControl.Portable.dll fornece compatibilidade para atualizar os arquivos de configuração necessários à extensão para sua comunicação com o host nativo. Portanto, você pode usá-lo para instalar a extensão por usuário ou por máquina, conforme mostrado anteriormente, mas você deve seguir etapas adicionais para garantir que a extensão seja instalada e Habilitado.

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>
			<!-- 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>

A string ExtensionInstallForcelist tem os seguintes formatos:

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

O valor {urlWithThePathToTheUpdateManifestXmlFile} deve ser substituído por uma URL (https:// ou file://) para o arquivo XML do 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:

• Substituir {extensionId} pela ID da extensão.
• O {crxUrl} deve ser substituído pela URL do CRX (https:// - se o CRX estiver hospedado em um servidor ou file:// - se o arquivo estiver 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 executadas na máquina administradora.

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

2. Envie o perfil usando um provedor de MDM.

3. Instale o host de mensagens nativas 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. Projetar e executar automações.

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

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 está 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 está 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 native-messaging-host-only --scope=machine