Pular para o conteúdo

Para equipe ilarika

Obrigar a atualizar os apps

  • Super AdminVersão mínima dos apps

Quando sai uma versão que muda algo que a versão velha não aguenta, dá para obrigar quem ainda está nela a atualizar. Cada app tem duas versões no Super Admin (Versão mínima dos apps):

Versão O que acontece com quem está abaixo dela
Mínima O app abre numa tela “Atualize para continuar” com o botão da loja, e a API responde 426 para ele.
Atual Ao abrir o app, uma tela cheia “Tem versão nova”, com “Atualizar agora” e “Agora não” (dispensável: o app continua funcionando).

Sem nada configurado, a mínima é 0.0.0 e ninguém é barrado.

A “atual” segue a Google Play sozinha

No iLarika Equipe e no iLarika (clientes), que estão na Google Play, o servidor pergunta à Play a cada 15 minutos qual versão está publicada e grava essa como Atual. Vale a de produção; enquanto o app não foi para produção, vale a do teste aberto, depois a do teste fechado (onde estão os testadores) e, por último, a do teste interno. Versão em rascunho não conta. E, como toda versão nova passa pela revisão do Google antes de dar para baixar, a sincronização só sobe a Atual depois de ver a versão nova na Play por 24 horas (ajustável no servidor pela chave apps.play.espera_horas; 0 = na hora). Assim a tela “Tem versão nova” não aparece antes do botão Atualizar da loja. Se a revisão sair antes, suba a Atual no Super Admin › Apps: a sincronização não desfaz. Descer é na hora. Fora isso, se você puser à mão uma versão diferente da que está na Play, a próxima passada volta para a da Play. A Mínima continua só sua.

Para ligar: no servidor, a variável PLAY_SERVICE_ACCOUNT_JSON com o mesmo JSON da conta de serviço que o GitHub usa para enviar à Play. Sem ela, a Atual fica manual, como antes.

Antes de começar

  • A versão nova precisa estar publicada e liberada para todo mundo nas duas lojas. Se você subir a mínima antes, quem tentar atualizar não acha a versão nova, e o app fica parado.
  • O número da versão é o do package.json do app (o mesmo da tag equipe-vX.Y.Z).

Passo a passo

  1. Super Admin › Versão mínima dos apps.
  2. No app, preencha a versão atual com a que acabou de sair.
  3. Se a versão velha não pode mais rodar, suba a mínima. Ela não pode passar da atual.
  4. Salvar versões. Os apps leem em até 1 minuto.

O botão “Atualizar” leva ao link de download do app cadastrado na tela de links dos apps do Super Admin (a mesma que alimenta o “Baixe o app”: veja Aplicativos e downloads). Sem link, abre a busca da loja pelo nome do app.

O que acontece depois

  • App aberto com internet: confere a versão na abertura.
  • App que já estava aberto: é barrado na próxima chamada à API (o 426).
  • App sem internet: abre normalmente. Ninguém é punido por estar offline.
  • Navegador: nada muda para quem usa pelo navegador.

Perguntas comuns

E a atualização que não precisa de loja? A maior parte das mudanças chega sozinha, sem nova versão: veja Os apps se atualizam sozinhos.

Quem decide o número? Quem lança a versão: sobe no package.json do app no mesmo commit da tag.

Se der errado

Subi a mínima por engano e todo mundo travou: volte a mínima para a versão anterior e salve. Em até 1 minuto os apps voltam a abrir.