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.jsondo app (o mesmo da tagequipe-vX.Y.Z).
Passo a passo
- Super Admin › Versão mínima dos apps.
- No app, preencha a versão atual com a que acabou de sair.
- Se a versão velha não pode mais rodar, suba a mínima. Ela não pode passar da atual.
- 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.
