Formas alternativas de distribuir uma extensão
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:
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 daupdate_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
- Windows de 32 bits:
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 comohttps://edge.microsoft.com/extensionwebstorebase/v1/crx
. Aupdate_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
comohttps://clients2.google.com/service/update2/crx
.No Microsoft Edge, aceda a
edge://extensions
e, 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.json
de 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 ouwheel
. - Todos os diretórios no caminho não
world
são graváveis. - O caminho tem de estar livre de ligações simbólicas.
- Específico do utilizador:
Linux
- Específico do utilizador:
~/.config/microsoft-edge/External Extensions/
- Para todos os utilizadores:
/usr/share/microsoft-edge/extensions/
- Específico do utilizador:
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
eexternal_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 emexternal_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
en
principal , a extensão é instalada para todas as regiões em inglês, comoen-US
,en-GB
e 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 utilizesupported_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:
- Definir uma extensão instalada externamente para atualizar automaticamente
- Formato de ficheiro de manifesto para extensões
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
- Definir uma extensão instalada externamente para atualizar automaticamente
- Formato de ficheiro de manifesto para extensões
Documentos do Microsoft Edge Enterprise:
Documentos das Extensões do Chrome:
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.