Ligar o telemóvel a uma app
A ligação por QR, a ligação escrita à mão, o que acontece na primeira entrada, e o que funciona (e não funciona) no telemóvel.
O KeplinGo instalado não sabe nada: nem a que instalação se liga, nem que app vai abrir. Essa configuração faz-se uma vez, na primeira abertura, e depois nunca mais é pedida.
Há duas formas de a fazer. A do QR é a que se usa quando se está a preparar telemóveis para outras pessoas; a escrita à mão é a que se usa quando não há ninguém a preparar nada.
A ligação por QR
O código QR gera-se na plataforma e leva já dentro o endereço da instalação e a app escolhida.
- Abre Definições na barra lateral.
- Desce ao painel Aplicação móvel e encontra Ligação por QR.
- Abre o selector Escolhe a app… e escolhe a app — por exemplo Gestão de Clientes.
- O código aparece logo abaixo, com a ligação escrita ao lado e um botão Copiar ligação.
- No telemóvel, com o KeplinGo instalado, aponta a câmara ao código.
A ajuda do painel diz exactamente o que isso faz: "Com o KeplinGo instalado, apontar a câmara a este código preenche o onboarding com o endereço desta instalação e a app escolhida."
Preenche — não entra. O QR poupa a escrita; a confirmação e as credenciais continuam a ser um acto de quem está a usar o telemóvel.
Dica
O QR é a forma prática de preparar uma equipa inteira: projecta-o numa reunião, ou põe-no impresso ao lado dos telemóveis. Cada pessoa aponta a câmara e só tem de entrar com as credenciais dela.
A ligação escrita à mão
Sem QR, os mesmos dois valores escrevem-se no telemóvel:
- Abre o KeplinGo. Aparece o ecrã Ligar à aplicação.
- Escreve o Endereço do servidor — o endereço por onde a plataforma
responde, como
https://a-tua-app.exemplo.pt. - Escreve a App — o identificador curto da aplicação, como
gestao-clientes. É o mesmo que aparece nos endereços dela e no painel de acessos de cada utilizador. - Toca em Validar endereço.
A app vai perguntar ao servidor se aquilo existe, e responde de uma de duas formas:
| Resposta | O que fazer |
|---|---|
| «Vais ligar-te a "Gestão de Clientes"» | Está certo — segue para as credenciais. |
| "Esse servidor não tem essa app." | O endereço está bom, o identificador da app não. |
| "Não foi possível ligar a esse endereço." | O endereço está errado, ou o telemóvel não chega ao servidor. |
| "Esse endereço não é uma app desta plataforma." | O endereço responde, mas não é uma instalação do Keplin. |
Nota
A validação existe para se ler o nome da app antes de se dar credenciais a alguém. É por isso que ela continua a ser um toque explícito, mesmo quando o QR já preencheu tudo.
Entrar
Confirmado o nome da app, aparecem dois campos — utilizador e password — e o botão Entrar.
As credenciais são as da aplicação, não as da plataforma. São as contas geridas nas definições da app — exactamente as mesmas com que se entra pelo browser, no ecrã de entrada da aplicação:
Feita a entrada:
- o endereço e a app ficam guardados e não voltam a ser pedidos;
- a sessão fica guardada em segurança no aparelho;
- nas aberturas seguintes, a app arranca directamente no ecrã inicial.
O que se vê no telemóvel
A app abre com a navegação que desenhaste para telemóvel — em menu lateral ou em barra inferior, conforme a configuraste — e com o ecrã que marcaste como inicial.
Os ecrãs são os mesmos que desenhaste — a app móvel desenha-os em componentes nativos do Android, com a mesma geometria que têm no browser. Não há uma segunda versão da aplicação para manter.
O que a app móvel respeita, sem configuração extra:
| Peça | Como se comporta |
|---|---|
| Tema | As cores da app são as que definiste no tema dela. |
| Navegação | O menu de telemóvel, com o ecrã inicial que escolheste. |
| Permissões | As mesmas do browser: um ecrã sem acesso para aquela pessoa nem se desenha. |
| Traduções | O dicionário da app, na língua dela. |
| Notificações | O centro de notificações da app, com a contagem por ler. |
Os componentes desenhados no editor são desenhados também aqui — textos, painéis, botões, caixas de texto e de número, selecções, listas e cartões, tabelas, gráficos, indicadores, calendários, quadros de tarefas, mapas de Gantt, texto formatado, datas, cores, envio de ficheiros, relatórios e o estado dos processos.
Quando a rede falha
A app guarda uma cópia do último ecrã que carregou com sucesso. Se a rede morrer, mostra essa cópia com um aviso no topo — "Sem ligação — a mostrar a cópia guardada deste ecrã."
A regra é estrita, e é a certa: a cópia só entra quando a rede falha. Se o servidor responder — mesmo que seja com um erro — o que se vê é a resposta dele. A cache nunca se mete no caminho.
Terminar sessão e trocar de instalação
No menu da app, em baixo, há duas saídas com efeitos muito diferentes:
| Opção | O que faz |
|---|---|
| Terminar sessão | Sai da conta. O endereço e a app continuam guardados; volta-se a entrar só com utilizador e password. |
| Trocar de servidor | Limpa tudo — endereço, app e sessão — e volta ao ecrã Ligar à aplicação. |
Trocar de servidor é o que se usa quando o mesmo telemóvel passa a ser usado noutra instalação, ou noutra app da mesma instalação.
Porque não funciona…?
- …o QR? Confirma que o telemóvel já tem o KeplinGo instalado. Sem a app instalada, o código não abre nada.
- …a ligação, com o endereço certo? O telemóvel tem de chegar ao servidor. Um endereço interno da empresa não responde fora da rede dela.
- …a minha password da plataforma? As credenciais são as da app, não as de quem constrói. Quem constrói entra na plataforma pelo browser.
- …um ecrã que existe no browser? As permissões são as mesmas: um ecrã sem acesso para aquela conta não aparece. Confirma o role dela nas permissões da app.
- …a app a mostrar dados antigos? Estás sem rede, a ver a cópia guardada — o aviso está no topo do ecrã.