Compartilhar via


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:

  1. A extensão está associada a outro software e deve ser instalada juntamente com o resto do software agrupado.

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

  1. 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
  2. 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.

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

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

  1. 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.

  2. 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.

  3. 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/
  4. 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"
      }
      
  5. 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" ]
    }
    
  6. 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:

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.

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