Fazer sideload de uma extensão para instalá-la e testá-la localmente

Para testar uma extensão com rapidez e segurança, faça o sideload da extensão em sua própria cópia do Microsoft Edge, o que significa instalar a extensão localmente. Você pode executar e testar sua extensão sem precisar publicá-la em Complementos do Microsoft Edge e, em seguida, instalar a extensão a partir daí.

Os usuários procuram e instalam extensões para Microsoft Edge de complementos do Microsoft Edge.

Pré-requisito: ter uma extensão para instalar

Este artigo pressupõe que sua unidade local contém uma extensão que você deseja carregar, como um exemplo do repositório MicrosoftEdge-Extensions .

Para obter as amostras, consulte Clonar o repositório MicrosoftEdge-Extensions em Amostra: página pop-up do visualizador de imagens.

Instalando e executando localmente uma extensão

Para fazer sideload de uma extensão no Microsoft Edge, para que ela seja instalada localmente em seu navegador para teste:

  1. Acesse uma página da Web, como o aplicativo TODO, em uma nova janela ou guia. Para alguns exemplos, esta etapa é opcional e serve apenas para corresponder às capturas de tela abaixo; Alguns exemplos não exigem que uma página da Web seja aberta.

  2. No Microsoft Edge, à direita da barra de endereços, se esse ícone for exibido, clique no botão Extensões (ícone de Extensões). Ou selecione Configurações e mais (o ícone> "Configurações e mais") Extensões.

    O pop-up de extensões é aberto:

    O pop-up de Extensões quando nenhuma extensão está instalada

  3. Clique em Gerenciar extensões. A página Gerenciamento de extensões é aberta em uma nova guia:

    Ativando o modo de desenvolvedor

  4. Ative a alternância do modo Desenvolvedor .

  5. Ao instalar sua extensão pela primeira vez, clique no botão Carregar descompactado (o ícone A caixa de diálogo Selecionar o diretório de extensão é aberta.

  6. Selecione o diretório que contém os arquivos de origem da extensão, como manifest.json.

    Caminhos de exemplo resultantes da clonagem do repositório MicrosoftEdge-Extensions :

    C:\Users\localAccount\GitHub\MicrosoftEdge-Extensions\Extension-samples\picture-viewer-popup-webpage C:\Users\localAccount\GitHub\MicrosoftEdge-Extensions\Extension-samples\picture-inserter-content-script

  7. Clique no botão Selecionar Pasta .

    A caixa de diálogo Selecionar o diretório de extensão é aberta.

    A extensão é instalada em seu navegador, semelhante às extensões instaladas a partir de complementos do Microsoft Edge:

    Página de extensões instaladas, mostrando uma extensão de sideload

  8. Se a extensão exigir que uma página da Web esteja aberta, verifique se uma página da Web está aberta, como o aplicativo TODO.

  9. Atualize a página da Web. Às vezes, isso é necessário após recarregar uma extensão.

  10. No Microsoft Edge, à direita da barra de endereços, clique no botão Extensões (ícone de Extensões). Ou selecione Configurações e mais (o ícone> "Configurações e mais") Extensões.

    O pop-up de extensões é aberto:

    O pop-up de extensões

  11. Clique no ícone ou no nome da extensão. A extensão é aberta e o ícone da extensão é adicionado ao lado da barra de endereços e do botão Extensões (ícone de Extensões):

    Uma extensão em execução

Atualizando localmente uma extensão (Recarregar)

Para atualizar uma extensão que foi instalada localmente (sideloaded) em seu navegador:

  1. Faça alterações no código-fonte da extensão e salve essas alterações.

  2. No Microsoft Edge, se a guia Gerenciamento de extensões estiver aberta, clique nela.

    Ou, à direita da barra de endereços, se esse ícone for exibido, clique no botão Extensões (ícone de Extensões). O pop-up de extensões é aberto. Clique em Gerenciar extensões.

    Ou selecione Configurações e mais (o ícone> "Configurações e mais") Extensões>Gerenciar extensões.

    A guia Gerenciamento de extensões é exibida.

  3. Clique no link Recarregar no card da extensão.

  4. Atualize a página da Web. Às vezes, isso é necessário após recarregar uma extensão.

Removendo localmente uma extensão

Para remover uma extensão que foi instalada localmente (sideload) no navegador:

  1. No Microsoft Edge, se a guia Gerenciamento de extensões estiver aberta, clique nela.

    Ou, à direita da barra de endereços, se esse ícone for exibido, clique no botão Extensões (ícone de Extensões). O pop-up de extensões é aberto. Clique em Gerenciar extensões.

    Ou selecione Configurações e mais (o ícone> "Configurações e mais") Extensões>Gerenciar extensões.

    A guia Gerenciamento de extensões é exibida.

  2. Clique no link Remover no card da extensão.

Relatórios de erros na página Gerenciamento de extensões

Se a execução de uma extensão causar um erro, em alguns casos, um link de erro será adicionado ao card da extensão na página Gerenciamento de extensões entre os links Remover e Recarregar.

  1. No Microsoft Edge, se a guia Gerenciamento de extensões estiver aberta, clique nela.

    Ou, à direita da barra de endereços, se esse ícone for exibido, clique no botão Extensões (ícone de Extensões). O pop-up de extensões é aberto. Clique em Gerenciar extensões.

    Ou selecione Configurações e mais (o ícone> "Configurações e mais") Extensões>Gerenciar extensões.

    A guia Gerenciamento de extensões é exibida.

  2. Clique no link Error no card da extensão.

  3. Corrija o erro no código da extensão.

  4. Na página Gerenciamento de extensões , clique no link Recarregar .

  5. Para fazer com que o link Erro no card da extensão desapareça, na página Gerenciamento de extensões, clique no botão Limpar erros.

Confira também