Acompanhe o progresso da migração
As checklists a seguir ajudam você a acompanhar seu trabalho de migração. Eles definem tarefas que precisam ser concluídas com links para instruções. O trabalho de migração é dividido em cinco categorias, conforme descrito no Resumo da migração.
Atualizar o manifesto
O arquivo manifest.json exige um formato um pouco diferente para o Manifesto V3 do que para o Manifesto V2. Esta página descreve mudanças que afetam apenas o arquivo manifest.json. No entanto, muitas das mudanças em scripts e páginas também exigem alterações no manifesto. Essas mudanças são abordadas nas tarefas de migração que as exigem.
- Mude o número da versão do manifesto.
- Atualizar permissões de host.
- Atualize os recursos acessíveis da Web.
Migrar para um service worker
Um service worker substitui a página de segundo plano ou de eventos da extensão para garantir que o código de segundo plano fique 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.
- Atualize o campo "background" no manifesto
- Mover chamadas de DOM e janela para um documento fora da tela
- Converter localStorage para chrome.storage.local
- Registrar listeners de forma síncrona
- Substitua as 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 Manifesto V3. Outros precisam ser removidos completamente.
- Substitua
tabs.executeScript()porscripting.executeScript(). - Substitua
tabs.insertCSS()etabs.removeCSS()porscripting.insertCSS()escripting.removeCSS(). - Substituir as ações do navegador e da página por ações
- Substitua as 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 programaticamente as solicitações de rede (como você fez no Manifest V2), sua extensão especifica regras que descrevem as ações a serem realizadas quando um determinado conjunto de condições é atendido.
Depois de concluir os itens acima, confira alguns casos de uso comuns:
Melhorar a segurança das extensões
Mudanças são necessárias para melhorar a segurança das extensões. Isso inclui a remoção de código hospedado remotamente, que não é mais compatível.
- Remova a execução de strings arbitrárias.
- Remover código hospedado remotamente
- Atualize a Política de Segurança de Conteúdo.
- Remover valores incompatíveis da política de segurança de conteúdo
Publicar sua extensão do Manifest V3
Depois de converter para o Manifest V3, é hora de lançar sua extensão na Chrome Web Store. Dependendo das mudanças feitas, considere uma implantação gradual. Assim, você garante que a extensão funcione como esperado com um público limitado antes de lançar para toda a base de usuários.