Formas alternativas de distribuir extensões

Artigo
12/14/2023

Geralmente, as extensões são distribuídas por meio do site de Complementos do Microsoft Edge. Há alguns cenários em que os desenvolvedores podem precisar distribuir extensões usando métodos alternativos. Por exemplo:

A extensão está associada a outros softwares e deve ser instalada junto com o restante do software empacotado.
Os administradores de rede querem distribuir uma extensão por toda a organização.

As extensões que não são carregadas do repositório Suplementos do Edge são chamadas de extensões instaladas externamente. Veja a seguir métodos alternativos de distribuição de extensões instaladas externamente:

Use o registro do Windows (somente Windows).
Use um arquivo JSON de preferências (macOS e Linux).

Essas abordagens são descritas abaixo.

Antes de começar

Certifique-se de publicar sua extensão no site de Complementos do Microsoft Edge ou empacotar um .crx arquivo e garantir que ele seja instalado com êxito em seu computador. Se você instalar o .crx arquivo usando o update_url, verifique se você pode ir para sua extensão nessa URL.

Além disso, verifique se você tem as seguintes informações:

O caminho do .crx arquivo ou a update_url de sua extensão.
A versão da extensão. As informações da versão estão disponíveis no arquivo de manifesto ou no edge://extensions Microsoft Edge depois de carregar a extensão empacotada.
A ID da sua extensão. As informações de ID estão disponíveis no edge://extensions Microsoft Edge depois de carregar a extensão empacotada.

Os exemplos a seguir usam 1.0 como a versão e aaaaaaaabbbbbbbbccccccccdddddddd para a ID.

Usando o registro do Windows (somente Windows)

Para distribuir sua extensão usando o registro do Windows:

Localizar ou criar a seguinte chave no registro:
- Windows de 32 bits: HKEY_LOCAL_MACHINE\Software\Microsoft\Edge\Extensions
- Windows de 64 bits: HKEY_LOCAL_MACHINE\Software\Wow6432Node\Microsoft\Edge\Extensions
Crie uma nova chave ou pasta em Extensões com o mesmo nome que a ID da sua extensão. Por exemplo, crie a chave com o nome aaaaaaaabbbbbbbbccccccccdddddddd.
Na chave Extensões , crie a update_url propriedade e defina o valor como https://edge.microsoft.com/extensionwebstorebase/v1/crx. A update_url propriedade aponta para o .crx arquivo de sua extensão no site de Complementos do Microsoft Edge.
```
{
    "update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx"
}
```
Observação

Se você quiser instalar uma extensão da Chrome Web Store, defina o valor de update_url como https://clients2.google.com/service/update2/crx.
No Microsoft Edge, acesse edge://extensionse verifique se a extensão está listada.

Usando um arquivo JSON de preferências (macOS e Linux)

Para distribuir sua extensão usando um arquivo JSON de preferências:

Ao usar o Linux, verifique se o .crx arquivo de extensão está disponível no computador no qual a extensão será instalada. Copie o .crx arquivo de extensão para um diretório local ou use um compartilhamento de rede que seja acessível do computador.
Crie um arquivo JSON em que o nome do arquivo corresponda à ID da sua extensão. Por exemplo, crie um arquivo JSON com o nome aaaaaaaabbbbbbbbccccccccdddddddd.jsondo arquivo .

O nome do arquivo JSON de preferências é a ID CRX da extensão do Microsoft Edge, seguida por uma .json extensão. A ID crx é um código exclusivo de 32 caracteres que são as letras presentes no final da URL da sua extensão.
Dependendo do sistema operacional, salve o arquivo JSON em uma das seguintes pastas:
- macOS
  - Específico do usuário: ~USERNAME/Library/Application Support/Microsoft Edge/External Extensions/
  - Para todos os usuários: /Library/Application Support/Microsoft/Edge/External Extensions/
  Para impedir que usuários não autorizados instalem extensões para todos os usuários, verifique se o arquivo de preferências de extensão é somente leitura.
  
  Certifique-se também de que as seguintes condições sejam atendidas:
  - Cada diretório no caminho pertence à raiz do usuário.
  - Cada diretório no caminho é atribuído ao admin grupo ou wheel .
  - Todos os diretórios no caminho não world são graváveis.
  - O caminho deve estar livre de links simbólicos.
- Linux
  - Específico do usuário: ~/.config/microsoft-edge/External Extensions/
  - Para todos os usuários: /usr/share/microsoft-edge/extensions/
Dependendo do cenário, copie o código apropriado a seguir no arquivo JSON de suas preferências.
- Aplica-se apenas ao Linux. Se você instalar a partir de um arquivo, especifique o local e a versão em external_crx e external_version:
```
{
    "external_crx": "/home/share/extension.crx",
    "external_version": "1.0"
}
```
- Aplica-se ao macOS e ao Linux. Se você instalar a partir de um update_url, especifique a URL de atualização em external_update_url.
  
  Copie o seguinte código em seu arquivo JSON de preferências ao instalar somente arquivos locais .crx no Linux:
```
{
    "external_update_url": "http://myhost.com/mytestextension/updates.xml"
}
```
- Copie o código a seguir para o arquivo JSON de suas preferências ao instalar no site de Suplementos do Microsoft Edge no macOS e no Linux:
```
{
    "external_update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx"
}
```
Para instalar extensões para localidades específicas, liste as localidades com suporte, em supported_locales.

Você pode especificar localidades pai para instalar sua extensão para todas as localidades de idioma que usam esse pai. Por exemplo, ao usar a localidade enpai , sua extensão é instalada para todas as localidades em inglês, como en-US, en-GBe assim por diante. Quando os usuários alteram sua localidade no navegador, as extensões instaladas externamente são desinstaladas. Para instalar sua extensão para qualquer localidade, não use supported_locales.
```
{
    "external_update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx",
    "supported_locales": [ "en", "fr", "de" ]
}
```
Verifique se sua extensão está instalada no Microsoft Edge, indo para edge://extensions.

Atualizar e desinstalar extensões instaladas externamente

O Microsoft Edge verifica as entradas de metadados no registro sempre que o navegador é iniciado e faz alterações nas extensões instaladas externamente.

Para atualizar sua extensão para uma nova versão, atualize a version cadeia de caracteres no arquivo de manifesto de extensão e atualize a versão no registro.

Talvez seja necessário desinstalar extensões instaladas externamente, que foram instaladas como parte de um pacote de software que foi instalado anteriormente no computador. Para desinstalar sua extensão, remova o arquivo JSON de suas preferências ou remova a chave do registro.

Veja também:

Formato de arquivo de manifesto para extensões

Bloqueio de extensões

As políticas para ExtensionInstallForcelist, lista de blocos e ExtensionSettings são usadas quando as empresas desejam instalar ou bloquear extensões específicas nos computadores cliente. Extensões e sua origem configuradas em ExtensionInstallForcelist, ExtensionInstallSources ou ExtensionSettings têm precedência sobre BlockExternalExtensions.

Se a BlockExternalExtensions política estiver definida como Not Configured ou Disabled, isso não terá nenhum efeito. Se a BlockExternalExtensions política for definida como Enabled, a instalação de extensão externa (por software de terceiros) será impedida.

Observação

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Google e usadas de acordo com os termos descritos na Licença Internacional de Atribuição do Creative Commons 4.0. A página original é encontrada aqui.

Este trabalho é licenciado sob uma Licença Internacional de Atribuição do Creative Commons 4.0.