Acompanhe o progresso da migração
Use as listas de verificação abaixo para acompanhar seu trabalho de migração. Eles definem as tarefas que precisam ser concluídas com links para instruções. O trabalho de migração é dividido em cinco categorias, conforme descrito no Resumo de migração.
Atualizar o manifesto
O arquivo manifest.json requer um formato um pouco diferente para o Manifest V3 e para o Manifesto V2. Nesta página, descrevemos as mudanças que afetam apenas o arquivo manifest.json. No entanto, muitas das mudanças em scripts e páginas também exigem mudanças no manifesto. Essas alterações são cobertas com as tarefas de migração que as exigem.
- Mude o número da versão do manifesto.
- Atualize as permissões do host.
- Atualize os recursos acessíveis pela Web.
Migrar para um service worker
Um service worker substitui o segundo plano ou a página de eventos da extensão para garantir que o código em segundo plano permaneça fora da linha de execução principal. Isso permite que as extensões sejam executadas apenas quando necessário, economizando recursos.
Antes de começar, leia sobre as diferenças entre scripts em segundo plano e service workers de extensão.
- Atualizar o campo "background" no manifesto
- Mover chamadas de janela e DOM para um documento fora da tela
- Converter localStorage para chrome.storage.local
- Registrar listeners de maneira síncrona
- Substitua chamadas para
XMLHttpRequest()porfetch()global. - Persistir estados
- Converter timers em alarmes
- Manter o service worker ativo (em casos excepcionais)
Atualizar chamadas de API
Alguns recursos precisam ser substituídos por equivalentes do Manifest V3. Outros precisam ser removidos.
- Substitua
tabs.executeScript()porscripting.executeScript(). - Substitua
tabs.insertCSS()etabs.removeCSS()porscripting.insertCSS()escripting.removeCSS(). - Substituir ações do navegador e de página por ações
- Substitua funções que esperam um contexto em segundo plano do Manifest V2.
- Substituir callbacks por promessas
- Substituir APIs sem suporte
Substituir listeners de solicitações da Web de bloqueio
Em vez de ler e alterar as solicitações de rede programaticamente (como foi feito no Manifesto V2), a extensão especifica regras que descrevem as ações a serem realizadas quando um determinado conjunto de condições for atendido.
Depois de concluir os itens acima, analise alguns casos de uso comuns:
Melhore a segurança da extensão
As mudanças são necessárias para melhorar a segurança das extensões. Isso inclui a remoção do código hospedado remotamente, que não é mais compatível.
- Remova a execução de strings arbitrárias.
- Remover código hospedado remotamente
- Atualizar a Política de Segurança de Conteúdo.
- Remover valores da Política de Segurança de Conteúdo sem suporte
Publicar a extensão Manifest V3
Após fazer a conversão para a versão 3 do Manifesto, é hora de lançar a extensão na Chrome Web Store. Dependendo das alterações feitas, considere uma implementação gradual. Essa abordagem permite garantir que a extensão funcione conforme esperado com um público limitado antes de liberá-la para toda a base de usuários.