Maneiras alternativas de distribuir uma extensão

Geralmente, uma extensão do Microsoft Edge é distribuída publicando-a em Complementos do Microsoft Edge. Há alguns cenários em que talvez seja necessário distribuir uma extensão usando métodos alternativos. Por exemplo:

1. A extensão está associada a outro software e deve ser instalada junto com o restante do software empacotado.

2. Os administradores de rede querem distribuir uma extensão em toda a organização.

As extensões que não são carregadas de complementos do Microsoft Edge são chamadas de extensões instaladas externamente. Estes são 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.

Veja também:

• Configurar uma extensão instalada externamente para atualizar automaticamente

Reúna as informações iniciais

Certifique-se de publicar sua extensão em 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 acessar sua extensão nessa URL.

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

• O caminho do .crx arquivo ou o update_url da sua extensão.

• A versão da sua extensão. As informações de versão estão disponíveis no arquivo de manifesto ou no Microsoft Edge depois edge://extensions que você carregar a extensão compactada.

• A ID de sua extensão. As informações de ID estão disponíveis no Microsoft Edge após edge://extensions o carregamento da extensão compactada.

Os exemplos a seguir são usados 1.0 como a versão e aaaaaaaabbbbbbbbccccccccdddddddd para a ID. Essa ID é a ID CRX, que é um código exclusivo de 32 caracteres que são as letras que estão presentes no final da URL da sua extensão. Essa ID é gerada automaticamente e não pode ser personalizada.

Usando o Registro do Windows (somente Windows)

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

1. Localize ou crie 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

2. Crie uma nova chave ou pasta em Extensões com o mesmo nome da ID da sua extensão. Por exemplo, crie a chave com o nome aaaaaaaabbbbbbbbccccccccdddddddd.

3. 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 da sua extensão em Complementos do Microsoft Edge.

   {
       "update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx"
   }
   

   Se você deseja instalar uma extensão da Chrome Web Store, defina o valor de update_url como https://clients2.google.com/service/update2/crx.

4. 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:

1. Ao usar o Linux, certifique-se de que .crx o arquivo de extensão esteja disponível no computador em que a extensão será instalada. Copie o .crx arquivo de extensão para um diretório local ou use um compartilhamento de rede acessível pelo computador.

2. Crie um arquivo JSON em que o nome do arquivo corresponda à ID de sua extensão. Por exemplo, crie um arquivo JSON com o nome aaaaaaaabbbbbbbbccccccccdddddddd.jsonde 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 que estão presentes no final da URL da sua extensão. Essa ID é gerada automaticamente e não pode ser personalizada.

3. 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 vínculos simbólicos.

   • Linux

     • Específico do usuário: ~/.config/microsoft-edge/External Extensions/
     • Para todos os usuários: /usr/share/microsoft-edge/extensions/

4. Dependendo do cenário, copie o código apropriado a seguir para o arquivo JSON de suas preferências.

   • Aplica-se somente ao Linux. Se você instalar 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 a macOS e Linux. Se você instalar a partir de um update_url, especifique a URL de atualização no external_update_url.

     Copie o seguinte código no arquivo JSON de suas preferências ao instalar a partir de arquivos locais .crx apenas no Linux:

     {
         "external_update_url": "http://myhost.com/mytestextension/updates.xml"
     }
     

   • Copie o seguinte código para suas preferências Arquivo JSON ao instalar a partir de complementos do Microsoft Edge no macOS e Linux:

     {
         "external_update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx"
     }
     

5. Para instalar extensões para localidades específicas, liste as localidades com suporte no 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-GB, e 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 em qualquer localidade, não use supported_locales.

   {
      "external_update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx",
      "supported_locales": [ "en", "fr", "de" ]
   }
   

6. Verifique se a extensão está instalada no Microsoft Edge acessando o 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, em seguida, 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 suas preferências arquivo JSON ou remova a chave do registro.

Veja também:

• Configurar uma extensão instalada externamente para atualizar automaticamente
• Formato de arquivo do manifesto para extensões

Bloqueio de extensões

As políticas para ExtensionInstallForcelist, lista de bloqueios e ExtensionSettings são usadas quando as empresas querem instalar ou bloquear extensões específicas nos computadores cliente. As extensões e suas origens 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 política estiver definida como Enabled, a BlockExternalExtensions instalação de extensão externa (por software de terceiros) será impedida.

Confira também

• Configurar uma extensão instalada externamente para atualizar automaticamente
• Formato de arquivo do manifesto para extensões

Documentos do Microsoft Edge Enterprise:

• Microsoft Edge - Políticas
  • ExtensionInstallForcelist
  • ExtensionInstallSources
  • ExtensionSettings
  • BlockExternalExtensions

Este trabalho está licenciado sob uma Licença Creative Commons Atribuição 4.0 Internacional.