Pular para o conteúdo

Para equipe ilarika

Os apps se atualizam sozinhos

  • Super AdminVersão mínima dos apps
  • Super AdminAplicativos (Android)
  • AndroidiLarika Equipe / iLarika Entregadores / iLarika
  • AppConfiguraçõesMinha senhaAtualização do app

Os três apps (iLarika Equipe, iLarika Entregadores e iLarika) se atualizam em duas camadas, parecido com um programa de computador que se atualiza sozinho. Esta página é para a equipe iLarika operar; para quem usa o app da loja, veja O app da equipe se atualiza sozinho.

Camada O que muda Onde Precisa da loja?
Web do app Telas, textos, regras: tudo o que vem dos sites Android e iPhone Não
App inteiro (APK) O app nativo: permissões, plugin, ícone Só Android de link direto Não (a pessoa confirma a instalação)

Camada 1: o web se atualiza a cada deploy

Todo deploy de produção, depois de buildar os sites, gera um pacote web de cada app com o mesmo build que o navegador recebe. Os apps abertos conferem na abertura e a cada 30 minutos. Se tem pacote novo, baixam em segundo plano, sem perguntar nada, e o web novo entra quando a pessoa volta ao app depois de pelo menos 1 minuto fora (ou quando o app abre do zero). A tela recarrega com “Abrindo o iLarika…” e já vem a versão nova.

Por que não “na próxima abertura”: no Android o app quase nunca abre do zero. O botão Voltar (desde o Android 12) só manda o app para trás, e tocar na notificação traz a mesma tela de volta. Até 23/10/2026 o pacote ficava baixado e esperando para sempre.

  • Só baixa o que mudou: arquivo igual ao que o celular já tem não é baixado de novo.
  • Deploy que não mexe nos sites (só API, por exemplo) não gera pacote novo.
  • Cada arquivo é conferido (sha256) antes de valer. Arquivo corrompido = pacote descartado.
  • Nada no caminho pode mexer nos arquivos: o HTML do pacote sai como bytes crus e com Cache-Control: no-transform, porque o Cloudflare reescreve HTML (veja “Se der errado”).
  • Ficam guardados os 3 últimos pacotes de cada app no servidor.

Se o pacote novo vier quebrado

O app abre o pacote novo “em teste”. Se a tela não aparecer em 20 segundos, o app volta sozinho para o pacote anterior (ou para o web que veio dentro do app) e nunca mais tenta aquele pacote. O próximo deploy gera outro pacote, que é tentado normalmente.

Quando o web precisa de um app mais novo

Cada pacote diz qual nível de casca (versaoDaCasca, em packages/mobile-config/apps.json) ele precisa. App com casca mais velha ignora o pacote e continua com o web que tem, até ser atualizado pela loja ou pelo APK.

Suba versaoDaCasca (e o mesmo número em PacoteWeb.java e PacoteWeb.swift, que o teste confere) quando o web passar a depender de algo nativo que o app instalado não tem: método novo do plugin sem tratar a ausência, permissão nova, mudança na ponte. Na dúvida, suba: o custo é o app antigo ficar com o web antigo até atualizar.

A versão mínima continua valendo

A tela “Atualize para continuar” e o 426 julgam sempre a versão do app instalado, nunca a do pacote web. O pacote não leva versão própria: o app escreve a dele ao gravar. Ver Obrigar a atualizar os apps.

Regras das lojas

A Apple e o Google aceitam atualizar o conteúdo web de um app sem nova revisão, desde que o app não mude de propósito. Por isso o pacote leva só o web (HTML, JS, CSS, imagens), nunca código nativo. Mudança no app nativo continua passando pela loja (iPhone: TestFlight/App Store).

Os APKs ficam no GitHub (link cadastrado em Super Admin › Aplicativos). Quando a versão atual do Super Admin passa a do app instalado, o app mostra “Atualização do app disponível”. Ao tocar em Atualizar, ele baixa o APK e abre o instalador do Android.

  • Na primeira vez o Android pede para liberar “Instalar apps desconhecidos” para o iLarika. Quem não liberar continua com o app de antes e pode atualizar depois.
  • O Android só instala por cima se o APK for do mesmo app e da mesma assinatura.
  • APK do link que não é mais novo que o instalado não é instalado.

Isso só existe no build de link direto (distribuicaoAndroid: "apk" no apps.json). O build para a Play Store ("play", ou ILARIKA_DISTRIBUICAO_ANDROID=play no build) sai sem a permissão de instalar, e o botão leva à loja, como sempre.

Passo a passo do operador

  1. Uma vez no servidor: a pasta /srv/ilarika/shared/pacotes-web precisa existir e ser do usuário do deploy (o mesmo que roda a API). Para usar outra, defina ILARIKA_PACOTES_WEB_DIR no deploy.env e no .env da API, com o mesmo valor.
  2. A cada deploy: nada. O deploy gera os pacotes sozinho. Se falhar, o deploy segue e só registra um aviso no log (“o pacote web dos apps não saiu”); os apps ficam com o pacote anterior.
  3. Para o APK novo chegar: gere o APK (release-apps), confira o link em Super Admin › Aplicativos e suba a versão atual em Super Admin › Versão mínima dos apps.

Perguntas comuns

Como sei qual web o celular está usando? No app, Configurações › Minha senha › Atualização do app (abaixo da versão): versão e build do app, as telas em uso (as que vieram no app ou o pacote <commit>-<hash>), o pacote baixado esperando, os marcados como ruins, a última procura e o último erro (do download ou do teste de 20 segundos).

Posso forçar o celular a pegar o web novo agora? Na mesma tela, Procurar atualização agora e depois Usar a versão nova agora.

APK instalado antes de 23/10/2026 (build 108 ou anterior): o app ainda não sabe trocar o web sozinho no meio do uso. Na primeira vez, depois que o pacote baixou (uns segundos com o app aberto), feche o app pela lista de apps abertos (deslize para fora) e abra de novo. A partir daí o web novo já traz a troca ao voltar para o app, e o diagnóstico mostra o que acontece. O APK novo faz tudo isso sem esse passo.

Se der errado

Publiquei um web quebrado: os apps voltam sozinhos ao pacote anterior em 20 segundos. Corrija e faça um deploy novo: ele gera outro pacote.

Apaguei a pasta de pacotes: a API responde que não há pacote e os apps ficam com o que têm. O próximo deploy recria.

“sha256 não confere em …/index.html” no diagnóstico (CONTEUDO_DIFERENTE): alguém no caminho mudou o arquivo. Foi o que travou toda atualização no Android até 17/11/2026: o Cloudflare Web Analytics injetava o script dele (static.cloudflareinsights.com/beacon.min.js) no index.html quando o pedido aceitava text/html, que é o que o Android pede por padrão, e o celular descartava o pacote. Desde então a API entrega o HTML do pacote como application/octet-stream com no-transform (o Cloudflare não mexe nesses), e os apps novos pedem Accept: */*. Se voltar a acontecer, confira se ligaram no Cloudflare algo que reescreve conteúdo (Rocket Loader, Polish, ofuscação de e-mail) e compare o arquivo pedido como navegador com o do manifesto: curl -s -H 'Accept: text/html' https://ilarika.com.br/public/apps/equipe/pacote-web/<id>/index.html | sha256sum.