Formas alternativas de distribuir uma extensão

Artigo
09/25/2024

Geralmente, as extensões são distribuídas através do site suplementos do Microsoft Edge. Existem alguns cenários em que os programadores poderão ter de distribuir extensões 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 do arquivo de Suplementos do Edge são referidas como 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 no site dos 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.

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 no site 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.
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 do site 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