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

Você pode instalar a extensão da UiPath para Chrome de várias maneiras, dependendo do volume de interação do usuário permitido.

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

The extension is installed and enabled.

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

The extension is installed and enabled.

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

The extension is installed and enabled.

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>

			<!-- 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 registrado em uma solução de MDM, a ferramenta UiPath.ExtensionControl.Portable.dll gravará a configuração necessária localmente, sem que seja substituída pelas políticas aplicadas pelo MDM. Isso permite que o Chrome aplique a política e garante que a extensão seja habilitada sem exigir 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.

Etapas de instalação

A. MDM-enrolled machine

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

The extension is installed and enabled.

B. Not MDM-enrolled 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 --scope=machine
   

2. Projetar e executar automações.

Resultado

The extension is installed and enabled.

Política de grupo off-line

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 define a política ExtensionInstallForcelist. Essa política garante que a extensão esteja habilitada e que ela não possa ser desabilitada manualmente.

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

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

The extension is installed and enabled.

Esse método utiliza Perfis de configuração que ferramentas de MDM (gerenciamento de dispositivos móveis) implantam. O Perfil de 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 offline da Política de Grupo 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 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