Formas alternativas de distribuir uma extensão

Artigo
03/25/2025

Geralmente, uma extensão do Microsoft Edge é distribuída ao publicá-la nos Suplementos do Microsoft Edge. Existem alguns cenários em que poderá ter de distribuir uma extensão através de métodos alternativos. Por exemplo:

A extensão está associada a outro software e deve ser instalada juntamente com o resto do software agrupado.
Os administradores de rede querem distribuir uma extensão por toda a organização.

As extensões que não são carregadas a partir de Suplementos do Microsoft Edge são denominadas extensões instaladas externamente. Seguem-se métodos alternativos de distribuição de extensões instaladas externamente:

Utilize o registo do Windows (apenas Windows).
Utilize um ficheiro JSON de preferências (macOS e Linux).

Estas abordagens são descritas abaixo.

Veja também:

Definir uma extensão instalada externamente para atualizar automaticamente

Recolher informações iniciais

Certifique-se de que publica a extensão nos Suplementos do Microsoft Edge ou empacota um .crx ficheiro e certifique-se de que é instalado com êxito no seu computador. Se instalar o .crx ficheiro com o update_url, certifique-se de que pode aceder à extensão nesse URL.

Além disso, certifique-se de que tem as seguintes informações:

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

Os exemplos seguintes utilizam 1.0 como a versão e aaaaaaaabbbbbbbbccccccccdddddddd para o ID. Este ID é o ID CRX, que é um código de 32 carateres exclusivo que corresponde às letras que estão presentes no final do URL da extensão. Este ID é gerado automaticamente e não pode ser personalizado.

Utilizar o registo do Windows (apenas Windows)

Para distribuir a extensão com o registo do Windows:

Localize ou crie a seguinte chave no registo:
- 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 o 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 ficheiro da sua extensão em Suplementos do Microsoft Edge.
```
{
    "update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx"
}
```
Se quiser instalar uma extensão a partir da Chrome Web Store, defina o valor de update_url como https://clients2.google.com/service/update2/crx.
No Microsoft Edge, aceda a edge://extensionse, em seguida, verifique se a extensão está listada.

Utilizar um ficheiro JSON de preferências (macOS e Linux)

Para distribuir a extensão com um ficheiro JSON de preferências:

Ao utilizar o Linux, certifique-se de que o .crx ficheiro de extensão está disponível no computador no qual a extensão será instalada. Copie o .crx ficheiro de extensão para um diretório local ou utilize uma partilha de rede que esteja acessível a partir do computador.
Crie um ficheiro JSON onde o nome do ficheiro corresponda ao ID da sua extensão. Por exemplo, crie um ficheiro JSON com o nome aaaaaaaabbbbbbbbccccccccdddddddd.jsonde ficheiro .

O nome do ficheiro JSON de preferências é o ID CRX da extensão do Microsoft Edge, seguido de uma .json extensão. O ID CRX é um código de 32 carateres exclusivo que corresponde às letras que estão presentes no final do URL da extensão. Este ID é gerado automaticamente e não pode ser personalizado.
Consoante o seu sistema operativo, guarde o ficheiro JSON numa das seguintes pastas:
- macOS
  - Específico do utilizador: ~USERNAME/Library/Application Support/Microsoft Edge/External Extensions/
  - Para todos os utilizadores: /Library/Application Support/Microsoft/Edge/External Extensions/
  Para impedir que utilizadores não autorizados instalem extensões para todos os utilizadores, certifique-se de que o ficheiro de preferências de extensão é só de leitura.
  
  Certifique-se também de que as seguintes condições são cumpridas:
  - Todos os diretórios no caminho pertencem à raiz do utilizador.
  - Todos os diretórios no caminho são atribuídos ao admin grupo ou wheel .
  - Todos os diretórios no caminho não world são graváveis.
  - O caminho tem de estar livre de ligações simbólicas.
- Linux
  - Específico do utilizador: ~/.config/microsoft-edge/External Extensions/
  - Para todos os utilizadores: /usr/share/microsoft-edge/extensions/
Dependendo do seu cenário, copie o código adequado que se segue para o ficheiro JSON de preferências.
- Aplica-se apenas ao Linux. Se instalar a partir de um ficheiro, especifique a localização e a versão no external_crx e external_version:
```
{
   "external_crx": "/home/share/extension.crx",
   "external_version": "1.0"
}
```
- Aplica-se a macOS e Linux. Se instalar a partir de um update_url, especifique o URL de atualização em external_update_url.
  
  Copie o seguinte código para o ficheiro JSON de preferências ao instalar a partir de ficheiros locais .crx apenas no Linux:
```
{
   "external_update_url": "http://myhost.com/mytestextension/updates.xml"
}
```
- Copie o seguinte código para o ficheiro JSON de preferências ao instalar a partir dos Suplementos do Microsoft Edge no macOS e Linux:
```
{
   "external_update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx"
}
```
Para instalar extensões para regiões específicas, liste as regiões suportadas, em supported_locales.

Pode especificar regiões principais para instalar a extensão para todas as regiões de idioma que utilizam esse elemento principal. Por exemplo, ao utilizar a região enprincipal , a extensão é instalada para todas as regiões em inglês, como en-US, en-GBe assim sucessivamente. Quando os utilizadores alteram a região no browser, as extensões instaladas externamente são desinstaladas. Para instalar a extensão para qualquer região, não utilize supported_locales.
```
{
   "external_update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx",
   "supported_locales": [ "en", "fr", "de" ]
}
```
Verifique se a extensão está instalada no Microsoft Edge, acedendo a edge://extensions.

Atualizar e desinstalar extensões instaladas externamente

O Microsoft Edge analisa as entradas de metadados no registo sempre que o browser é iniciado e efetua quaisquer alterações às extensões instaladas externamente.

Para atualizar a extensão para uma nova versão, atualize a version cadeia no ficheiro de manifesto da extensão e, em seguida, atualize a versão no registo.

Poderá ter de desinstalar extensões instaladas externamente, que foram instaladas como parte de um pacote de software que foi instalado anteriormente no computador. Para desinstalar a extensão, remova o ficheiro JSON de preferências ou remova a chave do registo.

Veja também:

Bloqueio de extensões

As políticas para ExtensionInstallForcelist, lista de blocos e ExtensionSettings são utilizadas quando as empresas querem instalar ou bloquear extensões específicas nos computadores cliente. As extensões e a respetiva 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 tem qualquer efeito. Se a BlockExternalExtensions política estiver definida como Enabled, a instalação da extensão externa (por software de terceiros) é impedida.

Confira também

Documentos do Microsoft Edge Enterprise:

Microsoft Edge - Políticas

Documentos das Extensões do Chrome:

Utilizar métodos de instalação alternativos

Observação

Partes desta página são modificações baseadas no trabalho criado e partilhado pela Google e utilizado de acordo com os termos descritos na Licença Internacional Creative Commons Attribution 4.0. A página original encontra-se aqui.

Este trabalho é licenciado ao abrigo de uma Licença Internacional creative Commons Attribution 4.0.

Compartilhar via