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).
Camada 2: Android de link direto baixa o APK novo
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
- Uma vez no servidor: a pasta
/srv/ilarika/shared/pacotes-webprecisa existir e ser do usuário do deploy (o mesmo que roda a API). Para usar outra, definaILARIKA_PACOTES_WEB_DIRnodeploy.enve no.envda API, com o mesmo valor. - 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.
- 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.
