Pular para o conteúdo

Para equipe ilarika

Instalar os apps no celular para testar

  • GitHubActionsrelease-apps
  • AndroidiLarika Equipe / iLarika Entregadores / iLarika

São três apps Android, e cada um abre o mesmo sistema que já funciona no navegador:

App O que abre Quem usa
iLarika Equipe o painel da loja (garçom, cozinha, retirada, entregador da casa) a equipe da loja
iLarika Entregadores o app do entregador entregadores
iLarika o marketplace e o cardápio das lojas clientes

Esta é a versão de teste (debug). Ela ainda não vai para a Play Store. Serve para você ver os três funcionando no aparelho antes de qualquer merge. No iPhone é outro caminho: veja Testar os apps no iPhone com uma conta Apple emprestada.

Antes de começar

  • Um celular Android 7 ou mais novo.
  • Acesso ao repositório no GitHub (o APK fica dentro do GitHub, não num site aberto).

Passo a passo

  1. No GitHub, abra Actions › release-apps. O APK sai nos runs cujo commit tem [apk] (ou [build]) sozinho numa linha da mensagem, e em toda tag <app>-vX.Y.Z. Os outros pushes só rodam as verificações, para não gastar minutos. Clique no run mais recente que tenha os jobs android. Depois que o workflow estiver na main, também dá para usar Run workflow › plataforma android e escolher um app só e outra API.
  2. Espere o build ficar verde (uns 5 minutos).
  3. Abra o build e desça até Artifacts. Baixe o arquivo do app, por exemplo ilarika-equipe-0.1.0-build12-debug. Ele vem em .zip, com o app-debug.apk dentro.
  4. Passe o .apk para o celular (WhatsApp para você mesmo, Google Drive ou cabo) e toque nele. O Android pede para permitir instalar apps desta fonte: permita só para o app que você usou para abrir o arquivo.
  5. Abra o app. Se ele abriu e entrou na tela de login, a instalação deu certo. No iLarika, a tela inicial já lista os restaurantes.

Também dá para baixar o APK pelo celular: abra o build no navegador do celular, com o GitHub logado.

Link fixo, sem GitHub logado: o build disparado pelo Run workflow (ou por uma tag) também publica o APK num link direto, que baixa o arquivo na hora e é trocado a cada build novo:

  • Equipe: https://github.com/ilarika-org/ilarika-releases/releases/download/android-equipe/ilarika-equipe.apk
  • Entregadores: https://github.com/ilarika-org/ilarika-releases/releases/download/android-entregadores/ilarika-entregadores.apk
  • iLarika: https://github.com/ilarika-org/ilarika-releases/releases/download/android-marketplace/ilarika-marketplace.apk

São esses os links do Super Admin › Aplicativos (Android). Quem tiver o link baixa, então ele serve para teste aberto, não para versão fechada.

O que testar

  • Equipe: entrar com o e-mail de um funcionário e ver os pedidos chegando.
  • Entregadores: entrar com uma conta de entregador e ver as lojas e corridas.
  • iLarika: abrir uma loja, montar a sacola e entrar com o código por e-mail.
  • Sem internet (modo avião): o app abre do mesmo jeito, porque o sistema vem dentro dele. As telas mostram o aviso de “sem conexão”, igual no navegador.
  • Fechar e abrir de novo: a sessão continua.

O que testar além do básico

  • Equipe, notificação: com o app fechado, faça um pedido na loja de teste. Toca o alarme de balcão e aparece o número no ícone. Precisa do Firebase configurado (notificacoes.md).
  • Equipe, impressão sem computador: Configurações › Impressão › Impressoras deste aparelho. Autorize o aparelho, cadastre a impressora de rede (IP) ou a térmica Bluetooth pareada, toque em Imprimir teste e depois faça um pedido.
  • Equipe, Cozinha: a tela não apaga enquanto a Cozinha está aberta.
  • Entregadores, corrida com a tela bloqueada: aceite uma corrida e abra a navegação. Na primeira vez aparece o aviso sobre localização. Bloqueie a tela e ande um quarteirão: a posição continua chegando no painel da loja, e a notificação fixa “Corrida em andamento” fica visível.
  • Entregadores, navegação: a rota é toda dentro do app (não há botão de Waze ou Google Maps, de propósito).
  • Entregadores, miniatura (Android): com a navegação aberta, aperte o botão Início. O mapa vira uma janelinha.
  • Entrar com a digital (Equipe e Entregadores): entre com a senha e toque em Ativar na pergunta. Feche o app, abra de novo: ele pede a digital (ou o PIN do celular). Em Configurações › Minha senha (Equipe) ou Conta (Entregadores), ligue Trancar o app ao voltar, saia do app por 2 minutos e volte. Detalhes em entrar-com-digital.md.
  • Excluir conta: Configurações › Minha senha (Equipe) e Conta (Entregadores).
  • Atualize para continuar: no Super Admin › Versão mínima dos apps, suba a versão mínima acima da instalada. Feche e abra o app: ele pede para atualizar. Volte a mínima.

O que ainda não tem

  • Live Activities do iPhone (corrida e pedido na tela bloqueada).
  • Botão “Excluir minha conta” do cliente no app iLarika (a API já atende; a tela é da frente de assinaturas).
  • Esconder no app o que não pode aparecer nas lojas (preços de plano, botão de assinar e o botão de “versão para computador”).

Perguntas comuns

Preciso desinstalar para pôr uma versão nova? Depende de uma configuração única no GitHub, o secret ANDROID_DEBUG_KEYSTORE_B64 (como criar está em _como-funciona.md). Com ele, você instala o APK novo por cima e o login continua. Sem ele, cada build sai assinado com uma chave diferente: desinstale o app antes de instalar o novo. O build avisa isso em amarelo.

Os três apps podem ficar no mesmo celular? Podem. São apps separados, cada um com o próprio login.

O app usa os dados reais? Usa. A versão de teste conversa com o mesmo servidor do site, a não ser que você troque a API ao rodar o workflow. Pedido feito nela é pedido de verdade.

Se der errado

  • “App não instalado” ou “conflito com pacote existente”: o app que já está no celular foi assinado com outra chave de debug. Desinstale o antigo e instale de novo (veja a pergunta sobre desinstalar, acima).
  • Tela branca ao abrir: feche o app pela lista de recentes e abra de novo. Se continuar, anote o número do build e avise.
  • “Email ou senha inválidos”: é a resposta do servidor, igual no site. Teste o mesmo login no navegador.