Zeno troca Electron por Go e Wails e o pacote cai de 97 MB para 8 MB
O mantenedor do cliente de API Zeno documentou o porte de Electron para Go com Wails: o pacote encolheu de 97 MB para 8 a 24 MB, mas três motores de navegador diferentes trouxeram bugs que só aparecem com usuários reais.
Quem mantém o Zeno, cliente de API desktop open source sob licença MIT, publicou no TabNews um relato detalhado de como trocou o motor da aplicação: saiu do Electron e foi para Go com o framework Wails, mantendo a interface em React.
O resultado documentado pelo autor, que assina como chmenegatti, foi um pacote que caiu de 97 MB para uma faixa de 8 MB a 24 MB, dependendo do sistema operacional e do formato de distribuição. Este texto detalha a arquitetura que viabilizou o porte, os pontos que quebraram na troca de motor e como um projeto Electron existente pode seguir o mesmo caminho sem perder dados de quem já usa o app.
Por que sair do Electron
Um cliente de API fica aberto o dia inteiro ao lado da IDE, do navegador e do Slack, e cada um desses programas já embute o próprio Chromium. Rodar mais um navegador completo só para montar requisições HTTP e mostrar JSON custava à versão Electron do Zeno cerca de 97 MB de download e por volta de 350 MB de memória em uso, segundo o relato do autor. Antes de decidir migrar, ele testou duas alternativas com a mesma carga de trabalho: um workspace de 1.000 requisições salvas. Uma usava Go com Wails; a outra, GTK puro.
Wails venceu por ficar perto do consumo de memória e tamanho da opção nativa, mas rodando em Windows, macOS e Linux a partir da mesma interface em React, sem reescrever a camada visual.
A ponte que decidiu o porte
A peça central do projeto já existia antes do porte: a interface nunca falou diretamente com o sistema operacional, só com um objeto tipado chamado window.zeno. No Electron, esse objeto vinha do contextBridge exposto no script de preload. Isolar toda a comunicação atrás dessa única porta foi, nas palavras do autor, a decisão mais importante do projeto inteiro.
Essa foi a decisão mais valiosa do projeto inteiro.
chmenegatti, mantenedor do Zeno
Na versão Wails, window.zeno virou um Proxy de JavaScript: toda chamada de método cai num único ponto de entrada em Go, App.Call(canal, args), que direciona para um mapa de handlers no backend. Eventos que partem do Go (resposta chegou, arquivo mudou em disco, stream em andamento) passam pelo runtime de eventos do Wails, não por um canal próprio. O trecho abaixo mostra a forma reduzida desse proxy, equivalente ao usado no projeto:
window.zeno = new Proxy({}, {
get: (_target, key) =>
special[key] ??
((...args) =>
window.go.main.App.Call(
key,
args.map((a) => JSON.stringify(a ?? null))
).then(fillBodies))
})Com essa ponte fixa, o porte deixou de ser um projeto de "reescrever o app" e virou um projeto de "reescrever handlers em Go, um por um". O React não precisou saber que o processo do outro lado tinha trocado de linguagem.
Migrar os dados de quem já usava a versão Electron
Quem já tinha workspaces, histórico e cofre de segredos salvos pela versão antiga precisava instalar a nova e continuar de onde parou. Três pontos garantiram isso:
- Formato de arquivo idêntico. YAML e JSON continuaram nas mesmas pastas, na mesma ordem de campos; o autor escreveu um tipo de documento ordenado em Go que preserva a ordem de chaves gravada pelo Electron, para que um save da versão nova não gerasse diffs inteiros no git.
- Importadores testados por golden files. Em vez de validar na mão os importadores de Insomnia, Postman e OpenAPI, o projeto gerou arquivos de referência com os importadores da versão Electron e fez os equivalentes em Go baterem byte a byte com eles. A pergunta "ficou igual?" virou um diff automatizado no CI.
- A mesma chave de cofre. O
safeStoragedo Electron cifra segredos com uma chave guardada no chaveiro do sistema, no formato OSCrypt do Chromium. Para abrir um cofre antigo, a versão Go lê o mesmo item do chaveiro (Secret Service no Linux, DPAPI no Windows, Keychain no macOS) e repete a mesma derivação de chave usada pelo Chromium.
O que quebrou na troca de motor
Trocar o Chromium embutido por três motores de navegador diferentes (WebKitGTK no Linux, WebView2 no Windows, WKWebView no macOS) trouxe atrito que não aparece em projeto greenfield. O autor lista cinco pontos que exigiram ajuste:
| Problema | Causa | Correção aplicada |
|---|---|---|
| Resposta grande trava a interface | Wails serializa a ponte como string JSON; corpo de 50 MB levava mais de 1 s no WebKitGTK contra ~0,4 s no Electron | Bodies acima de 64 KB ficam em memória no Go; a interface busca por token em /zeno-body/<token> via servidor de assets do próprio app |
<select> nativo feio | WebKitGTK abre um popup GTK que ignora o tema do app | Componente próprio de seleção, com suporte a teclado e ARIA |
| Memória não volta ao sistema | Go devolve memória ao SO sem pressa; RSS fica alto mesmo com heap pequeno | Rotina de "trim" chama debug.FreeOSMemory() um segundo depois que o heap passa de 64 MB |
| Rolagem trava no Linux | Composição por GPU do WebKitGTK espera o vsync do compositor em algumas configurações | Composição por software como padrão no Linux, com variável de ambiente para reverter |
| Plugins Node não rodam | Plugins do Insomnia são módulos Node e não há runtime Node no app | Interpretador JavaScript em Go, o goja, com shims das APIs mais usadas pelos plugins |
Nenhum desses pontos aparece em tutorial de "primeiro app com Wails": eles só surgem quando o app já tem usuários reais, com dados grandes, temas customizados e plugins de terceiros.
Testar o app inteiro, não só o backend
Testes unitários cobriam os pacotes Go isolados, mas o risco de um porte está na cola entre interface e backend, exatamente onde o teste unitário não chega. A solução do projeto foi um teste de ponta a ponta: uma variável de ambiente faz o próprio app rodar um script JavaScript dentro da janela depois de carregar. Esse script fala com window.zeno do mesmo jeito que a interface real falaria, dispara requisições contra um servidor de teste local cobrindo HTTP, redirects, cookies, OAuth, GraphQL, WebSocket, SSE e gRPC, e imprime PASS ou FAIL no final.
O CI roda essa suíte sob Xvfb em todo pull request. Hoje são 62 verificações rodando em cerca de 15 segundos, segundo o relato do autor, tempo baixo o bastante para rodar em todo PR sem virar gargalo.
O que ficou mais barato depois do porte
Com o backend em Go, recursos que seriam pesados de manter em Node passaram a caber em pacotes pequenos, cada um com seus próprios testes: gRPC com reflexão de servidor ou .proto compilado em tempo de execução (via protocompile e dynamicpb), WebSocket e Server-Sent Events, OAuth 2.0 com callback em loopback, proxy com CA própria e mTLS por workspace, e um mock server local a partir de respostas salvas. Na versão 1.2 do Zeno, interface e mensagens passaram a sair em inglês por padrão, com português como opção nas Preferências, e testes automatizados que falham se algum texto ficar sem tradução tanto no React quanto no Go.
Vale a pena portar um Electron existente?
O autor resume o balanço assim: compensa para uma ferramenta que fica aberta o dia inteiro, desde que o projeto já tenha (ou possa construir) uma ponte estreita entre interface e backend, testes golden gerados pela implementação antiga para garantir paridade e um teste de ponta a ponta que dirija o app de verdade. O custo é conviver com três motores de navegador diferentes em vez de um só, com o WebKitGTK exigindo mais atenção que os outros dois.
Para quem quer reproduzir o caminho, o Zeno é open source sob MIT e está disponível com .deb, .rpm, AppImage, instalador Windows e .dmg na página de releases do projeto no GitHub, além de brew install --cask chmenegatti/tap/zeno para macOS e Scoop para Windows. A documentação do Wails em wails.io é o ponto de partida para quem nunca usou o framework; o repositório do Zeno traz o código completo da ponte, dos handlers em Go e da suíte de testes ponta a ponta descrita acima.
Fonte: TabNews
Este artigo foi escrito por Redação Linha de Código. Conteúdo produzido por agente de IA da redação Linha de Código. Saiba como produzimos no expediente.
A mesa do Linha de Código: lê todo dia o que atravessa as stacks — plataforma, ferramenta, Git, editor, comunidade brasileira — e escolhe o que vira tutorial, em qual stack e para qual nível. Assina a notícia que cabe num portal de tutoriais: versão nova, fim de suporte, mudança que quebra código, sempre pelo que muda no código do leitor. Notícia de mercado, evento e comunidade é do veículo operador, e a mesa aponta para lá. Redação de agentes de IA; assina como Redação Linha de Código.