Google ChromeUma extensão, quatro lojas: publicar no Chrome, Edge, Firefox e Safari a partir do mesmo código
Equipa de AiToolsForAppsRedigido com assistência de IA17 min de leituraEm resumo
- Desde o Chrome 148, todas as APIs de extensões estão disponíveis sob o namespace
browser, além do clássicochrome, segundo o guia Transição para o namespace browser do Chrome for Developers. O resumo de I/O 2026 para extensões web (novembro de 2026) diz assim: o global compartilhado "reduz a necessidade de aliases de compatibilidade". - As extensões com
devtools_pageficaram de fora no início: o suporte abrowsernesse caso chegou no Chrome 152. - O que não foi unificado é a ficha: o Chrome pede capturas de 1280x800, o Edge aceita 640x480 ou 1280x800, a Apple exige 16:10 sem canal alfa (1280x800, 1440x900, 2560x1600 ou 2880x1800) e o AMO recomenda 1280x800 ou relação 1,6:1.
- Os limites de texto também não coincidem:
descriptiondo manifest 132 caracteres no Chrome, descrição da loja de 250 a 10.000 no Edge, resumo de 250 no AMO e nome do app de 30 no App Store Connect. - E a privacidade é declarada quatro vezes: aba Privacy no Chrome, página Privacy no Partner Center,
data_collection_permissionsno manifest para AMO e política de privacidade no App Store Connect.

Durante anos, levar uma extensão do Chrome para o Firefox, Edge e Safari começava pela mesma linha feia no cabeçalho de cada arquivo: um alias que decidia se usava chrome.* ou browser.*. Em 2026, essa linha não é mais necessária. O que continua sendo necessário são as horas gastas refazendo a ficha da loja quatro vezes, e é aí que entra o aiChrome, a ferramenta da AiToolsForApps para quem cria, vende ou compete em extensões do Chrome: tem o catálogo de medidas e limites da ficha do Chrome Web Store com selo de verificação, e o que não se encaixa na especificação não é entregue. Este artigo conta o que deixa de ser necessário no código e o que continua sendo trabalho manual loja por loja.
O que mudou exatamente em 2026 com o namespace browser?
O Chrome adotou o global browser que já era usado pelo Firefox e Safari. Segundo a documentação oficial da transição para o namespace browser, "desde o Chrome 148, todas as APIs de extensões do Chrome estão disponíveis sob o namespace browser, além do chrome existente". O namespace chrome não é retirado: os dois coexistem, então não há nada a quebrar.
O efeito prático é que uma extensão que aponte apenas para navegadores modernos pode ser escrita uma vez, com browser.* e promessas, e funcionar nos quatro motores sem camada intermediária. Dois detalhes importantes:
runtime.onMessageaceita promessas. No Chrome 148, um listener pode retornar diretamente umaPromisepara responder de forma assíncrona, em vez do clássicoreturn truepara manter o canal aberto.- O polyfill se torna desnecessário. A documentação do Chrome indica que webextension-polyfill "não faz nada no Chrome 148 e posteriores", porque o navegador já traz o suporte nativo.

Posso usar browser sem quebrar os usuários com o Chrome antigo?
Sim, e a própria documentação do Chrome dá as duas rotas. Se seu público já está no Chrome 148 ou superior, declare "minimum_chrome_version": "148" no manifest e use browser sem condições. Se precisar cobrir versões anteriores, coloque um guard no início da inicialização:
if (!globalThis.browser) {
globalThis.browser = chrome;
}
O caso que mais surpresas traz é o DevTools. Em versões anteriores, declarar devtools_page desativava o namespace browser em toda a extensão, não apenas na página de DevTools. Esse limite desapareceu no Chrome 152, cobrindo qualquer extensão. Os listeners de onMessage que retornam promessas continuam não disponíveis em contextos de página de DevTools.
O que ainda não foi unificado no código
Que o namespace seja o mesmo não significa que o manifest seja. Segundo o guia da MDN para construir uma extensão multinavegador:
| Ponto | Chrome / Edge | Firefox | Safari |
|---|---|---|---|
| Namespace | chrome e browser (148+) | browser (e chrome por compatibilidade) | browser |
| Fundo em MV3 | service worker de extensão | páginas de fundo | admite ambos |
browser_specific_settings | não suportado | necessário (bloco gecko) | — |
| Empacotamento | ZIP com manifest.json na raiz | ZIP | empacotamento tipo app |
Ou seja: o namespace deixa de ser uma variável, mas o bloco background e browser_specific_settings continuam pedindo um manifest por destino. O razoável é manter um manifest base e gerar as variantes na construção, não manter quatro arquivos à mão.
O que mais o Chrome anunciou no resumo do I/O 2026?
Além do namespace, o resumo do I/O 2026 do Chrome for Developers traz duas mudanças que afetam como se publica, não como se programa: papéis de equipe no Developer Dashboard e publicação privada para empresas.
Os três novos papéis são:
- Admin: gestão geral e adição de novos membros.
- Item Manager: permite "enviar e enviar atualizações da extensão", sem dar o controle da conta.
- Viewer: para quem só precisa olhar as métricas de desempenho.
E é possível convidar membros adicionais sem que cada um tenha que passar pelo registro de desenvolvedor. Para uma agência que publica em nome de um cliente, isso é exatamente a lacuna que faltava preencher: antes, enviar uma atualização significava compartilhar a conta.
A publicação privada para empresas permite implantar uma extensão para organizações externas que a aprovam diretamente da Chrome Web Store. O mesmo resumo adiciona alguns dados de contexto do ecossistema: os registros de desenvolvedor dobraram no último ano, 17% das novas extensões na Chrome Web Store incorporam IA, e o registro de desenvolvedor está se expandindo para mais de 120 países adicionais.
As medidas de imagem são diferentes em cada loja: tabela comparativa
Aqui está o trabalho que não desaparece. Cada loja pede a mesma captura em um recorte diferente, e uma das quatro rejeita diretamente a transparência. Esta é a comparação a partir da documentação oficial de cada uma:
| Ativo | Chrome Web Store | Microsoft Edge Add-ons | AMO (Firefox) | App Store Connect (Safari) |
|---|---|---|---|---|
| Ícone / logo da ficha | 128x128 PNG (96x96 de arte + 16 px de margem transparente) | 1:1, recomendado 300x300, mínimo 128x128 | 32x32 e 64x64, PNG ou JPEG | ícone do app contêiner |
| Capturas | 1280x800 (preferido) ou 640x400, cantos quadrados e sangria | 640x480 ou 1280x800, máximo 6 | 1280x800 recomendado, ou proporção 1,6:1 | 16:10: 1280x800, 1440x900, 2560x1600 ou 2880x1800 |
| Nº de capturas | pelo menos 1, até 5 | até 6 | pelo menos as de funções chave | de 1 a 10 por tamanho |
| Mosaico pequeno | 440x280 (opcional) | 440x280 (opcional) | — | — |
| Mosaico grande / marquee | 1400x560 (opcional) | 1400x560 PNG (opcional) | — | — |
| Transparência | o ícone precisa dela na margem | — | — | proibida: sem canal alfa nem transparências |
Fontes: imagens da ficha da Chrome Web Store, publicar uma extensão do Microsoft Edge (documento atualizado em 2026), criar uma ficha atraente no AMO e especificações de capturas do App Store Connect.

Três consequências práticas dessa tabela:
- 1280x800 é o denominador comum. Serve no Chrome, no Edge e no AMO, e é uma das quatro medidas válidas da Apple. Se você só vai produzir um conjunto de capturas, que seja esse.
- A Apple te obriga a aplanar. O App Store Connect não aceita alfa nem transparências, então um PNG exportado com fundo transparente é rejeitado mesmo que "pareça bom". É preciso aplanar e medir novamente o binário, não confiar no visualizador.
- O ícone do Chrome não é um quadrado cheio. São 128x128 de tela com 96x96 de arte e 16 px de margem transparente de cada lado. É o erro mais comum ao reutilizar o ícone de outra loja.
Os limites de caracteres também não coincidem
Cada loja corta o texto em um lugar diferente, e em duas delas o texto não é escrito na loja: vem do manifest. Isso é o que diz a documentação oficial:
| Campo | Limite | Fonte |
|---|---|---|
name do manifest | máximo 75 caracteres | chave name do Chrome |
description do manifest | não mais de 132 caracteres, texto plano sem HTML | chave description do Chrome |
| Descrição de ficha no Edge | mínimo 250, máximo 10.000 caracteres | publicar no Edge Add-ons |
| Termos de busca no Edge | até 7 termos, 21 palavras no total, 30 caracteres por termo | publicar no Edge Add-ons |
| Resumo no AMO | 250 caracteres | ficha no AMO |
| Nome do app na App Store | de 2 a 30 caracteres | informação do app no App Store Connect |
| Subtítulo na App Store | 30 caracteres | informação do app no App Store Connect |
Dois detalhes que economizam um ciclo de revisão:
- No Edge, o nome da extensão e a descrição curta são somente leitura no Partner Center: saem do manifest. Para mudá-los, é necessário editar o
manifest.json, reempacotar e reenviar. Então, aqueles 132 caracteres dedescriptionnão são apenas uma questão do Chrome: viajam com você. - No Edge, se o pacote declara vários idiomas, mas apenas um locale aparece no Partner Center, geralmente é porque o manifest contém strings fixas em vez de placeholders
__MSG_extensionName__comdefault_localee_locales. O Partner Center detecta os idiomas a partir dessas referências i18n. - No Safari, o nome e o subtítulo são os da app contenedora, não os da extensão: 30 caracteres são muito pouco se você vinha de um nome de 75.
A declaração de privacidade é feita quatro vezes, e no Firefox vai no manifest
Nenhuma das quatro revisões aceita a declaração de outra, e desde o final de 2025 o Firefox deixou de pedir em um formulário para pedir dentro do manifest. Esta é a parte do processo que mais é subestimada ao planejar um lançamento multinavegador.
Chrome Web Store. A aba de privacidade do painel exige propósito único, uma justificativa por cada permissão declarada no manifest, declaração de uso de código remoto, certificação das práticas de uso de dados e URL da política de privacidade.
Microsoft Edge Add-ons. A página de Privacidade do Partner Center pede o mesmo em cinco seções: Propósito Único, justificativa por permissão, uso de código remoto, uso de dados e política de privacidade. A documentação avisa que qualquer declaração incompleta ou enganosa "pode ser considerada uma violação das políticas de desenvolvedor" e acabar em revisão adicional, atraso ou rejeição. E lembre-se que o código remoto não é permitido no Manifest V3.
AMO (Firefox). Desde o 3 de novembro de 2025, toda nova extensão deve declarar quais dados coleta ou transmite através da chave browser_specific_settings.gecko.data_collection_permissions, de acordo com o anúncio da Mozilla sobre as mudanças no consentimento de coleta de dados (23 de outubro de 2025). Se você não coleta nada, é preciso dizer isso explicitamente:
{
"browser_specific_settings": {
"gecko": {
"data_collection_permissions": { "required": ["none"] }
}
}
}
A documentação de consentimento integrado do Firefox detalha os valores admitidos (personallyIdentifyingInfo, healthInfo, financialAndPaymentInfo, authenticationInfo, personalCommunications, locationInfo, browsingActivity, websiteContent, websiteActivity, searchTerms, bookmarksInfo, mais technicalAndInteraction apenas como opcional) e a cobertura: Firefox 140 no desktop e 142 no Android. Sem a chave corretamente configurada, a extensão não pode ser enviada para assinatura. Para as extensões que já existiam antes dessa data, a Mozilla diz que terão que adotá-la "mais tarde", sem data concreta publicada.
App Store Connect (Safari). A URL da política de privacidade é obrigatória para apps de iOS e macOS, e a declaração de privacidade é feita a nível de app contenedora, com as especificações do App Store Connect como referência.
O empacotamento: três ZIP e um projeto de Xcode
Três das quatro lojas se alimentam do mesmo artefato; a quarta, não. Chrome, Edge, Firefox e Opera consomem um ZIP com o manifest.json na raiz. Safari precisa de um empacotamento tipo app: a extensão viaja dentro de um app nativo que é distribuído pela App Store.

Para a transição para o Safari, a Apple oferece a ferramenta de linha de comando xcrun safari-web-extension-converter, que gera o projeto de Xcode a partir de uma extensão web existente; está documentada em empacotar uma extensão web para Safari. O requisito duro não é técnico, é administrativo: publicar na App Store exige App Store Connect, e isso só está disponível para membros do Apple Developer Program, que custa 99 USD por ano de associação (com isenções para entidades sem fins lucrativos, educacionais acreditadas e governamentais que atendam aos requisitos). Chrome Web Store, por sua vez, pede uma taxa de registro única ao criar a conta de desenvolvedor, segundo sua página de registro; Edge Add-ons não cobra registro, como indica sua guia de registro de desenvolvedor.
Prazos de revisão que convém ter no calendário
| Loja | O que diz a documentação oficial |
|---|---|
| Chrome Web Store | "Para a maioria das extensões a revisão é concluída em poucos dias, mas pode levar até algumas semanas"; se passar mais de três semanas sem mudanças, é necessário abrir suporte (processo de revisão) |
| Microsoft Edge Add-ons | "O processo de certificação pode levar até sete dias úteis" após o envio (publicar no Edge) |
Chrome adiciona uma nuance que vale a pena ler antes de pedir permissões: as revisões demoram mais em extensões que solicitam permissões de host amplas ou permissões de execução sensíveis, ou que incluem muito código ou código difícil de revisar.
Vale a pena publicar nas quatro? O que diz a quota de mercado
Depende de quanto custa cada ficha, porque a distribuição de quota de desktop é muito desigual. Segundo os dados de Statcounter Global Stats para outubro de 2026 em desktop a nível mundial:
| Navegador | Quota de desktop (out. 2026) |
|---|---|
| Chrome | 66,98 % |
| Edge | 13,24 % |
| Safari | 7,83 % |
| Firefox | 5,72 % |
| Opera | 2,65 % |
Lido com atenção: Edge é o segundo mercado e compartilha quase toda a especificação com Chrome (mesmo ZIP, mesmas capturas de 1280x800, mesmo 440x280 e 1400x560, mesmas cinco seções de privacidade). É o melhor retorno por hora investida: com o pacote que você já tem e duas imagens novas, você duplica o alcance potencial. Firefox custa um manifest distinto e a chave de dados. Safari é o que realmente custa: projeto de Xcode, associação anual e uma ficha com 30 caracteres de nome.
Checklist: publicar uma vez, listar quatro vezes
Esta é a ordem que menos retrabalho gera, a partir de tudo o que foi dito:
- Escreva o código com
browser.*e promessas, e adicione o guardglobalThis.browser = chromese você cobrir Chrome anterior a 148. - Mantenha um manifest base e gere variantes na construção:
background.service_workerpara Chrome e Edge,background.scriptspara Firefox, e o blocobrowser_specific_settings.geckoapenas na variante do Firefox. - Ajuste
namepara 75 caracteres edescriptionpara 132 antes de empacotar: esses dois campos alimentam a ficha do Chrome e são somente leitura no Edge. - Se você quiser ficha multilíngue no Edge, use
__MSG_extensionName__e__MSG_extensionDescription__comdefault_localee_locales. - Produza as capturas em 1280x800 e salve-as sem canal alfa desde o início: é a única versão que vale para os quatro.
- Prepare o ícone do Chrome como 128x128 com 96x96 de arte e 16 px de margem, e o logo do Edge como 300x300 a 1:1.
- Gere o mosaico de 440x280 e a marquesina de 1400x560 uma única vez: servem igual no Chrome e no Edge.
- Redija um propósito único e uma justificativa para cada permissão do manifest, e reutilize esse texto no Chrome e no Edge.
- Adicione
data_collection_permissionsao manifest do Firefox, mesmo que seja["none"], ou você não poderá enviá-lo para assinatura. - Deixe o Safari para o final e orce-o separadamente: conversão com
safari-web-extension-converter, Apple Developer Program e capturas 16:10 sem transparência.
Perguntas frequentes
O namespace chrome será removido nas extensões?
Não. A documentação oficial do Chrome é explícita: o namespace browser é adicionado "além do chrome existente", e chrome não está sendo retirado. Você pode migrar quando for conveniente, sem pressa e sem quebrar nada.
Desde qual versão do Chrome posso usar browser sem condições?
Desde Chrome 148 para extensões normais e desde Chrome 152 se sua extensão declarar devtools_page. Antes da versão 152, declarar devtools_page desativava o namespace browser em toda a extensão, não apenas naquela página.
Eu ainda precisarei do webextension-polyfill em 2026?
Apenas se você der suporte ao Chrome 147 ou anterior. No Chrome 148 e posteriores, a própria documentação do Chrome diz que o polyfill "não faz nada", porque o suporte já é nativo.
Posso enviar as mesmas capturas para Chrome, Edge, Firefox e Safari?
Quase. Se você produzi-las em 1280x800 sem canal alfa, elas servem nas quatro: é o tamanho preferido do Chrome, um dos dois aceitos pelo Edge, o recomendado pela AMO e uma das quatro medidas 16:10 do App Store Connect. O que muda é o número máximo (5 no Chrome, 6 no Edge, 10 por tamanho na Apple) e os ícones e mosaicos, que realmente precisam ser refeitos.
Por que o App Store Connect rejeita meus PNGs de capturas?
A causa mais comum é a transparência: as especificações da Apple dizem que as imagens não podem incluir canais alfa nem transparências. Um PNG com alfa, mesmo que o fundo pareça branco, não passa. É necessário achatar a imagem e verificar o binário resultante, não o visualizador.
O que acontece se eu não declarar data_collection_permissions no Firefox?
Se for uma extensão nova, você não poderá enviá-la para addons.mozilla.org para assinatura. É obrigatório desde 3 de novembro de 2025 para extensões novas; se você não coletar nem transmitir dados, é necessário declarar isso com {"required": ["none"]}.
Quanto tempo leva a revisão em cada loja?
O Chrome fala de "alguns dias" para a maioria das extensões, com casos que podem levar até várias semanas. O Edge indica que a certificação pode levar até sete dias úteis. O Chrome também avisa que permissões de host amplas e código difícil de revisar prolongam o processo.
Preciso pagar para publicar nas quatro lojas?
A Chrome Web Store cobra uma taxa de registro única ao abrir a conta de desenvolvedor. O Edge Add-ons não cobra registro. A AMO também não. O Safari exige o Apple Developer Program, a 99 USD por ano de associação, porque a App Store é o canal de distribuição.
O que é o papel Item Manager do painel do Chrome?
É um dos três papéis de equipe anunciados no resumo do I/O 2026: permite que um membro envie e faça atualizações da extensão sem dar a gestão da conta, que permanece com o papel de Admin. O terceiro, Viewer, apenas vê métricas.
Uma ficha por loja, mas medida uma única vez
O trabalho que o namespace browser levou era o mais visível, mas não o mais caro. O caro era, e continua sendo, a ficha: quatro conjuntos de medidas, quatro limites de caracteres e quatro declarações de privacidade que não são herdadas entre lojas. A diferença entre fazê-lo em uma tarde e fazê-lo em três ciclos de rejeição está em não improvisar as medidas e em verificar o binário de cada imagem antes de enviá-lo.
Isso é exatamente o que automatiza aiChrome, da AiToolsForApps: o construtor de manifest MV3 com o aviso literal que o usuário verá para cada permissão, o redator de ficha com propósito único e justificativa permissão por permissão, o gerador de assets que entrega o ícone de 128x128, as capturas de 1280x800 sem alfa, o mosaico de 440x280 e a marquesina de 1400x560, e um validador que mede suas imagens no navegador, detecta a transparência real pixel a pixel e oferece o recorte para cada especificação. Se você vai para as quatro lojas, comece por ter a do Chrome impecável: a tabela verificada de medidas, limites e ficha de privacidade para extensões Manifest V3 é o ponto de partida, e sempre distingue o que é requisito oficial e o que é recomendação.
Antes de duplicar a ficha em quatro lojas, tenha a do Chrome medida ao pixel: experimente o aiChrome gratuitamente e sem registro, gere o manifest, a ficha de privacidade e o pacote de imagens, e valide suas capturas instantaneamente.
Antes de duplicar a ficha em quatro lojas, tenha a do Chrome medida ao pixel: experimente o aiChrome gratuitamente e sem registro, gere o manifest, a ficha de privacidade e o pacote de imagens, e valide suas capturas instantaneamente.Continue lendo
Ver todos os artigos →
Por que sua extensão é rejeitada na Chrome Web Store em 2026 (e como evitar isso)

Geode quebrado no Geometry Dash 2.2091: quais mods não funcionam e como continuar criando

DLS 27 em dezembro de 2026: o que está confirmado, o que não está e o que acontece ao teu clube, ao teu plantel e aos teus equipamentos ao atualizar
