🚀 Oferta especial: 60% OFF no CrazyStack - Últimas vagas!Garantir vaga →
Chrome Development

Chrome Extension Manifest V3: Tutorial Definitivo 2025

Guia completo para criar extensões Chrome modernas: Service Workers, Manifest V3, permissions avançadas e deployment automatizado na Chrome Web Store usando IA.

CrazyStack
22 min de leitura
Manifest V3Chrome ExtensionsService WorkersClaude CodeWarp Terminal

Por que isso é importante

Chrome Extensions têm 2.6 bilhões de usuários ativos. Manifest V3 (obrigatório desde 2025) mudou completamente a arquitetura: Service Workers substituíram background scripts, novas APIs de permissions e CSP restritivo. Dominar essas mudanças é essencial para criar extensões modernas que passem na review da Chrome Web Store.

Manifest V3: Revolução na Arquitetura de Extensões

Manifest V3 introduziu mudanças críticas: Service Workers substituem background pages, Content Security Policy mais restritivo, Host Permissions granulares e Declarative Net Request API. Essas mudanças impactam 78% das extensões existentes, exigindo refatoração completa para manter compatibilidade com Chrome 127+.

manifest-v3-structure.json

Service Workers: Nova Era do Background Processing

Service Workers são event-driven e não persistem como background pages do Manifest V2. Eles hibernam após 30 segundos de inatividade, requerendo arquitetura estateless. APIs chrome.runtime.onMessage e chrome.storage.local tornaram-se fundamentais para comunicação entre componentes.

background.js

Setup Automatizado com Warp Terminal e Claude Code

Warp Terminal

Terminal moderno com AI suggestions, workflows pré-configurados e performance superior ao tradicional bash.

Saiba mais →

Claude Code

IDE com IA integrada da Anthropic. Suporte nativo para Manifest V3 e templates de extensões Chrome.

Saiba mais →

Chrome Developer Dashboard

Plataforma oficial para publicar extensões na Chrome Web Store com analytics integrados.

Saiba mais →
automated-setup.sh

Implementação do Popup com TypeScript

O popup é a interface principal da extensão. Com Manifest V3, todas as interações devem ser event-driven e usar Promises ao invés de callbacks. A comunicação com o Service Worker acontece através de chrome.runtime.sendMessage API.

src/popup.ts

Deployment e Publicação na Chrome Web Store

1
Passo 1: Registrar Developer Account ($5 one-time fee) na Chrome Web Store Developer Dashboard
2
Passo 2: Preparar assets obrigatórios: ícones (16px, 48px, 128px), screenshots (1280x800), promotional images
3
Passo 3: Configurar políticas de privacidade, especialmente para permissions sensíveis como "activeTab"
4
Passo 4: Build de produção com minificação e otimização para reduzir bundle size
5
Passo 5: Upload do ZIP, preenchimento de metadados e submissão para review (3-7 dias úteis)
deploy-script.sh

⚠️Mudanças Críticas do Manifest V3

⚠️ Manifest V2 será completamente descontinuado em junho 2025. Extensões que não migrarem serão automaticamente removidas da Chrome Web Store. A migração envolve refatoração completa de background scripts para Service Workers e adaptação das permission APIs.

Checklist de Implementação Completa

Configurou estrutura de projeto com TypeScript e Webpack
Implementou Service Worker com event-driven architecture
Criou popup interface com comunicação assíncrona
Configurou permissions granulares e host_permissions
Implementou Content Security Policy restritiva
Testou em Chrome 127+ com Developer Mode
Preparou assets para Chrome Web Store (ícones, screenshots)
Configurou política de privacidade para permissions sensíveis
Executou build otimizado e validação de bundle size
Submeteu para review na Chrome Web Store Developer Console

Domine React e Node com o CrazyStack

Aprenda técnicas avançadas de React com nosso curso completo