Na terça subimos uma correção de uma linha para cinco anfitriões. Um aprovou antes do almoço, outro levou a noite, outro devolveu um print perguntando por que o botão tinha mudado de lugar, outro aprovou um build velho e o último ficou em revisão até sexta. O commit era o mesmo. O que não batia era o calendário.
O que ninguém te avisa: você não faz cinco releases, faz um que precisa passar por cinco portas. A porta mais lenta dita o ritmo, e por mais que você capriche no CI isso não muda. Deixamos de perguntar quão rápido dá para publicar e passamos a perguntar o que precisa ser verdade antes de o anfitrião mais lento dizer sim.
Um trem, cinco horários
A primeira surpresa não é o tempo de revisão, é que não existe um artefato único. Cada anfitrião quer seu próprio pacote: IDs de app diferentes, assinaturas diferentes, camadas de SDK diferentes e ramificações condicionais para recursos que só existem em um deles. Mantemos um código só, mas o build se abre em cinco saídas, e cada uma precisa voltar ao mesmo commit. Perde esse mapa e você passa a tarde discutindo qual binário o revisor está olhando.
Os números de versão são a versão silenciosa do mesmo problema. Um inteiro que sobe deixa de significar nada quando o anfitrião A já está na terceira revisão da 3.2 e o B ainda revisa a primeira. Acabamos com uma tabelinha de correspondência: uma versão de produto e, para cada anfitrião, um build que declara quais recursos contém. É burocracia chata, e é a única coisa que torna legível um ticket de suporte.
| Etapa do pipeline | Um anfitrião só | O que cinco acrescentam | Quem cuida |
|---|---|---|---|
| Build | Um pacote, uma config | Variantes por anfitrião, código condicional, assinaturas separadas | Engenharia de build |
| Número de versão | Um inteiro que incrementa | Uma tabela para que 3.2 signifique o mesmo em todo lugar | Responsável pelo release |
| Upload e revisão | Um envio | Cinco consoles, cinco filas, cinco jeitos de escrever uma recusa | Responsável pelo release |
| Rollout gradual | Um controle de porcentagem | Cinco controles que não dá para mexer juntos | Release e plantão |
| Reversão | Redeploy do build anterior | Alguns só andam para a frente, com revisão nova | Plantão |
| Config e flags | Vai junto com o código | A config remota vira a única alavanca entre revisões | Time de plataforma |
O atalho que custa a conta
Agora o desconfortável. Quando os ciclos de revisão não encaixam, a config remota começa a parecer a resposta: vira uma flag, muda um layout, ajusta um preço e não tem envio novo. Até certo ponto é legítimo: textos, ordem, feature flags e chaves de emergência devem viver fora do binário. Mas a linha entre «configurar» e «publicar sem revisão» é fina, e cruzá-la sai caro.
Cruzá-la é colocar comportamento não revisado dentro de um build que o revisor aprovou para outra coisa. Os anfitriões leem isso como violação, e a punição não é uma versão recusada: é a conta de desenvolvedor. Vimos um time perder a distribuição por semanas por causa de uma flag que reescreveu silenciosamente um fluxo de compra. Isso não é um desajuste pequeno no cronograma; é o canal inteiro que some.
O outro custo é que o anfitrião mais lento dita o passo de verdade. Você consegue aterrissar a correção em quatro na terça, mas só pode dizer que está resolvido quando o quinto aprova na sexta. Ou segura o anúncio, ou publica um recurso que se comporta diferente dependendo de qual app abriu. Testamos os dois. Segurar confunde menos.
A reversão é onde a fantasia de simetria morre de vez. Em alguns anfitriões você faz redeploy de um build anterior; em outros não existe marcha à ré, só uma versão nova que passa por revisão de novo. O runbook de incidente não pode ter uma página. Precisa de cinco.
Deixe a porta mais lenta à vista
Acabamos construindo o Cross Mini App em parte porque manter cinco calendários de release na mão estava nos deixando malucos. Ele unificou a tubulação num pipeline só. Não unificou as cinco filas de revisão, e seria mentira dizer que unificou.
Então nosso quadro agora mostra os anfitriões como raias, não como etapas, com o mais lento fixado em cima. Não se anuncia nada até essa raia limpar. Mudança de config segue a mesma disciplina do código: revisada, registrada e reversível. É mais lento do que as demos sugerem. Também é a única versão disso que encontramos que não termina com alguém perguntando, numa sexta, por que o botão mudou num app e no outro não.
Fontes
- Documentação do framework de Mini Programs do WeChat — regras de upload, revisão, rollout por fases e o que conta como versão.
- Documentação para desenvolvedores de Mini Programs do Alipay — uma segunda fila de revisão, com seus próprios controles de publicação e reversão.
- Documentação para desenvolvedores da Apple — comparação útil de como as portas de revisão moldam a cadência de release.
- Documentação do uni-app — um build, várias saídas por plataforma e onde entra a compilação condicional.