Publicamos uma vez uma tela de abertura com uma animação de destaque que pesava quase o mesmo que o resto do miniprograma somado. Ninguém contestou, porque não havia o que contestar: em nenhum lugar existia um número escrito dizendo «demais». A revisão girava em torno de a animação ter ficado bonita. Tinha ficado. Também fazia a primeira tela parecer lenta nos celulares que quase todo nosso público usa.
Um orçamento de desempenho é só um número que o time combina não ultrapassar, decidido antes de o trabalho começar. É só isso, e é exatamente o que as pessoas pulam: prometem otimizar depois do lançamento, e essa promessa ninguém nunca cobra. Paramos de fazê-la.
Escolha números que você consiga defender
Não copie limiares do blog de outra pessoa. O teto do pacote vem dos limites do próprio anfitrião mais a rede mais lenta que você aceita suportar; o da primeira tela se mede no celular mais barato que você achar, não num notebook. Frouxo demais e não existe; apertado demais e o pessoal arranja um jeito de contornar. Já vimos os dois. O que fazemos hoje é anotar ao lado de cada número de onde ele veio: qual aparelho, qual rede, qual medição. Seis meses depois, se alguém questionar a linha, dá para discutir com dados.
E tem um detalhe que passa batido: o orçamento não é uma linha, é um conjunto. Tamanho do pacote, primeira tela pronta, requisições disparadas numa partida a frio, tarefas longas na thread principal, memória de pico e quanto ocupa cada SDK de terceiro. Nenhuma compensa a outra. Uma página pode deixar o pacote lindo e acrescentar seis requisições em série, e continuar lenta.
| Item do orçamento | Como definir o limiar | Como o CI barra | A desculpa de sempre |
|---|---|---|---|
| Tamanho do pacote | Limites do anfitrião mais a rede mais lenta | Falhar o build ao passar o teto, avisar ao chegar perto | É só mais um conjunto de ícones |
| Primeira tela pronta | Medir no celular mais barato, não no notebook | Comparar com uma base salva em cada PR | O design já aprovou esta versão |
| Requisições na partida a frio | Contar as que uma partida realmente dispara | Recusar o PR que adiciona uma chamada incondicional | A gente agrupa no próximo sprint |
| Tarefas longas na thread principal | Amostrar em aparelho real e escolher um teto alcançável | Bloquear o merge se a trace gravada cruzar | É só uma animação pequena |
| Memória de pico | A leitura mais alta da matriz, com folga | Rodar um perfil de aparelho lento toda noite | Só os top de linha travam mesmo |
| Peso de SDKs de terceiro | Orçamento por dependência, não um total único | Falhar se entra dependência sem responsável | O marketing precisa para a campanha |
O que o orçamento vai te cobrar
Comecemos admitindo que ele atrapalha. Existe funcionalidade que vale a pena e que, ainda assim, empurra a primeira tela para além da linha; aí não tem truque técnico que agrade os dois lados, alguém precisa decidir. Tentamos deixar o orçamento como «aviso leve» e em três meses todos os avisos estavam sendo ignorados, então a linha deixou de existir. Passamos a bloqueio duro, e o preço é uma reunião a cada poucas semanas para decidir se afrouxamos temporariamente por uma campanha. Chateia, mas chateia com proveito: tira a discussão da noite anterior ao lançamento e a coloca em horário comercial, com registro.
O negócio pedir exceção é normal, e não adianta fingir que não acontece. Nossa regra não é «proibido quebrar», e sim que quebrar deixe nome e data de validade: quem aprovou, até quanto afrouxou e quando recolhe. Exceção sem data é, na prática, aumento permanente.
O mais traiçoeiro é a base se mexer sozinha. O anfitrião atualiza a biblioteca base, muda a compressão ou reescreve a inicialização, e da noite para o dia sua linha tão bem medida fica toda vermelha ou toda verde. Por isso, depois de cada versão grande do anfitrião, medimos a base de novo em vez de ler a diferença como o time tendo melhorado ou piorado. Culpar engenheiros por mudança de plataforma é o jeito mais rápido de ninguém voltar a acreditar no orçamento.
Coloque a porteira no pipeline, com nome na exceção
Colocamos essas checagens no pipeline do Cross Mini App, mas a regra que realmente funciona não é técnica: uma exceção precisa de um responsável com nome e de uma data de validade. A ferramenta reporta o número; não decide por você se neste sprint ganha o número ou a campanha.
Hoje, quando um PR chega com funcionalidade nova, o orçamento roda junto dos testes. Se passa, fica vermelho, e vermelho com motivo: qual aparelho, qual número, quanto subiu frente à base. Para mergear, você vem com uma razão e com a data em que devolve. É um pouco mais lento que «a gente otimiza depois» e muito mais honesto — até porque essa frase a gente nunca cumpriu.
Fontes
- web.dev Learn — a base das métricas principais e do que medir primeiro.
- MDN — Performance — tarefas longas, memória e outros sinais que dá para usar de porteira.
- HTTP Archive — distribuições reais para fixar a base em vez de chutar.
- Think with Google — por que velocidade vira discussão de negócio, não só preferência de engenharia.